BlazeStoriesPlaybackConfiguration

BlazeStoriesPlaybackConfiguration represents the playback configuration for a Stories player.

It can be applied globally via BlazeSDK.setDefaultStoriesPlaybackConfiguration, or per-widget via the playbackConfiguration parameter in initWidget.

BlazeStoriesPlaybackConfiguration.base()

Returns a BlazeStoriesPlaybackConfiguration instance with default values.

fun base(): BlazeStoriesPlaybackConfiguration

Default configuration:

bufferingSpinnerDelayMs: 1000 ms
ads: .base() (pre-roll disabled)

Configuration Properties

Ads playback options for the stories player, of type BlazeStoriesAdsPlaybackConfiguration.

ads.enablePreroll

Whether an ad on the first page location plays as a pre-roll.

When enabled, the fixed-position ad on the first unread page is respected instead of skipped, so it plays as a pre-roll on the first page the viewer interacts with. When disabled, that ad is skipped and playback starts on the first content page. See Ad configuration for the concept.

Default: false (pre-roll disabled — existing behavior is unchanged)
Type: Boolean

val config = BlazeStoriesPlaybackConfiguration.base().apply {
    ads.enablePreroll = true
}

// Apply globally
BlazeSDK.setDefaultStoriesPlaybackConfiguration(config)

// Or per-widget
binding.storiesRowWidget.initWidget(
    widgetLayout = layout,
    playbackConfiguration = config,
    // ...
)

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 — preventing a spinner flash on fast connections.

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

val config = BlazeStoriesPlaybackConfiguration.base().apply {
    bufferingSpinnerDelayMs = 500L
}

// Apply globally
BlazeSDK.setDefaultStoriesPlaybackConfiguration(config)

// Or per-widget
binding.storiesRowWidget.initWidget(
    widgetLayout = layout,
    playbackConfiguration = config,
    // ...
)