For upgrading the CONNECT player to Android SDK 5.x from SDK 4.x, please see the Android SDK 4.x to 5.x Migration Guide.
To test the features and view the example code, please see the Android SDK5 Example Code Quick Start guide.

The following procedures describe how to create a new CONNECT Player application in Android and add an OTVVideoView to play a specified clear video stream.

Prerequisites

Tools

The following development tools are required; the number in square brackets denotes the earliest supported version of the software verified by NAGRA.

The app requires a physical Android device with debugging enabled as per Android guidelines (http://developer.android.com/tools/device.html). It will not work on an emulator.

Dependencies

The external library dependency androidx.appcompat:appcompat:1.2.0 is required for general Android X support. Dependencies for other features are listed under the relevant feature description.

Product release files

NAGRA supplies the following files as part of your release:

  • opy-sdk-android-<version>-sdk-integration.aar
    This file is used for integration activities and is necessary to produce debug logs from the native part of the application. The NAGRA logo is displayed during playback to indicate that the integration variant is being used.

  • opy-sdk-android-<version>-sdk-production.aar
    This file replaces the integration version when the complete application is ready to be deployed. Debug logs cannot be produced and the NAGRA logo is removed.

If your project includes PRM-protected playback with PAK, use the PRM versions of the above files:

  • opy-sdk-android-<version>-sdk-prm-integration.aar

  • opy-sdk-android-<version>-sdk-prm-production.aar

You will also need the PRM Operational Vault file opvault.json.

Integration process

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