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 totrue
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 andcatalogType
of it will bemulticam
. trackViewersCount
should be set totrue
for all LIVE assets ifmcf
is enabled( i.e. primary angle content) orcatalogType
ismutlicam
(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
primaryContentId
should 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.