BlazeVideosPlaybackConfiguration

The BlazeVideosPlaybackConfiguration represents the playback configuration for a video player.

This class applies only to Videos Widget!

Parameters

multiAspectRatio - Whether to enable multi-aspect ratio support.
- true: Always use the biggest available aspect ratio for each orientation to maximize screen utilization (default behavior)
- false: Use the first available rendition regardless of orientation changes
shouldOpenOnLandscape - Whether to force rotation to landscape when entering fullscreen from portrait. Compatibility Note: Orientation control support varies by Android version and device type. Android 16+ may ignore orientation restrictions on large screens (tablets, foldables). Phones typically maintain orientation control support across Android versions. Effectiveness depends on device capabilities and Android system behavior
bufferingSpinnerDelayMs: Long - The delay in milliseconds before the buffering spinner becomes visible. Default: 1000 ms.

data class BlazeVideosPlaybackConfiguration(
    val multiAspectRatio: Boolean,
    val shouldOpenOnLandscape: Boolean,
    val bufferingSpinnerDelayMs: Long
)

bufferingSpinnerDelayMs

The delay in milliseconds before the buffering spinner becomes visible during playback.

If the player finishes buffering before this threshold elapses, the spinner is never shown.

Default: 1000 ms
Type: Long
Min: 0 (spinner appears immediately on buffering)

val config = BlazeVideosPlaybackConfiguration.base().apply {
    bufferingSpinnerDelayMs = 500L
}
BlazeSDK.setDefaultVideosPlaybackConfiguration(config)