HlsExtractorFactory

Artifact: androidx.media3:media3-exoplayer-hls

View Source

---

Kotlin |Java

@UnstableApi
interface HlsExtractorFactory

Known direct subclasses

DefaultHlsExtractorFactory

DefaultHlsExtractorFactory

Default HlsExtractorFactory implementation.

---

Factory for HLS media chunk extractors.

Summary

Constants
const HlsExtractorFactory!	DEFAULT

Public functions
HlsMediaChunkExtractor!	createExtractor(     uri: Uri!,     format: Format!,     muxedCaptionFormats: (Mutable)List<Format!>?,     timestampAdjuster: TimestampAdjuster!,     responseHeaders: (Mutable)Map<String!, (Mutable)List<String!>!>!,     sniffingExtractorInput: ExtractorInput!,     playerId: PlayerId! ) Creates an Extractor for extracting HLS media chunks.
HlsExtractorFactory!	@CanIgnoreReturnValue experimentalParseSubtitlesDuringExtraction(     parseSubtitlesDuringExtraction: Boolean ) Sets whether subtitles should be parsed as part of extraction (before being added to the sample queue) or as part of rendering (when being taken from the sample queue).
Format!	getOutputTextFormat(sourceFormat: Format!) Returns the output Format of emitted text samples which were originally in sourceFormat.
HlsExtractorFactory!	@CanIgnoreReturnValue setSubtitleParserFactory(subtitleParserFactory: SubtitleParser.Factory!) Sets the SubtitleParser.Factory to use for parsing subtitles during extraction.

Constants

DEFAULT

const val DEFAULT: HlsExtractorFactory!

Public functions

createExtractor

fun createExtractor(
    uri: Uri!,
    format: Format!,
    muxedCaptionFormats: (Mutable)List<Format!>?,
    timestampAdjuster: TimestampAdjuster!,
    responseHeaders: (Mutable)Map<String!, (Mutable)List<String!>!>!,
    sniffingExtractorInput: ExtractorInput!,
    playerId: PlayerId!
): HlsMediaChunkExtractor!

Creates an Extractor for extracting HLS media chunks.

Parameters
uri: Uri!	The URI of the media chunk.
format: Format!	A Format associated with the chunk to extract.
muxedCaptionFormats: (Mutable)List<Format!>?	List of muxed caption Formats. Null if no closed caption information is available in the multivariant playlist.
timestampAdjuster: TimestampAdjuster!	Adjuster corresponding to the provided discontinuity sequence number.
responseHeaders: (Mutable)Map<String!, (Mutable)List<String!>!>!	The HTTP response headers associated with the media segment or initialization section to extract.
sniffingExtractorInput: ExtractorInput!	The first extractor input that will be passed to the returned extractor's read. Must only be used to call sniff.
playerId: PlayerId!	The PlayerId of the player using this extractors factory.

Returns
HlsMediaChunkExtractor!	An HlsMediaChunkExtractor.

Throws
java.io.IOException	If an I/O error is encountered while sniffing.

experimentalParseSubtitlesDuringExtraction

@CanIgnoreReturnValue
fun experimentalParseSubtitlesDuringExtraction(
    parseSubtitlesDuringExtraction: Boolean
): HlsExtractorFactory!

Sets whether subtitles should be parsed as part of extraction (before being added to the sample queue) or as part of rendering (when being taken from the sample queue). Defaults to false (i.e. subtitles will be parsed as part of rendering).

This method is experimental and will be renamed or removed in a future release.

Parameters
parseSubtitlesDuringExtraction: Boolean	Whether to parse subtitles during extraction or rendering.

Returns
HlsExtractorFactory!	This factory, for convenience.

getOutputTextFormat

fun getOutputTextFormat(sourceFormat: Format!): Format!

Returns the output Format of emitted text samples which were originally in sourceFormat.

In many cases, where an Extractor emits samples from the source without mutation, this method simply returns sourceFormat. In other cases, such as an Extractor that transcodes subtitles from the sourceFormat to APPLICATION_MEDIA3_CUES, the format is updated to indicate the transcoding that is taking place.

Non-text source formats are always returned without mutation.

Parameters
sourceFormat: Format!	The original text-based format.

Returns
Format!	The Format that will be associated with a text track.

setSubtitleParserFactory

@CanIgnoreReturnValue
fun setSubtitleParserFactory(subtitleParserFactory: SubtitleParser.Factory!): HlsExtractorFactory!

Sets the SubtitleParser.Factory to use for parsing subtitles during extraction. The default factory value is implementation dependent.

Parameters
subtitleParserFactory: SubtitleParser.Factory!	The SubtitleParser.Factory for parsing subtitles during extraction.

Returns
HlsExtractorFactory!	This factory, for convenience.