player-core/com.bitmovin.player.api/TweaksConfig

TweaksConfig

data class TweaksConfig(var timeChangedInterval: Double = DEFAULT_TIME_CHANGED_EVENT_INTERVAL, var bandwidthEstimateWeightLimit: Int = DEFAULT_BANDWIDTH_ESTIMATE_WEIGHT_LIMIT, var languagePropertyNormalization: Boolean = true, var localDynamicDashWindowUpdateInterval: Double? = null, var useFiletypeExtractorFallbackForHls: Boolean = false, var useDrmSessionForClearPeriods: Boolean = false, var useDrmSessionForClearSources: Boolean = false, var shouldApplyTtmlRegionWorkaround: Boolean = true, var devicesThatRequireSurfaceWorkaround: List<DeviceDescription> = emptyList(), var enableImageMediaPlaylistThumbnailParsingForLive: Boolean = false, var discardAdsWhileCasting: Boolean = false, var preferSoftwareDecodingForAds: Boolean = false, var preferSoftwareDecoding: Boolean = false, var allowChunklessPreparationForHls: Boolean = false, var allowChunklessPreparationForHlsStreamingAds: Boolean = true, var enableFrameAboutToBeRenderedEvent: Boolean = false, var minForwardBufferLevelForQualityIncrease: Double? = null, var enableMainContentDecodingDuringAds: Boolean = true, var enableMainContentVideoCodecInitializationFallback: Boolean = true, var enableMainContentAudioCodecInitializationFallback: Boolean = true, var enableAdContentVideoCodecInitializationFallback: Boolean = true, var enableAdContentAudioCodecInitializationFallback: Boolean = true, var assumeEmsgMetadataForHlsChunklessPreparations: Boolean = false, var forceReuseVideoCodecReasons: Set<ForceReuseVideoCodecReason> = emptySet(), var releasePlayerTimeout: Double? = null, var detachSurfaceTimeout: Double? = null, var disableAudioTracksWhileInBackground: Boolean = false, var httpStatusCodesToTryFallback: List<Int>? = null, var reuseAdsLoaderAcrossImaAds: Boolean = false) : Parcelable

This configuration is used as an incubator for experimental features. Tweaks are not officially supported and are not guaranteed to be stable, i.e. their naming, functionality and API can change at any time within the tweaks or when being promoted to an official feature and moved into its final configuration namespace.

Constructors

TweaksConfig

constructor(timeChangedInterval: Double = DEFAULT_TIME_CHANGED_EVENT_INTERVAL, bandwidthEstimateWeightLimit: Int = DEFAULT_BANDWIDTH_ESTIMATE_WEIGHT_LIMIT, languagePropertyNormalization: Boolean = true, localDynamicDashWindowUpdateInterval: Double? = null, useFiletypeExtractorFallbackForHls: Boolean = false, useDrmSessionForClearPeriods: Boolean = false, useDrmSessionForClearSources: Boolean = false, shouldApplyTtmlRegionWorkaround: Boolean = true, devicesThatRequireSurfaceWorkaround: List<DeviceDescription> = emptyList(), enableImageMediaPlaylistThumbnailParsingForLive: Boolean = false, discardAdsWhileCasting: Boolean = false, preferSoftwareDecodingForAds: Boolean = false, preferSoftwareDecoding: Boolean = false, allowChunklessPreparationForHls: Boolean = false, allowChunklessPreparationForHlsStreamingAds: Boolean = true, enableFrameAboutToBeRenderedEvent: Boolean = false, minForwardBufferLevelForQualityIncrease: Double? = null, enableMainContentDecodingDuringAds: Boolean = true, enableMainContentVideoCodecInitializationFallback: Boolean = true, enableMainContentAudioCodecInitializationFallback: Boolean = true, enableAdContentVideoCodecInitializationFallback: Boolean = true, enableAdContentAudioCodecInitializationFallback: Boolean = true, assumeEmsgMetadataForHlsChunklessPreparations: Boolean = false, forceReuseVideoCodecReasons: Set<ForceReuseVideoCodecReason> = emptySet(), releasePlayerTimeout: Double? = null, detachSurfaceTimeout: Double? = null, disableAudioTracksWhileInBackground: Boolean = false, httpStatusCodesToTryFallback: List<Int>? = null, reuseAdsLoaderAcrossImaAds: Boolean = false)

