Multi camera mode

Quickplay player now supports multi camera mode for live channels and events. You can switch to different angles of the event and watch it from all available angles.

Prerequisites

• Datastore API call returns content metadata with mcf flag set to true for multi camera enabled content.
• The client app decides to call Multicam Datastore API, based on the mcf flag in the channel or live event, to get the list of secondary camera angles metadata.
• The secondary camera angles metadata holds the prid of the associated primary content, and its catalogType is multicam.
• trackViewersCount should be set to true for all LIVE assets if mcf is enabled (that is, primary angle content) or catalogType is multicam (that is, secondary angle content).

Content authorization

A PlatformAsset for content with catalogType = "multicam" should be constructed with an additional param primaryContentId.

Name	Type	Description
primaryContentId	String	The unique identifier of the primary content to which the selected content (that is, secondary angle content) to play is associated with. This is applicable only for multi-camera enabled content.

// create asset
 val platformAsset = PlatformAsset(
   ...,
   catologType = "multicam",
   primaryContentId
 )

Setup heartbeat

To extend support for the Multi Camera feature, HeartbeatManager now accepts a couple of additional params.

Name	Type	Description
catalogType	String	The value of the Catalog type of content.
primaryContentId	String	The unique identifier of the primary content to which the selected content (that is, secondary angle content) to play is associated with. This is applicable only for multi-camera enabled content.

val heartbeatConfiguration = HeartbeatConfiguration(
  ...,
  trackViewersCount = true
)
val heartbeatManager = HeartbeatFactory.createHeartbeatManager(
  ...,
  heartbeatConfiguration,
  catalogType = "multicam", 
  primaryContentId
)

note

1. primaryContentId should only be set for content with catalogType = "multicam".
2. When you initiate a new camera angle playback, always wait until the current player is stopped before authorizing playback with the new camera angle.