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 PlayReady	ISOBMFF/F-MP4	CENC	AES 128 CTR
Android 5.x (Lollipop) onwards	HLS	PRM	MPEG2-TS	AES 128	AES 128 CBC

Supported audio and video codecs

Video codec	Audio codec	Comments
H.264	AAC-LC HE-AAC
H.265	AAC-LC HE-AAC	Only where the hardware supports H.265 decoding

SDK file contents

NAGRA supplies two variants of the SDK library, one with PRM support and one without.
If PRM is not required, the Android SDK 5 package typically contains the following files:

opy-sdk-android-5.12.x.x-example-code.zip
This contains code examples to demonstrate the features of the CONNECT Player; see the Android SDK5 Example Code Quick Start guide.
opy-sdk-android-5.12.x.x-sdk-integration.zip
This contains the .aar file used for integration activities; see the Android SDK 5 Integration Guide: Creating the project.
opy-sdk-android-5.12.x.x-sdk-production.zip
This contains the .aar file that replaces the integration version when the application is ready to be deployed; see the Android SDK 5 Integration Guide: Building the production version.

If you have requested PRM-protected playback with PAK support, PRM versions of the above files will be supplied:

opy-sdk-android-5.12.x.x-example-code-prm.zip
opy-sdk-android-5.12.x.x-sdk-prm-integration.aar
opy-sdk-android-5.12.x.x-sdk-prm-production.aar

In addition, the PRM Operational Vault file opvault.json is also provided.

Dependencies

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.

Dependency	Version	Required for
`androidx.appcompat:appcompat`	1.2.0	Android X general support
`com.google.guava:guava`	27.1-android	Google Java Core Libraries
`androidx.room:room-runtime`	2.2.5	Offline playback feature
`com.google.protobuf:protobuf-lite`	3.0.1	Handling Widevine-encrypted content
`com.google.ads.interactivemedia.v3:interactivemedia`	3.20.1	Playing Google IMA ads
`com.google.android.gms:play-services-ads-identifier`	17.0.0	Playing Google IMA ads

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
`compileSdkVersion`	30 or higher
`minSdkVersion`	21 or higher

Recommended tools versions

Tool	Recommended version
Java JDK	1.8
Gradle	6.6
Android Gradle Plugin	4.02

Open-source usage

The following third-party software is used and embedded within the CONNECT Player SDK 5 for Android.

exo-player 2.12.0

Java-side open-source libraries.

protobuf-lite 3.0.1
guava 27.1-android