How to reduce data usage on mobile devices on mobile web

Customers that use THEOplayer in mobile web which leverage THEOplayer's preloading capabilities (preload = "auto"), or provide very high qualities, sometimes receive complaints about data usage.

You can combat this by leveraging the ABR API and the MediaTrack API.

  1. ABR API: you can set a player.abr.targetBuffer property, which allows you to configure the amount of seconds to buffer ahead of the current playback position. The standard buffer time is 20 seconds. These 20 seconds are also employed when preloading content.
  2. MediaTrack API: you can use the targetQuality property to configure the set of qualities THEOplayer exercises its ABR algorithm on. For example, you could configure that THEOplayer should only do ABR on the lowest two qualities.

Table of Contents

Step-by-step guide

1. To leverage the ABR API

and limit the buffer that will be preloaded through preload = "auto":

2. Set the ABR targetDuration property to lower number of seconds. (e.g. 6 seconds)


The snippet below sets the targetBuffer to 6 seconds.

player.abr.targetBuffer = 6;
Android SDK

The snippet below sets the targetBuffer to 6 seconds.

iOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x)

The iOS SDK does not allow you to change the targetBuffer. The iOS SDK's ABR API only allows you to change the ABRStrategyType.

3. If necessary add a mobile check like this:


The snippet below leverages THEOplayer's Video.js component. THEOplayer uses Video.js for its default UI.

if (THEOplayer.videojs.browser.IS_ANDROID || THEOplayer.videojs.browser.IS_IOS || ... ) {
    player.abr.targetBuffer = 6;

4. Enable preloading

The snippet below enables preloading


Enable preloading: player.preload = "auto"; // "metadata" is also a valid value

Android SDK

Enable preloading: theoplayer.getPlayer().setPreload(PreloadType.AUTO);

iOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x)
  1. enable preloading: theoplayer.setPreload(.auto)
  2. To leverage the MediaTrack API, and limit the amount of bitrates which THEOplayer can select from, please refer to the article at How to start with a specific quality?.

These two strategies can reduce the data usage on (mobile) devices drastically.

Make sure to follow us on GitHub!
Copyright © 2022. All Rights Reserved.
New York