ForwardingExtractorsFactory

@UnstableApi
public class ForwardingExtractorsFactory implements ExtractorsFactory

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

Summary

Public constructors

Creates a forwarding ExtractorsFactory.

Public methods
Extractor[]

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

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

Inherited Constants
From androidx.media3.extractor.ExtractorsFactory
static final ExtractorsFactory

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 H.264 and H.265.

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.