Browsers and Connected TV SDK 5 Integration Guide

For upgrading the CONNECT player to Browsers and Connected TV SDK 5.x from SDK 1.x, please see the Browser SDK 1.x to Browsers and Connected TV SDK 5.x Migration Guide.
To test the features and view the example code, please see the Browsers and Connected TV SDK 5 Example Code Quick Start guide or Reduced Size SDK Example Code Quick Start guide.

This guide describes how to instantiate and use the CONNECT Player SDK 5 for Browsers and Connected TV and add basic and advanced features.

Prerequisites

Download the CONNECT Player SDK 5 for Browsers and Connected TV pack; see Downloading the SDK. Extract the following files to a suitable location on a web server; you can use localhost for development and testing purposes.

opy-sdk-js-5.18.x-integration.zip to create your basic player; see Creating the player.
opy-sdk-js-5.18.x-production.zip to create the final version of your player; see Building the production version.
opy-sdk-js-5.18.x-example-code.zip to develop your code; see the Browsers and Connected TV SDK 5 Example Code Quick Start guide.
opy-sdk-js-5.18.x-insight.zip is an additional SDK binary file for the insight data collection feature.
opy-sdk-js-5.18.x-quickmark.zip is an additional SDK binary file for the QuickMark forensic watermarking feature.

When using the Reduced Size SDK, replace these files with the following and use the Reduced Size SDK Example Code Quick Start guide.

opy-sdk-js-5.18.x-integration-no-ui.zip
opy-sdk-js-5.18.x-production-no-ui.zip

If not hosted on the same origin, the hosted video must be configured to allow cross-origin resource sharing (CORS), such as a different domain or subdomain. We recommend the SDK is deployed over HTTPS as the CONNECT Player SDK uses cryptographic functions provided by the browser; some browsers inhibit this functionality if not running over HTTPS.

Integration process

We recommend you perform integration of CONNECT Player SDK in the following stages:

In conjunction with the Browsers and Connected TV SDK 5 Example Code Quick Start guide, use the code examples to explore and test the features of the CONNECT Player.
Using this guide, create a basic player; for details, see Creating the player.
Develop your code to add encrypted playback and other features to the player; see: Adding player features.
When development is complete, replace the integration file with the production version and carry out final testing; see Building the production version.

SmartTV

We recommend you complete the integration of CONNECT Player SDK for Browsers before taking steps to move that working solution to Smart TVs.

For more information on integrating the SDK for Smart TVs, see Tizen and webOS Smart TV Apps.

HbbTV

NAGRA's CONNECT player provides support for working in HbbTV mode.

Some Samsung Smart TVs models from 2020 onwards can work in HbbTV mode and integrate the TVkeyCloud DRM system (see TVkeyCloud integration). Although the models supporting this are considered Tizen TVs, the Tizen tools are not applicable in this mode, requiring a different set of tools.