Class AbrService

Hierarchy

  • Service
    • AbrService

Constructors

constructor

Properties

plugin

Accessors

ended isLooping isSeeking loaded master maximumPlaybackRate minimumPlaybackRate muted playbackRateIncrements shakaInstance

Methods

abrEnabled cancelLoop clearAllRequestFilters clearAllResponseFilters configureShaka decreasePlaybackRate destroy getActiveAudioId getActiveFile getActiveSubtitleId getActiveVideoRepresentationId getAudioTracks getCurrentTime getDuration getStatus getSubtitles getVideoRepresentations increasePlaybackRate listPlugins loadVideoFile loop mute muteMuxed onPlayerStatusChanged pause play registerRequestFilter registerResponseFilter seek setAudioTrack setFrameOffset setPlaybackRate setSubtitleTrack setVideoRepresentation setVolume setVolumeController toggleMute toggleMuteMuxed togglePlay unmute unmuteMuxed updateVideoFile useDropFrame

Constructors

constructor

  • new AbrService(master, eventCallback, internalEventBus, settings): AbrService

  • Note Should only be used from within the player.

    Parameters

    • master: HTMLVideoElement

      The video element.

    • eventCallback: (<T>(event) => void)

      Callback to control internal event handling.

        • <T>(event): void

        • Type Parameters

          • T extends PlayerEvent

          Parameters

          • event: T

          Returns void

    • internalEventBus: EventMixin

      Event bus for internal communication.

    • settings: AbrPlayerSettings

      Basic settings controlling the behavior.

    Returns AbrService

Properties

plugin

plugin: PluginApi

An object containing all currently registered plugins. Access a specific plugin using the Plugins static property Name.

Example

const hotkeyPlugin = player.api.plugin[HotkeyPlugin.Name];

Accessors

ended

  • get ended(): boolean

  • Returns true if the video playback has ended, false otherwise

    Returns boolean

    See

    PlayerEventType.Ended

isLooping

isSeeking

  • get isSeeking(): boolean

  • Returns true if a seek is in progress, false otherwise

    Returns boolean

loaded

master

  • get master(): HTMLMediaElement

  • The video element used for playback.

    Returns HTMLMediaElement

maximumPlaybackRate

minimumPlaybackRate

muted

playbackRateIncrements

shakaInstance

Methods

abrEnabled

  • abrEnabled(): boolean

  • Check if the abr-manager (automatic switch) is enabled.

    Returns boolean

    True if enabled.

cancelLoop

clearAllRequestFilters

  • clearAllRequestFilters(): void

  • Reset all registered request interceptors.

    Returns void

clearAllResponseFilters

  • clearAllResponseFilters(): void

  • Reset all registered response interceptors.

    Returns void

configureShaka

decreasePlaybackRate

destroy

  • destroy(): Promise<void>

  • Destroys the service, should only be called from within the player.

    Returns Promise<void>

getActiveAudioId

  • getActiveAudioId(): number

  • Returns the current playing audios id. The id corresponds to the currently playing audio track

    Returns number

getActiveFile

  • getActiveFile(): VideoFile

  • Returns the active video file or undefined if no video file is loaded.

    Returns VideoFile

getActiveSubtitleId

  • getActiveSubtitleId(): number

  • Returns number

getActiveVideoRepresentationId

  • getActiveVideoRepresentationId(): number

  • Returns the id of the active video representation, or -1 if set to auto.

    Returns number

getAudioTracks

getCurrentTime

  • getCurrentTime(format): number

  • Returns the current time of the player in the requested format.

    Parameters

    • format: Frame

      The format to return the current time in.

    Returns number

    See

  • getCurrentTime(format): number

  • Parameters

    • format: Milliseconds

    Returns number

  • getCurrentTime(format): number

  • Parameters

    • format: Percent

    Returns number

  • getCurrentTime(format): number

  • Parameters

    • format: Seconds

    Returns number

  • getCurrentTime(format): string

  • Parameters

    • format: Timecode

    Returns string

  • getCurrentTime(format): string

  • Parameters

    • format: Time

    Returns string

  • getCurrentTime(format): string | number

  • Parameters

    • format: TimeFormat

    Returns string | number

  • getCurrentTime(): number

  • Returns number

getDuration

  • getDuration(format): number

  • Returns the duration of the current media in the requested format.

    Parameters

    • format: Frame

      The format to return the duration in.

    Returns number

    See

  • getDuration(format): number

  • Parameters

    • format: Milliseconds

    Returns number

  • getDuration(format): number

  • Parameters

    • format: Percent

    Returns number

  • getDuration(format): number

  • Parameters

    • format: Seconds

    Returns number

  • getDuration(format): string

  • Parameters

    • format: Time

    Returns string

  • getDuration(format): string

  • Parameters

    • format: Timecode

    Returns string

  • getDuration(format): string | number

  • Parameters

    • format: TimeFormat

    Returns string | number

  • getDuration(): number

  • Returns number

