Integration Guide

Having seen and tested the Connect Player features using the Example Code, use this guide to create your own player.

The following procedures describe how to create a new Connect Player application in Android, and add a video view to play specified clear video streams.

Prerequisites

Tools

The following development tools need to be installed; the number in square brackets denotes the earliest supported version of the software verified by Nagra.

Dependencies

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

Product release file

You will also need the following files (supplied by NAGRA as part of your release):

  • sdk-integration.aar
    This file is used for integration activities. It is necessary for producing debug logs from the native part of the application, as this cannot be done once the native code is in production. The NAGRA logo will be displayed during playback to indicate that the integration variant is being used.

  • sdk-production.aar
    This file replaces the integration version when the finished application is ready to be deployed. The NAGRA logo is not present during playback.

  • opy_licence
    This is an encrypted license enabling the player per platform, based on the user’s licence agreement. It is supplied separately once the product is purchased and will only work with the application id domain names provided at time of acquisition.

Integration process

When performing an integration of the OpenTV Player SDK, NAGRA recommends that you do so in the following stages: