Skip to main content
Version: v7 Alpha

Class: VideoPlayer

Defined in: VideoPlayer.ts:20

Extends

  • VideoPlayerEvents

Implements

  • VideoPlayerBase

Constructors

Constructor

new VideoPlayer(source): VideoPlayer;

Defined in: VideoPlayer.ts:25

Parameters

ParameterType
source| VideoSource | VideoConfig | VideoPlayerSource

Returns

VideoPlayer

Overrides

VideoPlayerEvents.constructor

Properties

onError()?

optional onError: (error) => void = undefined;

Defined in: VideoPlayer.ts:23

Parameters

ParameterType
errorVideoRuntimeError

Returns

void

Accessors

currentTime

Get Signature

get currentTime(): number;

Defined in: VideoPlayer.ts:109

The duration of the video in seconds (1.0 = 1 sec). Returns NaN if the duration is not available.

Returns

number

Set Signature

set currentTime(value): void;

Defined in: VideoPlayer.ts:113

The duration of the video in seconds (1.0 = 1 sec). Returns NaN if the duration is not available.

Parameters
ParameterType
valuenumber
Returns

void

Implementation of

VideoPlayerBase.currentTime

duration

Get Signature

get duration(): number;

Defined in: VideoPlayer.ts:95

The current time of the video in seconds (1.0 = 1 sec). Returns NaN if the current time is not available.

Returns

number

Implementation of

VideoPlayerBase.duration

ignoreSilentSwitchMode

Get Signature

get ignoreSilentSwitchMode(): IgnoreSilentSwitchMode;

Defined in: VideoPlayer.ts:154

Controls the silent switch mode of the player.

Note

This is only supported on iOS.

  • auto - uses default behavior for player.
  • ignore - ignore the silent switch.
  • obey - obey the silent switch.
Returns

IgnoreSilentSwitchMode

Set Signature

set ignoreSilentSwitchMode(value): void;

Defined in: VideoPlayer.ts:158

Controls the silent switch mode of the player.

Note

This is only supported on iOS.

  • auto - uses default behavior for player.
  • ignore - ignore the silent switch.
  • obey - obey the silent switch.
Parameters
ParameterType
valueIgnoreSilentSwitchMode
Returns

void

Implementation of

VideoPlayerBase.ignoreSilentSwitchMode

isPlaying

Get Signature

get isPlaying(): boolean;

Defined in: VideoPlayer.ts:187

Whether the player is playing.

Note

This is a read-only property.

Note

To pause/resume the player, you need to use play and pause methods.

Returns

boolean

Implementation of

VideoPlayerBase.isPlaying

loop

Get Signature

get loop(): boolean;

Defined in: VideoPlayer.ts:127

Whether the player is looped.

Returns

boolean

Set Signature

set loop(value): void;

Defined in: VideoPlayer.ts:131

Whether the player is looped.

Parameters
ParameterType
valueboolean
Returns

void

Implementation of

VideoPlayerBase.loop

mixAudioMode

Get Signature

get mixAudioMode(): MixAudioMode;

Defined in: VideoPlayer.ts:145

Controls the audio mixing mode of the player.

  • mixWithOthers - Mix with other players.
  • doNotMix - Do not mix with other players.
  • duckOthers - Duck other players.
  • auto - uses default behavior for player.

default is auto.

Returns

MixAudioMode

Set Signature

set mixAudioMode(value): void;

Defined in: VideoPlayer.ts:149

Controls the audio mixing mode of the player.

  • mixWithOthers - Mix with other players.
  • doNotMix - Do not mix with other players.
  • duckOthers - Duck other players.
  • auto - uses default behavior for player.

default is auto.

Parameters
ParameterType
valueMixAudioMode
Returns

void

Implementation of

VideoPlayerBase.mixAudioMode

muted

Get Signature

get muted(): boolean;

Defined in: VideoPlayer.ts:118

Whether the player is muted.

Returns

boolean

Set Signature

set muted(value): void;

Defined in: VideoPlayer.ts:122

Whether the player is muted.

Parameters
ParameterType
valueboolean
Returns

void

Implementation of

VideoPlayerBase.muted

onAudioBecomingNoisy

Get Signature

get onAudioBecomingNoisy(): () => void;

Defined in: VideoPlayerEvents.ts:58

Called when the audio becomes noisy.

Platform

Android

Returns
(): void;
Returns

void

Set Signature

set onAudioBecomingNoisy(value): void;

Defined in: VideoPlayerEvents.ts:52

Called when the audio becomes noisy.

Platform

Android

Parameters
ParameterType
value() => void
Returns

void

Inherited from

VideoPlayerEvents.onAudioBecomingNoisy

onAudioFocusChange

Get Signature

get onAudioFocusChange(): (hasAudioFocus) => void;

Defined in: VideoPlayerEvents.ts:68

Called when the audio focus changes.

Platform

Android

Returns
(hasAudioFocus): void;
Parameters
ParameterType
hasAudioFocusboolean
Returns

void

Set Signature

set onAudioFocusChange(value): void;

Defined in: VideoPlayerEvents.ts:62

Called when the audio focus changes.

Platform

Android

Parameters
ParameterType
value(hasAudioFocus) => void
Returns

void

Inherited from

VideoPlayerEvents.onAudioFocusChange

onBandwidthUpdate

Get Signature

get onBandwidthUpdate(): (data) => void;

Defined in: VideoPlayerEvents.ts:78

Called when the bandwidth of the video changes.

Returns
(data): void;
Parameters
ParameterType
dataBandwidthData
Returns

void

Set Signature

set onBandwidthUpdate(value): void;

Defined in: VideoPlayerEvents.ts:72

Called when the bandwidth of the video changes.

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onBandwidthUpdate

onBuffer

Get Signature

get onBuffer(): (buffering) => void;

Defined in: VideoPlayerEvents.ts:86

Called when the video is buffering.

Returns
(buffering): void;
Parameters
ParameterType
bufferingboolean
Returns

void

Set Signature

set onBuffer(value): void;

Defined in: VideoPlayerEvents.ts:82

Called when the video is buffering.

Parameters
ParameterType
value(buffering) => void
Returns

void

Inherited from

VideoPlayerEvents.onBuffer

onControlsVisibleChange

Get Signature

get onControlsVisibleChange(): (visible) => void;

Defined in: VideoPlayerEvents.ts:96

Called when the video view's controls visibility changes.

Returns
(visible): void;
Parameters
ParameterType
visibleboolean
Returns

void

Set Signature

set onControlsVisibleChange(value): void;

Defined in: VideoPlayerEvents.ts:90

Called when the video view's controls visibility changes.

Parameters
ParameterType
value(visible) => void
Returns

void

Inherited from

VideoPlayerEvents.onControlsVisibleChange

onEnd

Get Signature

get onEnd(): () => void;

Defined in: VideoPlayerEvents.ts:104

Called when the video ends.

Returns
(): void;
Returns

void

Set Signature

set onEnd(value): void;

Defined in: VideoPlayerEvents.ts:100

Called when the video ends.

Parameters
ParameterType
value() => void
Returns

void

Inherited from

VideoPlayerEvents.onEnd

onExternalPlaybackChange

Get Signature

get onExternalPlaybackChange(): (externalPlaybackActive) => void;

Defined in: VideoPlayerEvents.ts:114

Called when the external playback state changes.

Platform

iOS

Returns
(externalPlaybackActive): void;
Parameters
ParameterType
externalPlaybackActiveboolean
Returns

void

Set Signature

set onExternalPlaybackChange(value): void;

Defined in: VideoPlayerEvents.ts:108

Called when the external playback state changes.

Platform

iOS

Parameters
ParameterType
value(externalPlaybackActive) => void
Returns

void

Inherited from

VideoPlayerEvents.onExternalPlaybackChange

onLoad

Get Signature

get onLoad(): (data) => void;

Defined in: VideoPlayerEvents.ts:122

Called when the video is loaded.

Note

onLoadStart -> initialize the player -> onLoad

Returns
(data): void;
Parameters
ParameterType
dataonLoadData
Returns

void

Set Signature

set onLoad(value): void;

Defined in: VideoPlayerEvents.ts:118

Called when the video is loaded.

Note

onLoadStart -> initialize the player -> onLoad

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onLoad

onLoadStart

Get Signature

get onLoadStart(): (data) => void;

Defined in: VideoPlayerEvents.ts:130

Called when the video starts loading.

Note

onLoadStart -> initialize the player -> onLoad

Returns
(data): void;
Parameters
ParameterType
dataonLoadStartData
Returns

void

Set Signature

set onLoadStart(value): void;

Defined in: VideoPlayerEvents.ts:126

Called when the video starts loading.

Note

onLoadStart -> initialize the player -> onLoad

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onLoadStart

onPlaybackRateChange

Get Signature

get onPlaybackRateChange(): (rate) => void;

Defined in: VideoPlayerEvents.ts:150

Called when the player playback rate changes.

Returns
(rate): void;
Parameters
ParameterType
ratenumber
Returns

void

Set Signature

set onPlaybackRateChange(value): void;

Defined in: VideoPlayerEvents.ts:144

Called when the player playback rate changes.

Parameters
ParameterType
value(rate) => void
Returns

void

Inherited from

VideoPlayerEvents.onPlaybackRateChange

onPlaybackStateChange

Get Signature

get onPlaybackStateChange(): (data) => void;

Defined in: VideoPlayerEvents.ts:140

Called when the player playback state changes.

Returns
(data): void;
Parameters
ParameterType
dataonPlaybackStateChangeData
Returns

void

Set Signature

set onPlaybackStateChange(value): void;

Defined in: VideoPlayerEvents.ts:134

Called when the player playback state changes.

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onPlaybackStateChange

onProgress

Get Signature

get onProgress(): (data) => void;

Defined in: VideoPlayerEvents.ts:158

Called when the player progress changes.

Returns
(data): void;
Parameters
ParameterType
dataonProgressData
Returns

void

Set Signature

set onProgress(value): void;

Defined in: VideoPlayerEvents.ts:154

Called when the player progress changes.

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onProgress

onReadyToDisplay

Get Signature

get onReadyToDisplay(): () => void;

Defined in: VideoPlayerEvents.ts:166

Called when the video is ready to display.

Returns
(): void;
Returns

void

Set Signature

set onReadyToDisplay(value): void;

Defined in: VideoPlayerEvents.ts:162

Called when the video is ready to display.

Parameters
ParameterType
value() => void
Returns

void

Inherited from

VideoPlayerEvents.onReadyToDisplay

onSeek

Get Signature

get onSeek(): (seekTime) => void;

Defined in: VideoPlayerEvents.ts:174

Called when the player seeks.

Returns
(seekTime): void;
Parameters
ParameterType
seekTimenumber
Returns

void

Set Signature

set onSeek(value): void;

Defined in: VideoPlayerEvents.ts:170

Called when the player seeks.

Parameters
ParameterType
value(seekTime) => void
Returns

void

Inherited from

VideoPlayerEvents.onSeek

onStatusChange

Get Signature

get onStatusChange(): (status) => void;

Defined in: VideoPlayerEvents.ts:182

Called when the player status changes.

Returns
(status): void;
Parameters
ParameterType
statusVideoPlayerStatus
Returns

void

Set Signature

set onStatusChange(value): void;

Defined in: VideoPlayerEvents.ts:178

Called when the player status changes.

Parameters
ParameterType
value(status) => void
Returns

void

Inherited from

VideoPlayerEvents.onStatusChange

onTextTrackDataChanged

Get Signature

get onTextTrackDataChanged(): (texts) => void;

Defined in: VideoPlayerEvents.ts:200

Called when the text track (currently displayed subtitle) data changes.

Returns
(texts): void;
Parameters
ParameterType
textsstring[]
Returns

void

Set Signature

set onTextTrackDataChanged(value): void;

Defined in: VideoPlayerEvents.ts:194

Called when the text track (currently displayed subtitle) data changes.

Parameters
ParameterType
value(texts) => void
Returns