Types

Companion

object Companion

Properties

allowChunklessPreparationForHls

var allowChunklessPreparationForHls: Boolean

Specifies whether the player should try to prepare HLS streams without downloading media segments. This is generally possible if the #EXT-X-STREAM-INF tag contains the CODECS attribute and may speed up startup time.

allowChunklessPreparationForHlsStreamingAds

var allowChunklessPreparationForHlsStreamingAds: Boolean

Specifies whether the player should try to prepare HLS streaming ads without downloading media segments.

assumeEmsgMetadataForHlsChunklessPreparations

var assumeEmsgMetadataForHlsChunklessPreparations: Boolean

When using allowChunklessPreparationForHls the player is unable to determine the timed metadata type present in the HLS stream. By default, the player assumes that the timed metadata is of type ID3. If the timed metadata is known to be of type event message (EMSG), this property can be set to true. If there is no timed metadata in the stream, this property has no effect.

bandwidthEstimateWeightLimit

var bandwidthEstimateWeightLimit: Int

Constantly aggregated and weighted bandwidth samples are summed up to this weight limit to calculate an bandwidth estimation. Remaining samples (i.e. that would lead to exceeding the limit) are dropped from memory as they are not relevant anymore.

detachSurfaceTimeout

var detachSurfaceTimeout: Double?

The timeout for detaching a surface from the player. In seconds. If null, the timeout falls back to the default value of 2.0. Please note, this value might change in future releases.

devicesThatRequireSurfaceWorkaround

var devicesThatRequireSurfaceWorkaround: List<DeviceDescription>

Some devices have an incorrect implementation of MediaCodec.setOutputSurface. This leads to failure when the surface changes. To prevent failure, the codec will be released and re-instantiated in those scenarios.

disableAudioTracksWhileInBackground

var disableAudioTracksWhileInBackground: Boolean

Disables the audio tracks when the app is backgrounded by calling Player.onStop or PlayerView.onStop. Audio tracks are re-enabled when the app is foregrounded by calling Player.onStart or PlayerView.onStart. This is a workaround that can be applied to prevent the player from crashing on devices that are known to not clean up audio resources properly when backgrounding the app.

discardAdsWhileCasting

var discardAdsWhileCasting: Boolean

Specifies whether ads are discarded when played over during casting. If disabled (=false) ads are postponed until the cast session is stopped. For IMA VMAP ads, the postponing still might drop single ads, except for the last one held back.

enableAdContentAudioCodecInitializationFallback

var enableAdContentAudioCodecInitializationFallback: Boolean

Specifies whether the player should fall back to another (potentially suboptimal) decoder for ad content audio playback, when the preferred decoder initialization fails.

enableAdContentVideoCodecInitializationFallback

var enableAdContentVideoCodecInitializationFallback: Boolean

Specifies whether the player should fall back to another (potentially suboptimal) decoder for ad content video playback, when the preferred decoder initialization fails.

enableFrameAboutToBeRenderedEvent

var enableFrameAboutToBeRenderedEvent: Boolean

Specifies whether the PlayerEvent.FrameAboutToBeRendered should be emitted or not.

enableImageMediaPlaylistThumbnailParsingForLive

var enableImageMediaPlaylistThumbnailParsingForLive: Boolean

Image Media Playlist thumbnails are not officially supported for live sources as the parsing is not optimised for dynamically updating manifests. If enableImageMediaPlaylistThumbnailParsingForLive is set to true, variant playlists for all EXT-X-IMAGE-STREAM-INF tags are downloaded and parsed anyway.

enableMainContentAudioCodecInitializationFallback

var enableMainContentAudioCodecInitializationFallback: Boolean

Specifies whether the player should fall back to another (potentially suboptimal) decoder for main content audio playback, when the preferred decoder initialization fails.

