Exoplayer configuration

What you learn

You're instantiating DIVA Player in your app (mobile/TV) and relying on DIVA Back Office as the video streaming source.

The goal of this article is to build the simplest front-end to stream a video from the DIVA Back Office, having the possibility to control and modify ExoPlayer parameters dynamically and remotely.

Before starting

• Ensure the DIVA Back Office instance you rely on is up and running.
• Ask your video engineers team <videoId>, <settingsURL>, <languageCountryCode>, <userToken> and <sharedKey>.
• Ensure the settings file contains the AndroidPlayerConfiguration fields.

Instantiation

The Basic instantiation code is sufficient.

In the settings file, the AndroidPlayerConfiguration section must contain the configuration, like in the following example:

      "settings": {
        "AndroidPlayerConfiguration":
        {
            "behindWindowJumptolive": true,
            "retainBackBufferFromKeyframe": true,
            "prioritizeTimeOverSizeThresholds": true,
            "bufferForPlaybackMs": 2500,
            "minBufferMs": 2500,
            "maxBufferMs": 20000,
            "bufferForPlaybackAfterRebufferMs": 2500,
            "targetBufferBytes": 67108864,
            "backBufferDurationMs": 4000,
            "liveMinSpeed": 0.9,
            "liveMaxSpeed": 4.1,
            "liveMinOffsetMs": 10000,
            "liveMaxOffsetMs": 30000,
            "liveTargetOffsetMs": 20000,
            "fallbackMinPlaybackSpeed": 0,
            "proportionalControlFactor": 0,
            "targetLiveOffsetIncrementOnRebufferMs": 0,
            "minPossibleLiveOffsetSmoothingFactor": 0
        }
      }    

Here's an enhanced description of each parameter based on the official ExoPlayer live streaming documentation:

• behindWindowJumptolive: Allows Diva to jump to the live position if the playback lags behind the live window, ensuring minimal delay.
• retainBackBufferFromKeyframe: Retains media starting from the keyframe before the specified back buffer duration, maintaining smoother playback and reduced load.
• prioritizeTimeOverSizeThresholds: Prioritizes buffer time over size, enhancing playback stability, especially in low-bandwidth conditions.
• bufferForPlaybackMs, minBufferMs, maxBufferMs, bufferForPlaybackAfterRebufferMs: Control buffering thresholds to balance load and playback smoothness.
• targetBufferBytes: Sets target buffer size to help manage memory for uninterrupted playback.
• liveMinSpeed, liveMaxSpeed: Define speed adjustments for maintaining live offset during playback.
• liveMinOffsetMs, liveMaxOffsetMs, liveTargetOffsetMs: Set minimum, maximum, and target live offset for responsive playback adjustments.
• targetLiveOffsetIncrementOnRebufferMs: Adds buffer to the live offset post-rebuffer to minimize future interruptions.
• proportionalControlFactor: Smooths playback adjustments, balancing between sudden vs. gradual transitions.
• minPossibleLiveOffsetSmoothingFactor: Smooths adjustments to live offset, adapting playback speed to network conditions.

For more, please refer to the official documentation.