ExtractorsFactory

@UnstableApi
public interface ExtractorsFactory

Known direct subclasses
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

Extractor factory that returns an empty list of extractors.

Public methods
abstract Extractor[]

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

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

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.