delayDecodingUntilPlayback

Whether to delay the decoder initialization until playback starts.

When set to true, the decoder will not be initialized until playback is started (e.g. Player.play is called). Note that the first frame will not be rendered until the decoder is initialized. It is expected to observe a short delay between calling Player.play and the playback starting as the decoder is initialized for the first time.

This is useful in cases where you want to preload the Source and have it ready for playback, but want to delay the resource-intensive decoder initialization until the user actually starts playback. As some devices have a low limit of hardware decoders available, this can be used to preload the content efficiently and avoid decoder exhaustion.

When set to false, the decoder is initialized as soon as the source is loaded and ready for playback.

This value is applied once per playback session, meaning if set to true:

• In playlist scenario only one source must start playback, after that decoding will be enabled for all sources

• When Player.load loads a new source/playlist, decoding will again be disabled until first playback

Limitations

In a multi playback session scenario stale frames might be observed until the playback starts in a new session.

Default is false.