This guide enables you to demonstrate the CONNECT Player features and view the example code.

Prerequisites

Make sure you have the latest Android Studio installed, including:

  • Android SDK - install the latest version from Android Studio (2021.1.1). You may also need to install Android SDK Tools.

  • Gradle - use the latest version as recommended by Android Studio.

  • JDK - use the version provided with Android Studio.

Download the Android SDK, which supplies all the files needed to launch the player and start streaming content.

  • opy-sdk-android-<version>-example-code.zip
    This contains application projects which demonstrate how to use the player features.

  • opy-sdk-android-<version>-sdk-integration.aar
    This is the SDK binary file used for integration purposes.

You will also need a device running Android 5.x (Lollipop) onwards with debugging enabled; the player cannot run on an Android Studio simulator.

Some features may have additional dependencies and libraries; see the README.md and build.gradle files in the relevant example code packages. 

Procedure

  1. Extract the opy-sdk-android-<version>-example-code.zip file to your desktop.

  2. Go to opy-sdk-android-<version>-example-code > common, and place the opy-sdk-android-<version>-sdk-integration.aar file in the libs folder.

  3. Open Android Studio and select Open an Existing Project and locate the opy-sdk-android-<version>-example-code folder.

  4. When the project has built, select the required project from the dropdown menu (not the side file list); see the example projects below.
  5. Connect an Android device to your development machine via USB and run the application.

Example projects

Playback

Offline playback

Encrypted playback

Content security

Advertising

  • dynamic-ads-ima - Playback of clear streams with Google IMA adverts.
  • server-side-ad-insertion - Demonstrates use of adverts within streams with Server-Side Ad Insertion.
  • yospace - Demonstrates the integration of the Yospace user interface handling of streams with Server-Side Ad Insertion.

Statistics and analytics

Hardware support

  • chromecast  - Playback of clear, encrypted and SSM streams on Chromecast.
  • connect-dash - Playback of CONNECT-encrypted DASH streams with NAGRA CONNECT.
  • connect-prm -  Playback of CONNECT-encrypted HLS streams with NAGRA CONNECT.
  • smartbeam - Shows how an application can playback streams in conjunction with Broadpeak SmartBeam set-top box.

For full details on integrating the SDK with your application, see the Android SDK 5 Integration Guide. See also the API reference guide provided in the Android SDK pack.