CONNECT Player SDK 5 for Android Documentation
The CONNECT Player SDK 5 for Android enables you to embed the player within an existing or new native Java or Kotlin application. The SDK wraps and extends the media player API, providing a similar interface to the Android Video view.
Supported versions and formats
|Supported OS Versions||Adaptive Streaming Format||DRM||Audio/Video Container||Encrypt Method||Block/Cypher|
|Android 5.x (Lollipop) onwards||DASH||Widevine|
|ISOBMFF/F-MP4||CENC||AES 128 CTR|
|HLS||PRM||MPEG2-TS||AES 128||AES 128 CBC|
Supported audio and video codecs
|Video codec||Audio codec||Comments|
|Only where the hardware supports H.265 decoding|
SDK file contents
NAGRA supplies two variants of the SDK library, one for Multi-DRM and another with additional support for NAGRA PRM.
The Multi-DRM version of the Android SDK 5 package contains the following files:
This contains code examples to demonstrate the features of the CONNECT Player; see the Android SDK 5 Example Code Quick Start guide.
This file is used for integration activities and is necessary to produce debug logs from the native part of the application; see the Android SDK 5 Integration Guide: Creating the project.
This file replaces the integration version when the application is ready to be deployed; see the Android SDK 5 Integration Guide: Building the production version.
NAGRA PRM SDK
If you have requested Playback of PRM encrypted content (Software PRM) support, PRM versions of the above files will be supplied:
This contains code examples to demonstrate the PRM features of the CONNECT Player; see the PRM Example Code Quick Start guide.
This file is used for integration activities.
This file replaces the integration version when the application is ready to be deployed.
The PRM Operational Vault file opvault.json is provided separately.
The following files are also typically provided:
This contains Kotlin code examples of the CONNECT Player; see the Kotlin Example Code Quick Start guide.
This contains code examples to demonstrate the features of the CONNECT Player using the Unified Player Interface (UPI).
This contains the API files; see Android SDK 5 APIs.
This is an additional library for reporting statistics to an Insight server; see Insight analytics.
The table below lists the external library dependencies for integrating the SDK and its features. Dependencies for other features are listed under the relevant feature description.
|1.2.0||Android X general support|
|27.1-android||Google Java Core Libraries|
Offline playback feature
|3.0.1||Handling Widevine-encrypted content|
|3.20.1||Playing Google IMA ads|
|17.0.0||Playing Google IMA ads|
|1.2.2||NAGRA Insight agent for collecting statistics|
Build configuration and tool parameters
To build an application with this SDK, the following have to be configured in your Gradle file(s):
|Configuration item||Configuration value|
|31 or higher|
|21 or higher|
Recommended tools versions
|Android Gradle Plugin||7.0.4|
The following third-party software is used and embedded within the CONNECT Player SDK 5 for Android.
|Java-side open-source libraries|