DefaultSsChunkSource.Factory


public final class DefaultSsChunkSource.Factory implements SsChunkSource.Factory


Summary

Public constructors

Factory(DataSource.Factory dataSourceFactory)

Public methods

SsChunkSource
createChunkSource(
    LoaderErrorThrower manifestLoaderErrorThrower,
    SsManifest manifest,
    int streamElementIndex,
    ExoTrackSelection trackSelection,
    @Nullable TransferListener transferListener,
    @Nullable CmcdConfiguration cmcdConfiguration
)

Creates a new SsChunkSource.

DefaultSsChunkSource.Factory
@CanIgnoreReturnValue
experimentalParseSubtitlesDuringExtraction(
    boolean parseSubtitlesDuringExtraction
)

Sets whether subtitles should be parsed as part of extraction (before being added to the sample queue) or as part of rendering (when being taken from the sample queue).

Format

Returns the output of emitted C#TRACK_TYPE_TEXT text samples which were originally in sourceFormat}.

DefaultSsChunkSource.Factory

Sets the SubtitleParser.Factory to use for parsing subtitles during extraction.

Public constructors

Factory

public Factory(DataSource.Factory dataSourceFactory)

Public methods

createChunkSource

public SsChunkSource createChunkSource(
    LoaderErrorThrower manifestLoaderErrorThrower,
    SsManifest manifest,
    int streamElementIndex,
    ExoTrackSelection trackSelection,
    @Nullable TransferListener transferListener,
    @Nullable CmcdConfiguration cmcdConfiguration
)

Creates a new SsChunkSource.

Parameters
LoaderErrorThrower manifestLoaderErrorThrower

Throws errors affecting loading of manifests.

SsManifest manifest

The initial manifest.

int streamElementIndex

The index of the corresponding stream element in the manifest.

ExoTrackSelection trackSelection

The track selection.

@Nullable TransferListener transferListener

The transfer listener which should be informed of any data transfers. May be null if no listener is available.

@Nullable CmcdConfiguration cmcdConfiguration

The CmcdConfiguration for this chunk source.

Returns
SsChunkSource

The created SsChunkSource.

experimentalParseSubtitlesDuringExtraction

@CanIgnoreReturnValue
public DefaultSsChunkSource.Factory experimentalParseSubtitlesDuringExtraction(
    boolean parseSubtitlesDuringExtraction
)

Sets whether subtitles should be parsed as part of extraction (before being added to the sample queue) or as part of rendering (when being taken from the sample queue). Defaults to false (i.e. subtitles will be parsed as part of rendering).

This method is experimental and will be renamed or removed in a future release.

Parameters
boolean parseSubtitlesDuringExtraction

Whether to parse subtitles during extraction or rendering.

Returns
DefaultSsChunkSource.Factory

This factory, for convenience.

getOutputTextFormat

public Format getOutputTextFormat(Format sourceFormat)

Returns the output of emitted C#TRACK_TYPE_TEXT text samples which were originally in sourceFormat}.

In many cases, where an emits samples from the source without mutation, this method simply returns sourceFormat}. In other cases, such as an that transcodes subtitles from the sourceFormat} to * MimeTypes#APPLICATION_MEDIA3_CUES, the format is updated to indicate the transcoding that is taking place.

Non-text source formats are always returned without mutation.

This implementation performs transcoding of the original format to APPLICATION_MEDIA3_CUES if it is supported by SubtitleParser.Factory.

setSubtitleParserFactory

@CanIgnoreReturnValue
public DefaultSsChunkSource.Factory setSubtitleParserFactory(SubtitleParser.Factory subtitleParserFactory)

Sets the SubtitleParser.Factory to use for parsing subtitles during extraction. The default factory value is implementation dependent.

Parameters
SubtitleParser.Factory subtitleParserFactory

The SubtitleParser.Factory for parsing subtitles during extraction.

Returns
DefaultSsChunkSource.Factory

This factory, for convenience.