OptionalabrThe source's ABR configuration.
- Available since v3.1.0.
- Overrides PlayerConfiguration.abr.
- Used for DASH and LL-HLS streams.
OptionalcrossThe cross-origin setting of the source.
OptionaldashThe configuration for controlling playback of an MPEG-DASH stream.
OptionalhlsThe configuration for controlling playback of an HLS stream.
OptionalhlsWhether the player should parse and expose date ranges from HLS manifests.
OptionalignoreA list of embedded TextTrackTypes to ignore when parsing media segments.
OptionalintegrationThe integration ID of the source.
OptionallatencyThe source's latency configuration.
OptionallcevcWhether this source should be played using the LCEVC sdk.
OptionalliveThe offset in seconds used to determine the live point. This live point is the end of the manifest minus the provided offset.
- Available since v2.35.0.
- Will be overridden by SourceLatencyConfiguration.targetOffset if it is specified.
OptionallowWhether the source should be played in the low-latency-mode of the player.
OptionalseamlessWhether to seamlessly switch between discontinuities or periods.
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.)
OptionaltimeThe URL of a time server used by the player to synchronise the time in DASH sources.
- 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.
OptionaluseWhether the player is allowed to use credentials for cross-origin requests.
Optionaluse(Experimental) Whether to use ManagedMediaSource if available.
- 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.
OptionaluseWhether this source should be played using native playback.
Represents the common properties of a media resource.