com.google.android.exoplayer2.source.hls

Class HlsMediaSource.Factory

java.lang.Object

com.google.android.exoplayer2.source.hls.HlsMediaSource.Factory

All Implemented Interfaces:

com.google.android.exoplayer2.source.ads.AdsMediaSource.MediaSourceFactory

Enclosing class:

HlsMediaSource

public static final class HlsMediaSource.Factory
extends java.lang.Object
implements com.google.android.exoplayer2.source.ads.AdsMediaSource.MediaSourceFactory

Factory for HlsMediaSources.

Constructor Summary

Constructors

Constructor and Description
Factory(com.google.android.exoplayer2.upstream.DataSource.Factory dataSourceFactory) Creates a new factory for HlsMediaSources.
Factory(HlsDataSourceFactory hlsDataSourceFactory) Creates a new factory for HlsMediaSources.

Method Summary

Modifier and Type	Method and Description
HlsMediaSource	createMediaSource(android.net.Uri playlistUri) Returns a new HlsMediaSource using the current parameters.
HlsMediaSource	createMediaSource(android.net.Uri playlistUri, android.os.Handler eventHandler, com.google.android.exoplayer2.source.MediaSourceEventListener eventListener) Deprecated. Use createMediaSource(Uri) and BaseMediaSource.addEventListener(Handler, MediaSourceEventListener) instead.
int[]	getSupportedTypes()
HlsMediaSource.Factory	setAllowChunklessPreparation(boolean allowChunklessPreparation) Sets whether chunkless preparation is allowed.
HlsMediaSource.Factory	setCompositeSequenceableLoaderFactory(com.google.android.exoplayer2.source.CompositeSequenceableLoaderFactory compositeSequenceableLoaderFactory) Sets the factory to create composite SequenceableLoaders for when this media source loads data from multiple streams (video, audio etc...).
HlsMediaSource.Factory	setExtractorFactory(HlsExtractorFactory extractorFactory) Sets the factory for Extractors for the segments.
HlsMediaSource.Factory	setMinLoadableRetryCount(int minLoadableRetryCount) Sets the minimum number of times to retry if a loading error occurs.
HlsMediaSource.Factory	setPlaylistParser(com.google.android.exoplayer2.upstream.ParsingLoadable.Parser<HlsPlaylist> playlistParser) Sets the parser to parse HLS playlists.
HlsMediaSource.Factory	setPlaylistTracker(HlsPlaylistTracker playlistTracker) Sets the HLS playlist tracker.
HlsMediaSource.Factory	setTag(java.lang.Object tag) Sets a tag for the media source which will be published in the Timeline of the source as Timeline.Window.tag.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Factory

public Factory(com.google.android.exoplayer2.upstream.DataSource.Factory dataSourceFactory)

Creates a new factory for HlsMediaSources.

Parameters:

dataSourceFactory - A data source factory that will be wrapped by a DefaultHlsDataSourceFactory to create DataSources for manifests, segments and keys.

Factory

public Factory(HlsDataSourceFactory hlsDataSourceFactory)

Creates a new factory for HlsMediaSources.

Parameters:

hlsDataSourceFactory - An HlsDataSourceFactory for DataSources for manifests, segments and keys.

Method Detail

setTag

public HlsMediaSource.Factory setTag(java.lang.Object tag)

Sets a tag for the media source which will be published in the Timeline of the source as Timeline.Window.tag.

Parameters:

tag - A tag for the media source.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setExtractorFactory

public HlsMediaSource.Factory setExtractorFactory(HlsExtractorFactory extractorFactory)

Sets the factory for Extractors for the segments. The default value is HlsExtractorFactory.DEFAULT.

Parameters:

extractorFactory - An HlsExtractorFactory for Extractors for the segments.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setMinLoadableRetryCount

public HlsMediaSource.Factory setMinLoadableRetryCount(int minLoadableRetryCount)

Sets the minimum number of times to retry if a loading error occurs. The default value is HlsMediaSource.DEFAULT_MIN_LOADABLE_RETRY_COUNT.

Parameters:

minLoadableRetryCount - The minimum number of times to retry if a loading error occurs.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setPlaylistParser

public HlsMediaSource.Factory setPlaylistParser(com.google.android.exoplayer2.upstream.ParsingLoadable.Parser<HlsPlaylist> playlistParser)

Sets the parser to parse HLS playlists. The default is an instance of HlsPlaylistParser.

Must not be called after calling setPlaylistTracker(com.google.android.exoplayer2.source.hls.playlist.HlsPlaylistTracker) on the same builder.

Parameters:

playlistParser - A ParsingLoadable.Parser for HLS playlists.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setPlaylistTracker

public HlsMediaSource.Factory setPlaylistTracker(HlsPlaylistTracker playlistTracker)

Sets the HLS playlist tracker. The default is an instance of DefaultHlsPlaylistTracker. Playlist trackers must not be shared by HlsMediaSource instances.

Must not be called after calling setPlaylistParser(com.google.android.exoplayer2.upstream.ParsingLoadable.Parser<com.google.android.exoplayer2.source.hls.playlist.HlsPlaylist>) on the same builder.

Parameters:

playlistTracker - A tracker for HLS playlists.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setCompositeSequenceableLoaderFactory

public HlsMediaSource.Factory setCompositeSequenceableLoaderFactory(com.google.android.exoplayer2.source.CompositeSequenceableLoaderFactory compositeSequenceableLoaderFactory)

Sets the factory to create composite SequenceableLoaders for when this media source loads data from multiple streams (video, audio etc...). The default is an instance of DefaultCompositeSequenceableLoaderFactory.

Parameters:

compositeSequenceableLoaderFactory - A factory to create composite SequenceableLoaders for when this media source loads data from multiple streams (video, audio etc...).

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

setAllowChunklessPreparation

public HlsMediaSource.Factory setAllowChunklessPreparation(boolean allowChunklessPreparation)

Sets whether chunkless preparation is allowed. If true, preparation without chunk downloads will be enabled for streams that provide sufficient information in their master playlist.

Parameters:

allowChunklessPreparation - Whether chunkless preparation is allowed.

Returns:

This factory, for convenience.

Throws:

java.lang.IllegalStateException - If one of the create methods has already been called.

createMediaSource

public HlsMediaSource createMediaSource(android.net.Uri playlistUri)

Returns a new HlsMediaSource using the current parameters.

Specified by:

createMediaSource in interface com.google.android.exoplayer2.source.ads.AdsMediaSource.MediaSourceFactory

Returns:

The new HlsMediaSource.

createMediaSource

@Deprecated
public HlsMediaSource createMediaSource(android.net.Uri playlistUri,
                                                    @Nullable
                                                    android.os.Handler eventHandler,
                                                    @Nullable
                                                    com.google.android.exoplayer2.source.MediaSourceEventListener eventListener)

Deprecated. Use createMediaSource(Uri) and BaseMediaSource.addEventListener(Handler, MediaSourceEventListener) instead.

getSupportedTypes

public int[] getSupportedTypes()

Specified by:

getSupportedTypes in interface com.google.android.exoplayer2.source.ads.AdsMediaSource.MediaSourceFactory