Seek Controls
The videos player provides three ways for users to seek through video content: seek buttons, double-tap gestures, and 2x speed mode via long-press. All three are available out of the box with no additional integration required.
Seek Buttons
The player provides seek forward and seek backward buttons that skip 10 seconds in the respective direction. Seek buttons are automatically shown for videos longer than 20 seconds and hidden for shorter content.
Seek button appearance is controlled through BlazeVideosPlayerStyle.buttons.seekForward and BlazeVideosPlayerStyle.buttons.seekBackward, both using the BlazeVideosPlayerButtonStyle type.
var playerStyle = BlazeVideosPlayerStyle.base()
playerStyle.buttons.seekForward.color = .systemBlue
playerStyle.buttons.seekForward.width = 40
playerStyle.buttons.seekForward.height = 40
playerStyle.buttons.seekBackward.color = .systemBlue
playerStyle.buttons.seekBackward.width = 40
playerStyle.buttons.seekBackward.height = 40
Blaze.shared.setDefaultVideosPlayerStyle(playerStyle)See BlazeVideosPlayerButtonStyle for the full list of configurable properties.
Double-Tap Seek
Double-tapping the left or right side of the player seeks backward or forward by 10 seconds respectively.
Consecutive double-taps accumulate — for example, three quick double-taps on the right side seek forward 30 seconds total, with a visual indicator displaying the cumulative amount (+10, +20, +30). When a forward double-tap reaches the end of the current video, the player automatically advances to the next video. A backward double-tap at the beginning seeks to the start.
Double-tap seek is a gesture-based interaction. The 10-second seek amount is fixed and cannot be reconfigured through the style API.
2x Speed Mode
Long-pressing anywhere on the player activates 2x speed playback. The video plays at double speed for as long as the press is held. Releasing returns playback to normal speed. A visual indicator is displayed while 2x speed mode is active.
2x speed mode is automatically deactivated when the user releases the long press, the current video ends, or the user pauses playback.
2x speed mode is a gesture-based interaction and cannot be disabled or reconfigured through the style or configuration APIs.
Behavior Notes
- Seek buttons auto-visibility — seek buttons are shown automatically for videos longer than 20 seconds and hidden for shorter content, regardless of the
isVisiblesetting. - Seek button ads behavior — seek buttons are hidden during ads by default. Control this via
isVisibleForAds. - Double-tap and speed mode are always active — these gesture interactions cannot be disabled through the style or configuration APIs.
Usage Examples
Hiding Seek Buttons
var playerStyle = BlazeVideosPlayerStyle.base()
playerStyle.buttons.seekForward.isVisible = false
playerStyle.buttons.seekBackward.isVisible = false
Blaze.shared.setDefaultVideosPlayerStyle(playerStyle)Using Custom Seek Button Images
var playerStyle = BlazeVideosPlayerStyle.base()
playerStyle.buttons.seekForward.customImage = BlazeVideosPlayerButtonCustomImageStates(
default: UIImage(named: "seek_forward_icon")!,
selected: nil
)
playerStyle.buttons.seekBackward.customImage = BlazeVideosPlayerButtonCustomImageStates(
default: UIImage(named: "seek_backward_icon")!,
selected: nil
)
Blaze.shared.setDefaultVideosPlayerStyle(playerStyle)Updated about 2 months ago