void

Inherited from

VideoPlayerEvents.onTextTrackDataChanged

onTimedMetadata

Get Signature

get onTimedMetadata(): (metadata) => void;

Defined in: VideoPlayerEvents.ts:190

Called when player receives timed metadata.

Returns
(metadata): void;
Parameters
ParameterType
metadataTimedMetadata
Returns

void

Set Signature

set onTimedMetadata(value): void;

Defined in: VideoPlayerEvents.ts:186

Called when player receives timed metadata.

Parameters
ParameterType
value(metadata) => void
Returns

void

Inherited from

VideoPlayerEvents.onTimedMetadata

onTrackChange

Get Signature

get onTrackChange(): (track) => void;

Defined in: VideoPlayerEvents.ts:208

Called when the selected text track changes.

Returns
(track): void;
Parameters
ParameterType
tracknull | TextTrack
Returns

void

Set Signature

set onTrackChange(value): void;

Defined in: VideoPlayerEvents.ts:204

Called when the selected text track changes.

Parameters
ParameterType
value(track) => void
Returns

void

Inherited from

VideoPlayerEvents.onTrackChange

onVolumeChange

Get Signature

get onVolumeChange(): (data) => void;

Defined in: VideoPlayerEvents.ts:216

Called when the volume of the player changes.

Returns
(data): void;
Parameters
ParameterType
dataonVolumeChangeData
Returns

void

Set Signature

set onVolumeChange(value): void;

Defined in: VideoPlayerEvents.ts:212

Called when the volume of the player changes.

Parameters
ParameterType
value(data) => void
Returns

void

Inherited from

VideoPlayerEvents.onVolumeChange

playInBackground

Get Signature

get playInBackground(): boolean;

Defined in: VideoPlayer.ts:169

Whether the player should play in background.

  • true - play in background.
  • false - pause in background (default).
Note

this can override playWhenInactive.

Returns

boolean

Set Signature

set playInBackground(value): void;

Defined in: VideoPlayer.ts:173

Whether the player should play in background.

  • true - play in background.
  • false - pause in background (default).
Note

this can override playWhenInactive.

Parameters
ParameterType
valueboolean
Returns

void

Implementation of

VideoPlayerBase.playInBackground

playWhenInactive

Get Signature

get playWhenInactive(): boolean;

Defined in: VideoPlayer.ts:178

Whether the player should play when the app is inactive (user opened control center).

  • true - play when the app is inactive.
  • false - pause when the app is inactive (default).
Note

this can be overridden by playInBackground.

Note

This is only supported on iOS.

Returns

boolean

Set Signature

set playWhenInactive(value): void;

Defined in: VideoPlayer.ts:182

Whether the player should play when the app is inactive (user opened control center).

  • true - play when the app is inactive.
  • false - pause when the app is inactive (default).
Note

this can be overridden by playInBackground.

Note

This is only supported on iOS.

Parameters
ParameterType
valueboolean
Returns

void

Implementation of

VideoPlayerBase.playWhenInactive

rate

Get Signature

get rate(): number;

Defined in: VideoPlayer.ts:136

Controls the speed at which the player should play.

Note

if rate is = 0, it will pause video.

Returns

number

Set Signature

set rate(value): void;

Defined in: VideoPlayer.ts:140

Controls the speed at which the player should play.

Note

if rate is = 0, it will pause video.

Parameters
ParameterType
valuenumber
Returns

void

Implementation of

VideoPlayerBase.rate

selectedTrack

Get Signature

get selectedTrack(): undefined | TextTrack;

Defined in: VideoPlayer.ts:270

Get the currently selected text track.

Returns

undefined | TextTrack

The currently selected text track, or undefined if none is selected

Implementation of

VideoPlayerBase.selectedTrack

source

Get Signature

get source(): VideoPlayerSource;

Defined in: VideoPlayer.ts:85

The source of the video. Source is immutable. To change the source, you need to call replaceSourceAsync method. see VideoPlayerSourceBase

Returns

VideoPlayerSource

Implementation of

VideoPlayerBase.source

status

Get Signature

