A connector between a THEOplayer instance and a Common Media Client Data (CMCD) server for the THEOplayer HTML5/Tizen/webOS SDK. This implementation supports CMCD data as defined in CTA-5004, published in September 2020.
In order to use this connector, a THEOplayer build with a valid license is required. You can use your existing THEOplayer HTML5 SDK license or request yours via THEOportal.
Install using your favorite package manager for Node (such as npm
or yarn
):
npm install @theoplayer/cmcd-connector-web
yarn add @theoplayer/cmcd-connector-web
First you need to add the CMCD connector to your app :
<script type="text/javascript" src="path/to/cmcd-connector.umd.js"></script>
<script type="text/javascript">
const player = new THEOplayer.Player(element, playerConfiguration);
const connector = THEOplayerCMCDConnector.createCMCDConnector(player);
</script>
<script type="module">
import { createCMCDConnector } from "path/to/cmcd-connector.esm.js";
const player = new THEOplayer.Player(element, playerConfiguration);
const connector = createCMCDConnector(player);
</script>
By default, the data is sent via query arguments, but you can configure the transmission mode before creating the CMCD connector. For example, to transmit via HTTP headers:
<script type="text/javascript" src="path/to/cmcd-connector.umd.js"></script>
<script>
const player = new THEOplayer.Player(element, playerConfiguration);
const configuration = {
transmissionMode: THEOplayerCMCDConnector.TransmissionMode.HTTP_HEADER
}
const connector = THEOplayerCMCDConnector.createCMCDConnector(player, configuration);
</script>
<script type="module">
import { createCMCDConnector, TransmissionMode } from "path/to/cmcd-connector.esm.js";
const player = new THEOplayer.Player(element, playerConfiguration);
const configuration = {
transmissionMode: TransmissionMode.HTTP_HEADER
}
const connector = createCMCDConnector(player, configuration);
</script>
The connector will be automatically destroyed upon destruction of the provided player. When changing the player source and a content ID is
being passed in, this is to be reset through reconfigure()
as it will not be cleared automatically.
Note that when native playback is being used, either through THEOplayer's configuration, or due to absence of MSE/EME APIs, the JSON Object transmission mode should be used.
Currently, all standardized reserved keys are reported, except:
d
)nor
)nrr
)Generated using TypeDoc