THEOplayer > PlayerEventMap

PlayerEventMap interface

The events fired by the ChromelessPlayer.

Signature:

export interface PlayerEventMap 

Properties

Property Details

canplay

Fired when the player can resume playback of the media data.

Signature:

canplay: CanPlayEvent;

Remarks

- In comparison to canplaythrough, the player estimates that if playback were to be started now, the media resource could not be rendered at the current playback rate up to its end without having to stop for further buffering of content.
- See HTML media - network state events.

canplaythrough

Fired when the player can resume playback of the media data and buffering is unlikely.

Signature:

canplaythrough: CanPlayThroughEvent;

Remarks

- In comparison to canplay, the player estimates that if playback were to be started now, the media resource could be rendered at the current playback rate all the way to its end without having to stop for further buffering.
- See HTML media - network state events.

contentprotectionerror

Fired when an error related to content protection occurs.

Signature:

contentprotectionerror: ContentProtectionErrorEvent;

contentprotectionsuccess

Fired when the key is usable for decryption.

Signature:

contentprotectionsuccess: Event<'contentprotectionsuccess'>;

Remarks

- A key is usable if the CDM is certain the key can decrypt one or more blocks of media data.
- See Encrypted Media Extension - usable for decryption.

currentsourcechange

Fired when the current source, which is chosen from ChromelessPlayer.source.sources, changes.

Signature:

currentsourcechange: CurrentSourceChangeEvent;

destroy

Fired when the player is destroyed.

Signature:

destroy: Event<'destroy'>;

Remarks

- Available since v2.33.3.

dimensionchange

Fired when the dimensions of the HTML element changes.

Signature:

dimensionchange: DimensionChangeEvent;

Remarks

- See Element.getBoundingClientRect().

durationchange

Fired when ChromelessPlayer.duration changes.

Signature:

durationchange: DurationChangeEvent;

Remarks

- Fired after ChromelessPlayer.readyState has loaded metadata, or when the last segment is appended and there is a mismatch with the original duration.

emptied

Fired when the player's source is cleared.

Signature:

emptied: EmptiedEvent;

Remarks

- See HTML media - network state events.

encrypted

Fired when the player encounters key system initialization data in the media data.

Signature:

encrypted: EncryptedEvent;

Remarks

- See Encrypted Media Extensions.

ended

Fired when playback has stopped because the end of the media resource was reached.

Signature:

ended: EndedEvent;

error

Fired when an error occurs.

Signature:

error: ErrorEvent;

loadeddata

Fired when the player can render the media data at the current playback position for the first time.

Signature:

loadeddata: LoadedDataEvent;

Remarks

- See HTML media - network state events.

loadedmetadata

Fired when the player determines the duration and dimensions of the media resource.

Signature:

loadedmetadata: LoadedMetadataEvent;

Remarks

- See HTML media - network state events.
- The seekable range should be available as soon as the duration is known. However, certain browsers (e.g. Safari) do not make it available until the loadeddata event is fired.

loadstart

Fired when the player starts loading the manifest.

Signature:

loadstart: Event<'loadstart'>;

Remarks

- See HTML media - network state events.

manifestupdate

Fired when the manifest is updated.

Signature:

manifestupdate: Event<'manifestupdate'>;

pause

Fired when ChromelessPlayer.paused changes to true.

Signature:

pause: PauseEvent;

Remarks

- Fired after the pause() method has returned.

play

Fired when ChromelessPlayer.paused changes to false.

Signature:

play: PlayEvent;

Remarks

- Either fired after the play() method has returned, or when the ChromelessPlayer.autoplay attribute has caused playback to begin.

playing

Fired when playback is ready to start after having been paused or delayed due to lack of media data.

Signature:

playing: PlayingEvent;

progress

Fired when the player loaded media data.

Signature:

progress: ProgressEvent;

Remarks

- For DASH streams, the event is fired every 350ms or for every byte received whichever is least frequent.
- See HTML media - network state events.

ratechange

Fired when ChromelessPlayer.playbackRate changes.

Signature:

ratechange: RateChangeEvent;

readystatechange

Fired when ChromelessPlayer.readyState changes.

Signature:

readystatechange: ReadyStateChangeEvent;

representationchange

Fired when the current representation changes.

Signature:

representationchange: RepresentationChangeEvent;

resize

Fired when either ChromelessPlayer.videoWidth or ChromelessPlayer.videoHeight changes.

Signature:

resize: Event<'resize'>;

seeked

Fired when ChromelessPlayer.seeking changes to false after the current playback position was changed.

Signature:

seeked: SeekedEvent;

seeking

Fired when ChromelessPlayer.seeking changes to true, and the player has started seeking to a new position.

Signature:

seeking: SeekingEvent;

segmentnotfound

Fired when a segment can not be found.

Signature:

segmentnotfound: Event<'segmentnotfound'>;

Remarks

- Only fired on DASH streams.

sourcechange

Fired when ChromelessPlayer.source changes.

Signature:

sourcechange: SourceChangeEvent;

timeupdate

Fired when the current playback position changed as part of normal playback or in an especially interesting way, for example discontinuously.

Signature:

timeupdate: TimeUpdateEvent;

volumechange

Fired when ChromelessPlayer.volume changes.

Signature:

volumechange: VolumeChangeEvent;

waiting

Fired when playback has stopped because the next frame is not available, but the player expects that frame to become available in due course.

Signature:

waiting: WaitingEvent;