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<StringList<String>> responseHeaders)

Returns an array of new Extractor instances.

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<StringList<String>> responseHeaders)

Returns an array of new Extractor instances.

Parameters
Uri uri

The Uri of the media to extract.

Map<StringList<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.

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.