Constructor Detail

• Factory

  public Factory​(DataSource.Factory dataSourceFactory)

  Creates a new factory for DashMediaSources.

  The factory will use the following default components:

  • DefaultDashChunkSource.Factory
  • DefaultDrmSessionManagerProvider
  • DefaultLoadErrorHandlingPolicy
  • DefaultCompositeSequenceableLoaderFactory

  Parameters:

  dataSourceFactory - A factory for DataSource instances that will be used to load manifest and media data.

• Factory

  public Factory​(DashChunkSource.Factory chunkSourceFactory,
                 @Nullable
                 DataSource.Factory manifestDataSourceFactory)

  Creates a new factory for DashMediaSources.

  The factory will use the following default components:

  • DefaultDrmSessionManagerProvider
  • DefaultLoadErrorHandlingPolicy
  • DefaultCompositeSequenceableLoaderFactory

  Parameters:

  chunkSourceFactory - A factory for DashChunkSource instances.

  manifestDataSourceFactory - A factory for DataSource instances that will be used to load (and refresh) the manifest. May be null if the factory will only ever be used to create media sources with sideloaded manifests via createMediaSource(DashManifest, MediaItem).

Method Detail

• setCmcdConfigurationFactory

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setCmcdConfigurationFactory​(CmcdConfiguration.Factory cmcdConfigurationFactory)

  Description copied from interface: MediaSource.Factory
  Sets the CmcdConfiguration.Factory used to obtain a CmcdConfiguration for a MediaItem.

  Specified by:

  setCmcdConfigurationFactory in interface MediaSource.Factory

  Returns:

  This factory, for convenience.

• setDrmSessionManagerProvider

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setDrmSessionManagerProvider​(DrmSessionManagerProvider drmSessionManagerProvider)

  Description copied from interface: MediaSource.Factory
  Sets the DrmSessionManagerProvider used to obtain a DrmSessionManager for a MediaItem.

  Specified by:

  setDrmSessionManagerProvider in interface MediaSource.Factory

  Returns:

  This factory, for convenience.

• setLoadErrorHandlingPolicy

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setLoadErrorHandlingPolicy​(LoadErrorHandlingPolicy loadErrorHandlingPolicy)

  Description copied from interface: MediaSource.Factory
  Sets an optional LoadErrorHandlingPolicy.

  Specified by:

  setLoadErrorHandlingPolicy in interface MediaSource.Factory

  Returns:

  This factory, for convenience.

• setFallbackTargetLiveOffsetMs

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setFallbackTargetLiveOffsetMs​(long fallbackTargetLiveOffsetMs)

  Sets the target offset for live streams that is used if no value is defined in the MediaItem or the manifest.

  The default value is DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS.

  Parameters:

  fallbackTargetLiveOffsetMs - The fallback live target offset in milliseconds.

  Returns:

  This factory, for convenience.

• setMinLiveStartPositionUs

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setMinLiveStartPositionUs​(long minLiveStartPositionUs)

  Sets the minimum position to start playback from in a live stream, in microseconds relative to the start of the live window.

  This value will override any suggested value from the manifest and helps to prevent BehindLiveWindowException issues.

  The default value is DashMediaSource.MIN_LIVE_DEFAULT_START_POSITION_US.

  Parameters:

  minLiveStartPositionUs - The minimum live start position, in microseconds relative to the start of the live window.

  Returns:

  This factory, for convenience.

• setManifestParser

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setManifestParser​(@Nullable
                                                   ParsingLoadable.Parser<? extends DashManifest> manifestParser)

  Sets the manifest parser to parse loaded manifest data when loading a manifest URI.

  Parameters:

  manifestParser - A parser for loaded manifest data.

  Returns:

  This factory, for convenience.

• setCompositeSequenceableLoaderFactory

  @CanIgnoreReturnValue
  public DashMediaSource.Factory setCompositeSequenceableLoaderFactory​(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.

• createMediaSource

  public DashMediaSource createMediaSource​(DashManifest manifest)

  Returns a new DashMediaSource using the current parameters and the specified sideloaded manifest.

  Parameters:

  manifest - The manifest. DashManifest.dynamic must be false.

  Returns:

  The new DashMediaSource.

  Throws:

  IllegalArgumentException - If DashManifest.dynamic is true.

• createMediaSource

  public DashMediaSource createMediaSource​(DashManifest manifest,
                                           MediaItem mediaItem)

  Returns a new DashMediaSource using the current parameters and the specified sideloaded manifest.

  Parameters:

  manifest - The manifest. DashManifest.dynamic must be false.

  mediaItem - The MediaItem to be included in the timeline.

  Returns:

  The new DashMediaSource.

  Throws:

  IllegalArgumentException - If DashManifest.dynamic is true.

• createMediaSource

  public DashMediaSource createMediaSource​(MediaItem mediaItem)

  Returns a new DashMediaSource using the current parameters.

  Specified by:

  createMediaSource in interface MediaSource.Factory

  Parameters:

  mediaItem - The media item of the dash stream.

  Returns:

  The new DashMediaSource.

  Throws:

  NullPointerException - if MediaItem.localConfiguration is null.

• getSupportedTypes

  @ContentType
  public @com.google.android.exoplayer2.C.ContentType int[] getSupportedTypes()

  Description copied from interface: MediaSource.Factory
  Returns the content types supported by media sources created by this factory.

  Specified by:

  getSupportedTypes in interface MediaSource.Factory