getStatus

  • getStatus(): PlayerStatus

  • Returns the current status of the active media.

    Returns PlayerStatus

    See

    PlayerEventType.StatusChanged

getSubtitles

getVideoRepresentations

  • getVideoRepresentations(): VideoRepresentation[]

  • Returns all available video representations.

    Returns VideoRepresentation[]

increasePlaybackRate

listPlugins

loadVideoFile

  • loadVideoFile(videoFile): void

  • Load a specific video file.

    Parameters

    • videoFile: VideoFile

      The video file to load.

    Returns void

    Throws

    Throws error originated from shaka-player if load fails.

loop

mute

muteMuxed

onPlayerStatusChanged

  • onPlayerStatusChanged(): void

  • Helper method to make sure that playback is resumed correctly. Should only be used from within the player.

    Returns void

pause

  • pause(pauseOn?, userPause?): Promise<void>

  • Pauses playback and makes sure that the player is stopped at an exact frame.

    Parameters

    • Optional pauseOn: SeekEvent

      (Optional) Seek to specific time when pausing.

    • Optional userPause: boolean

    Returns Promise<void>

play

  • play(): Promise<void>

  • Starts playback. Queues requests if the player is seeking or loading to achieve autoplay behavior.

    Returns Promise<void>

registerRequestFilter

  • registerRequestFilter(filter): void

  • Register an interceptor for shaka players network calls.

    Parameters

    Returns void

registerResponseFilter

  • registerResponseFilter(filter): void

  • Register an interceptor for shaka players network responses.

    Parameters

    Returns void

seek

  • seek(event, roundingMode?, userSeek?): Promise<void>

  • Seeks to a specific time in the current media.

    Parameters

    • event: SeekEvent

      Specifies where to seek to within the media.

    • Optional roundingMode: RoundingMode
    • Optional userSeek: boolean

    Returns Promise<void>

    See

setAudioTrack

  • setAudioTrack(id): void

  • Set the audio track.

    Parameters

    • id: number

      of the audio track.

    Returns void

setFrameOffset

  • setFrameOffset(offset): void

  • Update frameOffset value for all loaded videoFiles. Equivalent to load videoFile with a specific frameOffset.

    Parameters

    • offset: number

      Frame offset to set.

    Returns void

    See

    PlayerEventType.FrameOffsetChanged

setPlaybackRate

setSubtitleTrack

  • setSubtitleTrack(id): void

  • Sets a subtitle track.

    Parameters

    • id: number

      of the subtitle track.

    Returns void

setVideoRepresentation

  • setVideoRepresentation(id): void

  • Set the desired video representation using id. -1 will enable auto switch.

    Parameters

    • id: number

      The id of the desired representation.

    Returns void

setVolume

  • setVolume(volume): void

  • Set the volume of the player.

    Parameters

    • volume: number

      A number between 0 and 1.

    Returns void

    See

setVolumeController

  • setVolumeController(volumeController): void

  • Sets the default controller for the volume

    Parameters

    • volumeController: VolumeController

      the volume controller

    Returns void

toggleMute

toggleMuteMuxed

togglePlay

  • togglePlay(): Promise<void>

  • Toggles playback.

    Returns Promise<void>

unmute

unmuteMuxed

updateVideoFile

  • updateVideoFile(videoFile): void

  • Parameters

    • videoFile: VideoFile

    Returns void

useDropFrame

  • useDropFrame(dropFrame): void

  • Update the dropFrame value for all loaded videoFiles. Equivalent to load videoFile with dropFrame property set.

    Parameters

    • dropFrame: boolean

      Drop frame value to set.

    Returns void

    See

    PlayerEventType.DropFrameChanged

Settings

Member Visibility

Theme

On This Page

constructorpluginendedisLoopingisSeekingloadedmastermaximumPlaybackRateminimumPlaybackRatemutedplaybackRateIncrementsshakaInstanceabrEnabledcancelLoopclearAllRequestFiltersclearAllResponseFiltersconfigureShakadecreasePlaybackRatedestroygetActiveAudioIdgetActiveFilegetActiveSubtitleIdgetActiveVideoRepresentationIdgetAudioTracksgetCurrentTimegetDurationgetStatusgetSubtitlesgetVideoRepresentationsincreasePlaybackRatelistPluginsloadVideoFileloopmutemuteMuxedonPlayerStatusChangedpauseplayregisterRequestFilterregisterResponseFilterseeksetAudioTracksetFrameOffsetsetPlaybackRatesetSubtitleTracksetVideoRepresentationsetVolumesetVolumeControllertoggleMutetoggleMuteMuxedtogglePlayunmuteunmuteMuxedupdateVideoFileuseDropFrame