Skip to main content

Multi Camera Mode

Quickplay player now supports Multi camera mode for live channel/events where user can switch to different angles of the event and watch it in all available angles.

Pre-requisites

  • Datastore API call returns content metadata with mcf flag set to true for the multi camera enabled content.
  • Client App will decide to call Multicam Datastore API, based on the mcf flag in channel/liveevent, to get the list of secondary camera angles metadata.
  • The secondary camera angles metadata holds prid of the associated primary content and catalogType of it will be multicam.
  • trackViewersCount should be set to true for all LIVE assets if mcf is enabled( i.e. primary angle content) or catalogType is mutlicam(i.e. secondary angle content).

Content Authorization

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

NameTypeDescription
primaryContentIdStringThe unique identifier of the primary content to which the selected content (i.e. 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 Multi Camera feature, HeartbeatManager will now accept couple of additional params.

NameTypeDescription
catalogTypeStringThe value of the Catalog type of content.
primaryContentIdStringThe unique identifier of the primary content to which the selected content (i.e. 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 the content with catalogType = "multicam".
  2. When initiating a new camera angle playback, always wait until the current player is stopped before authorising the playback with new camera angle.