enableMainContentDecodingDuringAds

var enableMainContentDecodingDuringAds: Boolean

Specifies whether the active source should be decoded during ads playback.

enableMainContentVideoCodecInitializationFallback

var enableMainContentVideoCodecInitializationFallback: Boolean

Specifies whether the player should fall back to another (potentially suboptimal) decoder for main content video playback, when the preferred decoder initialization fails.

exoPlayerCache

@Transient

var exoPlayerCache: Cache?

A cache instance that is used by the player in read-only mode. Ignored when playing back OfflineSourceConfigs.

forceReuseVideoCodecReasons

var forceReuseVideoCodecReasons: Set<ForceReuseVideoCodecReason>

When switching between video formats (eg: adapting between video qualities) the codec might be recreated due to several reasons. This behaviour can cause brief black screens when switching between video qualities as codec recreation can be slow.

httpStatusCodesToTryFallback

var httpStatusCodesToTryFallback: List<Int>?

Specifies for which HTTP status codes the player should fall back to a different resource if a fallback is available.

languagePropertyNormalization

var languagePropertyNormalization: Boolean

Specifies if the language property on DASH Representations, HLS Renditions and SmoothStreaming QualityLevels is normalized. If enabled, language properties are normalized to IETF BCP 47 language tags. Examples: - "ENG" is normalized to "en" - "en_us" is normalized to "en-us" - "en-US-x-lvariant-POSIX" is normalized to "en-us-posix"

localDynamicDashWindowUpdateInterval

var localDynamicDashWindowUpdateInterval: Double?

The interval in which dynamic DASH windows are updated locally. I.e. The rate by which the playback window is moved forward on the timeline.

minForwardBufferLevelForQualityIncrease

var minForwardBufferLevelForQualityIncrease: Double?

The minimum duration in seconds of buffered data required for the selected track to switch to one of higher quality.

preferSoftwareDecoding

var preferSoftwareDecoding: Boolean

Specifies whether the player should prefer software decoding over hardware decoding for playback of the main content. To prefer software decoding for ads playback, see preferSoftwareDecodingForAds

preferSoftwareDecodingForAds

var preferSoftwareDecodingForAds: Boolean

Specifies whether the player should prefer software decoding over hardware decoding for ad playback. This only affects ads playback, the player will still prefer hardware decoding for the main content.

releasePlayerTimeout

var releasePlayerTimeout: Double?

The timeout to release the player (triggered by Player.destroy). In seconds. If null, the timeout falls back to the default value of 0.5. Please note, this value might change in future releases.

reuseAdsLoaderAcrossImaAds

var reuseAdsLoaderAcrossImaAds: Boolean

Enables reusing the IMA AdsLoader across multiple ads and playback sessions for improved ad startup time performance.

shouldApplyTtmlRegionWorkaround

var shouldApplyTtmlRegionWorkaround: Boolean

Specifies whether default positioning values should be assumed when parsing TTML regions in case of unsupported TTML features. Default is true.

timeChangedInterval

var timeChangedInterval: Double

The frequency in seconds the TimeChanged will be fired.

useDrmSessionForClearPeriods

var useDrmSessionForClearPeriods: Boolean

Specifies whether a DRM session should be used for clear tracks of type video and audio. Using DRM sessions for clear content avoids the recreation of decoders when transitioning between clear and encrypted sections of content. Default is false.

useDrmSessionForClearSources

var useDrmSessionForClearSources: Boolean

Specifies whether a DRM session should be used for clear tracks of type video and audio in a clear source that follows after a DRM protected source. In addition, a DRM session will be used for clear periods in a DRM protected source. Using DRM sessions for clear content avoids the recreation of decoders when transitioning between clear and encrypted sections of content. Default is false.

useFiletypeExtractorFallbackForHls

var useFiletypeExtractorFallbackForHls: Boolean

Specifies if the player should always fall back to an extractor matching the file type, if no matching extractor was found. If the fallback is applied, this will ignore potential incompatibilities with streams and thus can result in unstable or failing playback.