com.google.android.exoplayer2

Class DefaultRenderersFactory

java.lang.Object

com.google.android.exoplayer2.DefaultRenderersFactory

All Implemented Interfaces:

RenderersFactory

public class DefaultRenderersFactory
extends java.lang.Object
implements RenderersFactory

Default RenderersFactory implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DefaultRenderersFactory.ExtensionRendererMode Modes for using extension renderers.

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_ALLOWED_VIDEO_JOINING_TIME_MS The default maximum duration for which a video renderer can attempt to seamlessly join an ongoing playback.
static int	EXTENSION_RENDERER_MODE_OFF Do not allow use of extension renderers.
static int	EXTENSION_RENDERER_MODE_ON Allow use of extension renderers.
static int	EXTENSION_RENDERER_MODE_PREFER Allow use of extension renderers.
protected static int	MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY

Constructor Summary

Constructors

Constructor and Description
DefaultRenderersFactory(android.content.Context context)
DefaultRenderersFactory(android.content.Context context, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager)
DefaultRenderersFactory(android.content.Context context, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, int extensionRendererMode)
DefaultRenderersFactory(android.content.Context context, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, int extensionRendererMode, long allowedVideoJoiningTimeMs)

Method Summary

Modifier and Type	Method and Description
protected AudioProcessor[]	buildAudioProcessors() Builds an array of AudioProcessors that will process PCM audio before output.
protected void	buildAudioRenderers(android.content.Context context, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, AudioProcessor[] audioProcessors, android.os.Handler eventHandler, AudioRendererEventListener eventListener, int extensionRendererMode, java.util.ArrayList<Renderer> out) Builds audio renderers for use by the player.
protected void	buildMetadataRenderers(android.content.Context context, MetadataOutput output, android.os.Looper outputLooper, int extensionRendererMode, java.util.ArrayList<Renderer> out) Builds metadata renderers for use by the player.
protected void	buildMiscellaneousRenderers(android.content.Context context, android.os.Handler eventHandler, int extensionRendererMode, java.util.ArrayList<Renderer> out) Builds any miscellaneous renderers used by the player.
protected void	buildTextRenderers(android.content.Context context, TextOutput output, android.os.Looper outputLooper, int extensionRendererMode, java.util.ArrayList<Renderer> out) Builds text renderers for use by the player.
protected void	buildVideoRenderers(android.content.Context context, DrmSessionManager<FrameworkMediaCrypto> drmSessionManager, long allowedVideoJoiningTimeMs, android.os.Handler eventHandler, VideoRendererEventListener eventListener, int extensionRendererMode, java.util.ArrayList<Renderer> out) Builds video renderers for use by the player.
Renderer[]	createRenderers(android.os.Handler eventHandler, VideoRendererEventListener videoRendererEventListener, AudioRendererEventListener audioRendererEventListener, TextOutput textRendererOutput, MetadataOutput metadataRendererOutput) Builds the Renderer instances for a SimpleExoPlayer.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_ALLOWED_VIDEO_JOINING_TIME_MS

public static final long DEFAULT_ALLOWED_VIDEO_JOINING_TIME_MS

The default maximum duration for which a video renderer can attempt to seamlessly join an ongoing playback.

See Also:

Constant Field Values

EXTENSION_RENDERER_MODE_OFF

public static final int EXTENSION_RENDERER_MODE_OFF

Do not allow use of extension renderers.

See Also:

Constant Field Values

EXTENSION_RENDERER_MODE_ON

public static final int EXTENSION_RENDERER_MODE_ON

Allow use of extension renderers. Extension renderers are indexed after core renderers of the same type. A TrackSelector that prefers the first suitable renderer will therefore prefer to use a core renderer to an extension renderer in the case that both are able to play a given track.

See Also:

Constant Field Values

EXTENSION_RENDERER_MODE_PREFER

public static final int EXTENSION_RENDERER_MODE_PREFER

Allow use of extension renderers. Extension renderers are indexed before core renderers of the same type. A TrackSelector that prefers the first suitable renderer will therefore prefer to use an extension renderer to a core renderer in the case that both are able to play a given track.

See Also:

Constant Field Values

MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY

protected static final int MAX_DROPPED_VIDEO_FRAME_COUNT_TO_NOTIFY

See Also:

Constant Field Values

Constructor Detail

DefaultRenderersFactory

public DefaultRenderersFactory(android.content.Context context)

Parameters:

context - A Context.

DefaultRenderersFactory

public DefaultRenderersFactory(android.content.Context context,
                               @Nullable
                               DrmSessionManager<FrameworkMediaCrypto> drmSessionManager)

Parameters:

context - A Context.

drmSessionManager - An optional DrmSessionManager. May be null if DRM protected playbacks are not required.

DefaultRenderersFactory

public DefaultRenderersFactory(android.content.Context context,
                               @Nullable
                               DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                               int extensionRendererMode)

Parameters:

context - A Context.

