Getting Started: Enabling Upgrade for HLS Playback

The upgraded version of the SDK (version 2.6.0+) provides an advanced and more consistent HLS playback experience for VoD and Live streaming across Android devices through an integration with VisualOn. For the upgraded version of the SDK (version 2.6.0+) request access to VisualOn libraries from your CSM or Technical Support.

As of April 1, 2016 the Ooyala Android SDKs have been shipping with Google ExoPlayer libraries instead of the VisualOn libraries. While there are steps that you will need to take, moving to ExoPlayer will provide a more consistent, higher quality HLS and MPEG-DASH playback experience for VOD and live streams on Android devices.

As of August 1, 2016, Ooyala will no longer support the HLS player integration with VisualOn or provide bug fixes or improvements specific to VisualOn libraries.

In order to upgrade, you will need to
  1. After getting access to the VisualOn libraries from your CSM, download the VisualOn libraries.
  2. Copy all of the zip/libs/*.jar files into the project/libs/ folder.
  3. Copy all of the zip/libs/armeabi/*.so files into the project/libs/armeabi/ folder.
  4. Copy all of the zip/assets/* files into the project/assets/ folder.
  5. In your application, set the following STATIC property before calling setEmbedCode:
    OoyalaPlayer.enableCustomHLSPlayer = true;                
  6. Play an embed code that has HLS playback capabilities (or a remote asset pointing at an .m3u8 file).
  7. Recompile your Android Native apps with new Ooyala Android SDK and VisualOn libraries.
  8. Test your application to ensure HLS streams play properly.
Note: If you’re already using VisualOn or Ooyala's SDK for Android, please switch to latest version and recompile your app.

A sample application that illustrates the integration with VisualOn can be found at Sample Applications for the Android Mobile SDK.