Kotlin Example Code Quick Start

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

For the development tools, current dependencies and minimum build configuration required, see Prerequisites and dependencies.

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

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

• opy-sdk-android-5.24.x-example-code-kotlin.zip
  This package demonstrates how to implement the same features in the Kotlin language.
• opy-sdk-android-5.24.x-sdk-integration.aar
  The SDK binary file used for integration purposes.
• opy-sdk-android-5.24.x-sdk-prm-integration.aar
  PRM version of the SDK binary file used for integration purposes. 
  The PRM Operator Vault file opvault.json. is provided separately.

Procedure

1. Extract the opy-sdk-android-5.24.x-example-code-kotlin.zip file to your desktop.
2. Go to opy-sdk-android-5.24.x-example-code-kotlin > common, and place the opy-sdk-android-5.24.x-sdk-integration.aar / opy-sdk-android-5.24.x-sdk-prm-integration.aar file in the libs folder.
3. Open Android Studio, select Open an Existing Project and locate the opy-sdk-android-5.24.x-example-code-kotlin folder.
4. For PRM playback, expand src > main > res and create a new directory raw; add your opvault.json file to this folder. The existing one will not work with your PRM server.; see the PRM Example Code Quick Start guide.
5. When the project has built, select the required project from the dropdown menu (not the side file list); see the example projects below.
   Connect an Android device to your development machine via USB and run the application.

Example projects

Playback

• basic-playback-kt - Demonstrates playback of a clear stream with no additional functionality.
• resolution-capping-kt - Playback of clear streams with resolution capping.
• track-selection-kt - Playback of clear streams with multi-audio.

Offline playback

• offline-kt -  Offline playback of Widevine encrypted content.
• offline-hls-kt -  Offline playback of HLS streams.
• offline-service-kt -  Downloading as a service for DASH streams.
• offline-service-prm-kt -  Downloading as a service for DASH and HLS streams.

Encrypted playback

• encrypted-playback-kt - Playback of Widevine encrypted content.
• customised-encrypted-playback-kt - Demonstrates a non-default implementation of Widevine.
• prm-kt - Playback of PRM encrypted content (Software PRM).