Interface MillicastSource

Represents a source for a Millicast live stream.

interface MillicastSource {
    abr?: SourceAbrConfiguration;
    connectOptions?: Record<string, any>;
    contentProtection?: DRMConfiguration;
    crossOrigin?: CrossOriginSetting;
    dash?: DashPlaybackConfiguration;
    drm?: DRMConfiguration;
    hls?: HlsPlaybackConfiguration;
    hlsDateRange?: boolean;
    ignoreEmbeddedTextTrackTypes?: TextTrackType[];
    integration?: SourceIntegrationId;
    latencyConfiguration?: SourceLatencyConfiguration;
    lcevc?: boolean;
    liveOffset?: number;
    lowLatency?: boolean;
    seamlessSwitchStrategy?: SeamlessSwitchStrategy;
    src: string;
    ssai?: ServerSideAdInsertionConfiguration;
    streamAccountId: string;
    streamName?: string;
    subscriberToken?: string;
    timeServer?: string;
    type: "millicast";
    useCredentials?: boolean;
    useManagedMediaSource?: boolean;
    useNativePlayback?: boolean;
}

Hierarchy (view full)

TypedSource
- MillicastSource

Properties

`Optional`abr

abr?: SourceAbrConfiguration

The source's ABR configuration.

Remarks

- Available since v3.1.0.
- Overrides PlayerConfiguration.abr.
- Used for DASH and LL-HLS streams.

`Optional`connectOptions

connectOptions?: Record<string, any>

An optional configuration object to set additional subscriber options.

The available options are listed in the link below.

See

https://millicast.github.io/millicast-sdk/View.html#connect

`Optional`contentProtection

contentProtection?: DRMConfiguration

The content protection parameters for the media resource.

Remarks

- Available since v2.15.0.

`Optional`crossOrigin

crossOrigin?: CrossOriginSetting

The cross-origin setting of the source.

Default Value

''

Remarks

- Available since v2.9.0.

`Optional`dash

dash?: DashPlaybackConfiguration

The configuration for controlling playback of an MPEG-DASH stream.

Remarks

- Available since v2.79.0.
- Ignored for non-DASH streams.

`Optional`drm

drm?: DRMConfiguration

The content protection parameters for the media resource.

Deprecated

Superseded by TypedSource.contentProtection.

`Optional`hls

hls?: HlsPlaybackConfiguration

The configuration for controlling playback of an HLS stream.

Remarks

- Available since v2.82.0.
- Ignored for non-HLS streams.

`Optional`hlsDateRange

hlsDateRange?: boolean

Whether the player should parse and expose date ranges from HLS manifests.

Default Value

false

Remarks

- Available since v2.61.0.

`Optional`ignoreEmbeddedTextTrackTypes

ignoreEmbeddedTextTrackTypes?: TextTrackType[]

A list of embedded TextTrackTypes to ignore when parsing media segments.

Remarks

- Available since v5.9.0
- Only 'cea608' and 'emsg' can currently be ignored.
- Only for DASH and HLS playback.

`Optional`integration

integration?: SourceIntegrationId

The integration ID of the source.

Remarks

- This can be used to signal that a source is specific to an integration.

`Optional`latencyConfiguration

latencyConfiguration?: SourceLatencyConfiguration

The source's latency configuration.

Remarks

- Available since v7.4.0.
- Ignored for VOD playback.

`Optional`lcevc

lcevc?: boolean

Whether this source should be played using the LCEVC sdk.

Remarks

- Requires the LCEVC feature to be enabled.
- Requires the V-Nova LCEVC SDK to be loaded on the page.
- Only available for DASH and HLS streams.

`Optional`liveOffset

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.

Remarks

- Available since v2.35.0.
- Will be overridden by SourceLatencyConfiguration.targetOffset if it is specified.

Default Value

Three times the segment's target duration.

`Optional`lowLatency

lowLatency?: boolean

Whether the source should be played in the low-latency-mode of the player.

Default Value

false

Remarks

- This setting must be true when using Low-Latency CMAF with ABR.
- Available since v2.62.0.

`Optional`seamlessSwitchStrategy

seamlessSwitchStrategy?: SeamlessSwitchStrategy

Whether to seamlessly switch between discontinuities or periods.

Remarks

The player supports two strategies for handling a switch between two discontinuities in an HLS stream or two periods in an MPEG-DASH stream:
- Seamless: Once the player is done buffering the current discontinuity/period, it immediately starts buffering the next discontinuity/period. This requires that the current discontinuity/period and the next discontinuity/period have compatible codecs and content protection, or that the platform supports buffering different codecs in a single player. Because the next discontinuity/period is preloaded ahead of time, this makes the actual switch between discontinuities/periods (almost) completely seamless.
- Hard: The player waits until playback reaches the end of the current discontinuity/period before buffering and playing the next discontinuity/period. Because the buffering is not done ahead of time, this may result in a noticeable stall at the start of the next discontinuity/period. However, this strategy does not require any special platform support, so it works on any platform or device.