get status(): VideoPlayerStatus;

Defined in: VideoPlayer.ts:90

The status of the player.

Returns

VideoPlayerStatus

Implementation of

VideoPlayerBase.status

volume

Get Signature

get volume(): number;

Defined in: VideoPlayer.ts:100

The volume of the video (0.0 = 0%, 1.0 = 100%).

Note

If the player is muted, the volume will be 0.0.

Returns

number

Set Signature

set volume(value): void;

Defined in: VideoPlayer.ts:104

The volume of the video (0.0 = 0%, 1.0 = 100%).

Note

If the player is muted, the volume will be 0.0.

Parameters
ParameterType
valuenumber
Returns

void

Implementation of

VideoPlayerBase.volume

Methods

clearAllEvents()

clearAllEvents(): void;

Defined in: VideoPlayerEvents.ts:36

Clears all events from the event emitter.

Returns

void

Inherited from

VideoPlayerEvents.clearAllEvents

clearEvent()

clearEvent(event): void;

Defined in: VideoPlayerEvents.ts:46

Clears a specific event from the event emitter.

Parameters

ParameterTypeDescription
eventkeyof VideoPlayerEventsThe name of the event to clear.

Returns

void

Inherited from

VideoPlayerEvents.clearEvent

getAvailableTextTracks()

getAvailableTextTracks(): TextTrack[];

Defined in: VideoPlayer.ts:252

Get all available text tracks for the current source.

Returns

TextTrack[]

Array of available text tracks

Implementation of

VideoPlayerBase.getAvailableTextTracks

pause()

pause(): void;

Defined in: VideoPlayer.ts:215

Pause playback of player.

Returns

void

Implementation of

VideoPlayerBase.pause

play()

play(): void;

Defined in: VideoPlayer.ts:207

Start playback of player.

Returns

void

Implementation of

VideoPlayerBase.play

preload()

preload(): Promise<void>;

Defined in: VideoPlayer.ts:191

Preload the video. This is useful to avoid delay when the user plays the video. Preloading too many videos can lead to memory issues or performance issues.

Returns

Promise<void>

Implementation of

VideoPlayerBase.preload

release()

release(): void;

Defined in: VideoPlayer.ts:203

Releases the player's native resources and releases native state. After calling this method, the player is no longer usable. Accessing any properties or methods of the player after calling this method will throw an error. If you want to clean player resource use replaceSourceAsync with null instead.

Returns

void


replaceSourceAsync()

replaceSourceAsync(source): Promise<void>;

Defined in: VideoPlayer.ts:239

Replace the current source of the player.

Parameters

ParameterTypeDescription
source| null | VideoSource | VideoConfigThe new source of the video.

Returns

Promise<void>

Note

If you want to clear the source, you can pass null. see VideoPlayerSourceBase

Implementation of

VideoPlayerBase.replaceSourceAsync

seekBy()

seekBy(time): void;

Defined in: VideoPlayer.ts:223

Seek by given time. If the time is negative, it will seek backward. time will be clamped if it is out of range (0 ~ duration).

Parameters

ParameterTypeDescription
timenumberThe time to seek from current time in seconds.

Returns

void

Implementation of

VideoPlayerBase.seekBy

seekTo()

seekTo(time): void;

Defined in: VideoPlayer.ts:231

Seek to a specific time in the video.

Parameters

ParameterTypeDescription
timenumberThe time to seek to in seconds.

Returns

void

Note

This have same effect as currentTime setter.

Note

time will be clamped if it is out of range (0 ~ duration).

Implementation of

VideoPlayerBase.seekTo

selectTextTrack()

selectTextTrack(textTrack): void;

Defined in: VideoPlayer.ts:261

Select a text track to display.

Parameters

ParameterTypeDescription
textTracknull | TextTrackText track to select, or null to unselect current track

Returns

void

Implementation of

VideoPlayerBase.selectTextTrack

NOOP()

static NOOP(): void;

Defined in: VideoPlayerEvents.ts:50

Returns

void

Inherited from

VideoPlayerEvents.NOOP
We are TheWidlarzGroupPremium support →