ForwardingExtractorsFactory

Artifact: androidx.media3:media3-extractor

Kotlin |Java

@UnstableApi
public class ForwardingExtractorsFactory implements ExtractorsFactory

A forwarding ExtractorsFactory that forwards all methods to the underlying implementation.

Summary

Public constructors
`ForwardingExtractorsFactory(ExtractorsFactory factory)` Creates a forwarding `ExtractorsFactory`.

Public methods
`Extractor[]`	`createExtractors()` Returns an array of new `Extractor` instances.
`Extractor[]`	`createExtractors(Uri uri, Map<String, List<String>> responseHeaders)` Returns an array of new `Extractor` instances.
`ExtractorsFactory`	`experimentalSetCodecsToParseWithinGopSampleDependencies( @C.VideoCodecFlags int codecsToParseWithinGopSampleDependencies )` Sets the set of video codecs for which within GOP sample dependency information should be parsed as part of extraction.
`ExtractorsFactory`	`experimentalSetTextTrackTranscodingEnabled( boolean textTrackTranscodingEnabled )` This method is deprecated. This method (and all support for 'legacy' subtitle decoding during rendering) will be removed in a future release.
`ExtractorsFactory`	`setSubtitleParserFactory(SubtitleParser.Factory subtitleParserFactory)` Sets a `SubtitleParser.Factory` to use when transcoding text tracks.

Inherited Constants

From androidx.media3.extractor.ExtractorsFactory

static final ExtractorsFactory

EMPTY

Extractor factory that returns an empty list of extractors.

Public constructors

ForwardingExtractorsFactory

public ForwardingExtractorsFactory(ExtractorsFactory factory)

Creates a forwarding ExtractorsFactory.

Parameters
`ExtractorsFactory factory`	The `ExtractorsFactory` to forward to.

Public methods

createExtractors

public Extractor[] createExtractors()

Returns an array of new Extractor instances.

createExtractors

public Extractor[] createExtractors(Uri uri, Map<String, List<String>> responseHeaders)

Returns an array of new Extractor instances.

Parameters
`Uri uri`	The `Uri` of the media to extract.
`Map<String, List<String>> responseHeaders`	The response headers of the media to extract, or an empty map if there are none. The map lookup should be case-insensitive.

Returns
`Extractor[]`	The `Extractor` instances.

experimentalSetCodecsToParseWithinGopSampleDependencies

public ExtractorsFactory experimentalSetCodecsToParseWithinGopSampleDependencies(
    @C.VideoCodecFlags int codecsToParseWithinGopSampleDependencies
)

Sets the set of video codecs for which within GOP sample dependency information should be parsed as part of extraction. Defaults to 0 - empty set of codecs.

Having access to additional sample dependency information can speed up seeking. See FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES.

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

Parameters
`@C.VideoCodecFlags int codecsToParseWithinGopSampleDependencies`	The set of codecs for which to parse within GOP sample dependency information.

Returns
`ExtractorsFactory`	This factory, for convenience.

experimentalSetTextTrackTranscodingEnabled

public ExtractorsFactory experimentalSetTextTrackTranscodingEnabled(
    boolean textTrackTranscodingEnabled
)

Enables transcoding of text track samples to APPLICATION_MEDIA3_CUES before the data is emitted to TrackOutput.

Transcoding is enabled by default.

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

Parameters
`boolean textTrackTranscodingEnabled`	Whether to enable transcoding.

Returns
`ExtractorsFactory`	The factory, for convenience.

setSubtitleParserFactory

public ExtractorsFactory setSubtitleParserFactory(SubtitleParser.Factory subtitleParserFactory)

Sets a SubtitleParser.Factory to use when transcoding text tracks.

This is only works if experimentalSetTextTrackTranscodingEnabled is enabled.

Parameters
`SubtitleParser.Factory subtitleParserFactory`	The factory for `SubtitleParser` instances.

Returns
`ExtractorsFactory`	The factory, for convenience.