Android SDK 5 Integration Guide

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.

• Java SDK - Download the JDK [Java v8] from http://www.oracle.com/technetwork/java/javase/downloads/index.html.
• Android Studio - Download the latest version of Android Studio from http://developer.android.com/sdk/index.html.

• Gradle - use the newest version as recommended by Android Studio. This is set in the  dependencies section of the buildScript block; see step 2 of Creating the project.

• A device running Android 5.0 (Lollipop) or higher.

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

For the current dependencies and minimum build configuration for integrating your app with the CONNECT Player SDK, see CONNECT Player SDK 5 for Android Documentation.

Product release files

NAGRA supplies the following files as part of your release:

• opy-sdk-android-5.13.x.x-sdk-integration.aar
  This file is used for integration activities.
• opy-sdk-android-5.13.x.x-sdk-production.aar
  This file replaces the integration version when the complete application is ready to be deployed.

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

• opy-sdk-android-5.13.x.x-sdk-prm-integration.aar
• opy-sdk-android-5.13.x.x-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:

• In conjunction with the Android 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 project
  • Adding CONNECT Player to your project
  • Running the application
• Develop your code to add encrypted playback and other features to the player.
  • Adding player features
• When development is complete, replace the integration file with the production version. Carry out final testing and submit to the Google Play Store.
  • Building the production version