This guide enables you to demonstrate 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 when prompted.
  • Gradle - use the latest version as recommended by Android Studio.
  • JDK - use the version provided with Android Studio.

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

  • opy-sdk-android-5.15.x.x-example-code.zip
    This package contains the application projects which demonstrate how to use the player features.
  • opy-sdk-android-5.15.x.x-example-prm.zip
    This package demonstrates how to work with PRM-encrypted streams.
  • opy-sdk-android-5.15.x.x-example-kotlin.zip
    This package demonstrates how to implement the same features in the Kotlin language.
  • opy-sdk-android-5.15.x.x-sdk-integration.aar
    The SDK binary file used for integration purposes.
  • opy-sdk-android-5.15.x.x-sdk-prm-integration.aar
    The PRM version of the SDK binary file used for integration purposes. You will also need the PRM Operational Vault file opvault.json.
  • A device running Android 5.x (Lollipop) onwards with debugging enabled; the player cannot run on an Android Studio simulator.
See the README.md and build.gradle files in the various example code packages, indicating additional dependencies specific to each feature.

Procedure

  1. Save the SDK pack to your desktop and unzip it. The package contains a zipped set of example code, extract the contents of the example-code.zip file to your desktop.

  2. Start Android Studio, select Open an existing Android Studio project and select the required project in the top-level directory of the extracted package. The following projects are available:
  3. Copy one of the SDK files in your package (e.g. opy-sdk-android-5.15.x.x-sdk-integration.aar) to the common/libs/ directory.
  4. Connect an Android device to your development machine via USB, and build and run the application.

PRM example code

The example-code-prm.zip file contains additional examples for use with PRM.

  1. Extract the package example-code-prm.zip.
  2. Copy one of the PRM-supporting SDK files in your package (e.g. opy-sdk-android-5.15.x.x-sdk-prm-integration.aar) to the common/libs/ directory.
  3. For each mini-project, replace your opvault.json with the one at <mini-project>/src/main/res/raw/opvault.json. (The existing one will not work with your PRM server)
  4. Connect an Android device to your development machine via USB, and build and run the application.

Kotlin example code

Follow similar steps for examples in Kotlin (example-code-kotlin.zip). The Kotlin example code samples contain examples for both PRM and non-PRM scenarios. When testing with PRM, make sure you choose the correct SDK version and use your own opvault.json.

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.