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
mcfflag set totruefor the multi camera enabled content. - Client App will decide to call Multicam Datastore API, based on the
mcfflag in channel/liveevent, to get the list of secondary camera angles metadata. - The secondary camera angles metadata holds
pridof the associated primary content andcatalogTypeof it will bemulticam. trackViewersCountshould be set totruefor all LIVE assets ifmcfis enabled( i.e. primary angle content) orcatalogTypeismutlicam(i.e. secondary angle content).
Content Authorization
A PlatformAsset for the 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 (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.
| 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 (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
primaryContentIdshould only be set for the content withcatalogType = "multicam".- When initiating a new camera angle playback, always wait until the current player is stopped before authorising the playback with new camera angle.