Interface PlayerConfiguration

interface PlayerConfiguration {
    ads?: AdsConfiguration;
    cast?: CastConfiguration;
    chromeless?: boolean;
    enableTHEOlive?: boolean;
    hlsDateRange?: boolean;
    libraryLocation?: string;
    license?: string;
    licenseUrl?: string;
    liveOffset?: number;
    mediaControl?: MediaControlConfiguration;
    mutedAutoplay?: MutedAutoplayConfiguration;
    retryConfiguration?: RetryConfiguration;
    ui?: UIConfiguration;
    useMedia3?: boolean;
}

Properties

The ads configuration for the player.

The cast configuration for the player.

chromeless?: boolean

Sets whether the native player is chromeless (without UI).

Remarks


- This parameter only applies to Web platforms.

enableTHEOlive?: boolean

Sets whether support for THEOlive sources should be enabled.

Default Value

false. @deprecated: THEOlive support is always enabled, there is no need to explicitly enable it.

hlsDateRange?: boolean

Sets whether DateRange tags from the playlists should be imported as a textTrack.

libraryLocation?: string

The directory in which the THEOplayer library worker files are located. These worker files are THEOplayer.transmux.*

Remarks


- This parameter is required when using a HLS source and has no default.

Example

`'/lib/theoplayer/'`
license?: string

The license for the player

licenseUrl?: string

The url to fetch the license for the player

liveOffset?: number

The offset in seconds used to determine the live point. This live point is the end of the manifest minus the provided offset.

Default Value

Three times the target duration of a segment, as specified by the manifest.

Remarks


- This parameter only applies to Web and Android platforms.

The configuration of media controls and media sessions across platforms.

The muted autoplay policy for web.

Remarks


- The muted autoplay policy is impacted by this property and theoplayer!SourceConfiguration.mutedAutoplay.

Default Value

'none'.

retryConfiguration?: RetryConfiguration

The retry configuration for the player.

Remarks


- This parameter only applies to Web and Android platforms.

The ui configuration for the underlying native player. Applies to Ad UI.

useMedia3?: boolean

Sets whether the Media3 extension is used for play-out on Android.

Remarks


- This parameter only applies to Android platforms.

Default Value

false.