CONNECT Player SDK 5 for Android
CONNECT Player SDK 5 for Android
Breadcrumbs

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
PRM

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

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 for Multi-DRM and another with additional support for NAGRA PRM.

Multi-DRM SDK

The Multi-DRM version of the Android SDK 5 package contains the following files:

NAGRA PRM SDK

If you have requested Playback of PRM encrypted content (Software PRM) support, PRM versions of the above files will be supplied:

  • opy-sdk-android-5.20.x-example-code-prm.zip
    This contains code examples to demonstrate the PRM features of the CONNECT Player; see the PRM Example Code Quick Start guide.

  • opy-sdk-android-5.20.x-sdk-prm-integration.aar
    This file is used for integration activities.

  • opy-sdk-android-5.20.x-sdk-prm-production.aar
    This file replaces the integration version when the application is ready to be deployed.

The PRM Operator Vault file opvault.json is provided separately.

Additional files

The following files are also typically provided:

  • opy-sdk-android-5.20.x-example-code-kotlin.zip
    This contains Kotlin code examples of the CONNECT Player; see the Kotlin Example Code Quick Start guide.

  • opy-sdk-android-5.20.x-example-code-upi.zip
    This contains code examples to demonstrate the features of the CONNECT Player using the Unified Player Interface (UPI) .

  • opy-sdk-android-5.20.x-javadoc.zip
    This contains the API files; see Android SDK 5 APIs.

  • opy-sdk-android-5.20.x-insight-agent-1.2.2.aar
    This is an additional library for reporting statistics to an Insight server; see Insight analytics.

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 

insight-agent

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 

compileSdkVersion

31 or higher

minSdkVersion

21 or higher 

Recommended tools versions

Tool

Recommended version

Java JDK

11

Gradle

7.3.2

Android Gradle Plugin

7.0.4

Open-source usage

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

Open-source

Version

Licence

Website

exo-player

2.16.1

Apache V2.0

https://github.com/google/ExoPlayer/blob/release-v2/LICENSE

Java-side open-source libraries

protobuf-lite

3.0.1

MIT

https://github.com/elderapo/protobuf-lite/blob/master/LICENSE

guava

27.1-android

Apache V2.0

https://github.com/google/guava/blob/master/LICENSE