Building and running ExoPlayer for testing

Apply a Dolby patch, build, and run ExoPlayer for testing.

Prerequisites

Android Studio is installed on your testing PC. For information about Android Studio, see https://developer.android.com/studio.

Procedure

  1. Download the source code of ExoPlayer from https://github.com/google/ExoPlayer.
    ExoPlayer version r2.15.0 is used in this release of the kit.
  2. Download the .zip file for ExoPlayer.
    The .zip file contains:
    • A patch file, which fixes Dolby AC-4 and Dolby Atmos selection issues with HLS.
    • A .json file, which is a playlist that includes all the testing manifests provided in kit.
  3. Apply the patch to your ExoPlayer Git project. 
    git apply ddp_kit_only.patch
  4. Open the ExoPlayer project in Android Studio.
  5. Use the provided playlist that includes all the testing manifests or create playlists to include the testing manifest files.
    For example, include manifest files for unencrypted content.
    {
"name": "HD (MP4, AAC, DDP, H264)",
"uri": "https://ott.dolby.com/manifest/path/DASH/OnDemand/MPD/test.mpd"
},
{
"name": "Apple master playlist (fMP4)",
"uri": "https://ott.dolby.com/manifest/path/Manifest_fMP4/master.m3u8"
}

    Include a manifest file for Widevine content.

    {
"name": "HD (cenc)",
"uri": "https://storage.googleapis.com/wvmedia/cenc/tears/tears.mpd",
"drm_scheme": "widevine",
"drm_license_uri": "https://proxy.uat.widevine.com/proxy?provider=widevine_test"
}

    Testing manifest files are available at Multiplexed streams.

  6. Connect your device to the testing PC using the USB cable.
  7. In Android Studio, build and run ExoPlayer on your device.
    For more information, see the section regarding building and running your app in the Android Studio user's guide at https://developer.android.com/studio/intro.
  8. Select and play test signals on your device.