drmSessionManager - An optional DrmSessionManager. May be null if DRM protected playbacks are not required.

extensionRendererMode - The extension renderer mode, which determines if and how available extension renderers are used. Note that extensions must be included in the application build for them to be considered available.

DefaultRenderersFactory

public DefaultRenderersFactory(android.content.Context context,
                               @Nullable
                               DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                               int extensionRendererMode,
                               long allowedVideoJoiningTimeMs)

Parameters:

context - A Context.

drmSessionManager - An optional DrmSessionManager. May be null if DRM protected playbacks are not required.

extensionRendererMode - The extension renderer mode, which determines if and how available extension renderers are used. Note that extensions must be included in the application build for them to be considered available.

allowedVideoJoiningTimeMs - The maximum duration for which video renderers can attempt to seamlessly join an ongoing playback.

Method Detail

createRenderers

public Renderer[] createRenderers(android.os.Handler eventHandler,
                                  VideoRendererEventListener videoRendererEventListener,
                                  AudioRendererEventListener audioRendererEventListener,
                                  TextOutput textRendererOutput,
                                  MetadataOutput metadataRendererOutput)

Description copied from interface: RenderersFactory

Builds the Renderer instances for a SimpleExoPlayer.

Specified by:

createRenderers in interface RenderersFactory

Parameters:

eventHandler - A handler to use when invoking event listeners and outputs.

videoRendererEventListener - An event listener for video renderers.

audioRendererEventListener - An event listener for audio renderers.

textRendererOutput - An output for text renderers.

metadataRendererOutput - An output for metadata renderers.

Returns:

The instances.

buildVideoRenderers

protected void buildVideoRenderers(android.content.Context context,
                                   @Nullable
                                   DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                                   long allowedVideoJoiningTimeMs,
                                   android.os.Handler eventHandler,
                                   VideoRendererEventListener eventListener,
                                   int extensionRendererMode,
                                   java.util.ArrayList<Renderer> out)

Builds video renderers for use by the player.

Parameters:

context - The Context associated with the player.

drmSessionManager - An optional DrmSessionManager. May be null if the player will not be used for DRM protected playbacks.

allowedVideoJoiningTimeMs - The maximum duration in milliseconds for which video renderers can attempt to seamlessly join an ongoing playback.

eventHandler - A handler associated with the main thread's looper.

eventListener - An event listener.

extensionRendererMode - The extension renderer mode.

out - An array to which the built renderers should be appended.

buildAudioRenderers

protected void buildAudioRenderers(android.content.Context context,
                                   @Nullable
                                   DrmSessionManager<FrameworkMediaCrypto> drmSessionManager,
                                   AudioProcessor[] audioProcessors,
                                   android.os.Handler eventHandler,
                                   AudioRendererEventListener eventListener,
                                   int extensionRendererMode,
                                   java.util.ArrayList<Renderer> out)

Builds audio renderers for use by the player.

Parameters:

context - The Context associated with the player.

drmSessionManager - An optional DrmSessionManager. May be null if the player will not be used for DRM protected playbacks.

audioProcessors - An array of AudioProcessors that will process PCM audio buffers before output. May be empty.

eventHandler - A handler to use when invoking event listeners and outputs.

eventListener - An event listener.

extensionRendererMode - The extension renderer mode.

out - An array to which the built renderers should be appended.

buildTextRenderers

protected void buildTextRenderers(android.content.Context context,
                                  TextOutput output,
                                  android.os.Looper outputLooper,
                                  int extensionRendererMode,
                                  java.util.ArrayList<Renderer> out)

Builds text renderers for use by the player.

Parameters:

context - The Context associated with the player.

output - An output for the renderers.

outputLooper - The looper associated with the thread on which the output should be called.

extensionRendererMode - The extension renderer mode.

out - An array to which the built renderers should be appended.

buildMetadataRenderers

protected void buildMetadataRenderers(android.content.Context context,
                                      MetadataOutput output,
                                      android.os.Looper outputLooper,
                                      int extensionRendererMode,
                                      java.util.ArrayList<Renderer> out)

Builds metadata renderers for use by the player.

Parameters:

context - The Context associated with the player.

output - An output for the renderers.

outputLooper - The looper associated with the thread on which the output should be called.

extensionRendererMode - The extension renderer mode.

out - An array to which the built renderers should be appended.

buildMiscellaneousRenderers

protected void buildMiscellaneousRenderers(android.content.Context context,
                                           android.os.Handler eventHandler,
                                           int extensionRendererMode,
                                           java.util.ArrayList<Renderer> out)

Builds any miscellaneous renderers used by the player.

Parameters:

context - The Context associated with the player.

eventHandler - A handler to use when invoking event listeners and outputs.

extensionRendererMode - The extension renderer mode.

out - An array to which the built renderers should be appended.

buildAudioProcessors

protected AudioProcessor[] buildAudioProcessors()

Builds an array of AudioProcessors that will process PCM audio before output.