ExtractorsFactory

Artifact: androidx.media3:media3-extractor

Kotlin |Java

@UnstableApi
public interface ExtractorsFactory

Known direct subclasses

DefaultExtractorsFactory

DefaultExtractorsFactory

An ExtractorsFactory that provides an array of extractors for the following formats:

Factory for arrays of Extractor instances.

Summary

Constants
`default static final ExtractorsFactory`	`EMPTY` Extractor factory that returns an empty list of extractors.

Public methods
`abstract Extractor[]`	`createExtractors()` Returns an array of new `Extractor` instances.
`default Extractor[]`	`createExtractors(Uri uri, Map<String, List<String>> responseHeaders)` Returns an array of new `Extractor` instances.
`default ExtractorsFactory`	`@CanIgnoreReturnValue 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.
`default ExtractorsFactory`	`@CanIgnoreReturnValue 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.
`default ExtractorsFactory`	`setSubtitleParserFactory(SubtitleParser.Factory subtitleParserFactory)` Sets a `SubtitleParser.Factory` to use when transcoding text tracks.

Constants

EMPTY

default static final ExtractorsFactory EMPTY

Extractor factory that returns an empty list of extractors. Can be used whenever Extractors are not required.

Public methods

createExtractors

abstract Extractor[] createExtractors()

Returns an array of new Extractor instances.

createExtractors

default 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

@CanIgnoreReturnValue
default 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

@CanIgnoreReturnValue
default 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

default 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.