ExtractorsFactory

Artifact: androidx.media3:media3-extractor

Kotlin |Java

@UnstableApi
interface ExtractorsFactory

Known direct subclasses

DefaultExtractorsFactory, ForwardingExtractorsFactory

`DefaultExtractorsFactory`	An `ExtractorsFactory` that provides an array of extractors for the following formats:
`ForwardingExtractorsFactory`	A forwarding `ExtractorsFactory` that forwards all methods to the underlying implementation.

Factory for arrays of Extractor instances.

Summary

Constants
`const ExtractorsFactory!`	`EMPTY` Extractor factory that returns an empty list of extractors.

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

Constants

EMPTY

const val EMPTY: ExtractorsFactory!

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

Public functions

createExtractors

fun createExtractors(): Array<Extractor!>!

Returns an array of new Extractor instances.

createExtractors

fun createExtractors(
    uri: Uri!,
    responseHeaders: (Mutable)Map<String!, (Mutable)List<String!>!>!
): Array<Extractor!>!

Returns an array of new Extractor instances.

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

Returns
`Array<Extractor!>!`	The `Extractor` instances.

experimentalSetCodecsToParseWithinGopSampleDependencies

@CanIgnoreReturnValue
@ExperimentalApi
fun experimentalSetCodecsToParseWithinGopSampleDependencies(
    @C.VideoCodecFlags codecsToParseWithinGopSampleDependencies: Int
): ExtractorsFactory!

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 codecsToParseWithinGopSampleDependencies: Int`	The set of codecs for which to parse within GOP sample dependency information.

Returns
`ExtractorsFactory!`	This factory, for convenience.

experimentalSetTextTrackTranscodingEnabled

@CanIgnoreReturnValue
@ExperimentalApi
fun experimentalSetTextTrackTranscodingEnabled(
    textTrackTranscodingEnabled: Boolean
): ExtractorsFactory!

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
`textTrackTranscodingEnabled: Boolean`	Whether to enable transcoding.

Returns
`ExtractorsFactory!`	The factory, for convenience.

setSubtitleParserFactory

fun setSubtitleParserFactory(subtitleParserFactory: SubtitleParser.Factory!): ExtractorsFactory!

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

This is only works if experimentalSetTextTrackTranscodingEnabled is enabled.

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

Returns
`ExtractorsFactory!`	The factory, for convenience.