By default, the player will automatically choose between a seamless or a hard discontinuity/period switch based on the codecs and content protection of the two discontinuities/periods, and the support information reported by the platform. However, if you notice that the player makes an incorrect decision on certain streams or platforms, you can use this option to override its behavior as a stopgap solution. (You should still report this problem to THEOplayer support, so we can improve the player's default behavior and you can remove this override.)

Default Value

'auto'

src

src: string

The name of the Millicast stream to subscribe to.

See

https://millicast.github.io/millicast-sdk/global.html#DirectorSubscriberOptions

`Optional`ssai

ssai?: ServerSideAdInsertionConfiguration

The Server-side Ad Insertion parameters for the media resource.

Remarks

- Available since v2.12.0.

streamAccountId

streamAccountId: string

The Millicast account identifier.

See

https://millicast.github.io/millicast-sdk/global.html#DirectorSubscriberOptions

`Optional`streamName

streamName?: string

The name of the Millicast stream to subscribe to.

See

https://millicast.github.io/millicast-sdk/global.html#DirectorSubscriberOptions

Deprecated

use MillicastSource.src instead

`Optional`subscriberToken

subscriberToken?: string

Token to subscribe to secure streams.

If you are subscribing to an unsecure stream, you can omit this param.

See

https://millicast.github.io/millicast-sdk/global.html#DirectorSubscriberOptions

`Optional`timeServer

timeServer?: string

The URL of a time server used by the player to synchronise the time in DASH sources.

Remarks

- Available since v2.47.0.
- The time server should return time in ISO-8601 format.
- Overrides the time server provided the DASH manifest's <UTCTiming>.
- Only this source will use the time server. Alternatively, for all source use SourceConfiguration.timeServer.

type

The content type.

Must be "millicast".

`Optional`useCredentials

useCredentials?: boolean

Whether the player is allowed to use credentials for cross-origin requests.

Remarks

- Credentials are cookies, authorization headers or TLS client certificates.

Default Value

false

`Optional`useManagedMediaSource

useManagedMediaSource?: boolean

(Experimental) Whether to use ManagedMediaSource if available.

Default Value

false

Remarks

- Available since v6.2.0.
- At the moment, this requires iOS 17.1 beta 2 or higher, with the "Managed Media Source API" feature flag turned on in the Advanced settings of Safari.
- Ignored if BaseSource.useNativePlayback is true.

See

https://github.com/w3c/media-source/issues/320

`Optional`useNativePlayback

useNativePlayback?: boolean

Whether this source should be played using native playback.

Default Value

false

Remarks

- Available since v2.68.0.
- Ignored for DASH streams.
- Only supported on browsers that can play HLS streams natively, will error otherwise.

Interface MillicastSource

Hierarchy (view full)

Index

Properties

Properties

Optionalabr

Remarks

OptionalconnectOptions

See

OptionalcontentProtection

Remarks

OptionalcrossOrigin

Default Value

Remarks

Optionaldash

Remarks

Optionaldrm

Deprecated

Optionalhls

Remarks

OptionalhlsDateRange

Default Value

Remarks

OptionalignoreEmbeddedTextTrackTypes

Remarks

Optionalintegration

Remarks

OptionallatencyConfiguration

Remarks

Optionallcevc

Remarks

OptionalliveOffset

Remarks

Default Value

OptionallowLatency

Default Value

Remarks

OptionalseamlessSwitchStrategy

Remarks

Default Value

src

See

Optionalssai

Remarks

streamAccountId

See

OptionalstreamName

See

Deprecated

OptionalsubscriberToken

See

OptionaltimeServer

Remarks

type

OptionaluseCredentials

Remarks

Default Value

OptionaluseManagedMediaSource

Default Value

Remarks

See

OptionaluseNativePlayback

Default Value

Remarks

Settings

On This Page

`Optional`abr

`Optional`connectOptions

`Optional`contentProtection

`Optional`crossOrigin

`Optional`dash

`Optional`drm

`Optional`hls

`Optional`hlsDateRange

`Optional`ignoreEmbeddedTextTrackTypes

`Optional`integration

`Optional`latencyConfiguration

`Optional`lcevc

`Optional`liveOffset

`Optional`lowLatency

`Optional`seamlessSwitchStrategy

`Optional`ssai

`Optional`streamName

`Optional`subscriberToken

`Optional`timeServer

`Optional`useCredentials

`Optional`useManagedMediaSource

`Optional`useNativePlayback