java.lang.Object
- com.google.android.exoplayer2.BaseRenderer
- - com.google.android.exoplayer2.text.TextRenderer

All Implemented Interfaces:

Handler.Callback, PlayerMessage.Target, Renderer, RendererCapabilities
```
public final class TextRenderer
extends BaseRenderer
implements Handler.Callback
```
A renderer for text.
Subtitles are decoded from sample data using SubtitleDecoder instances obtained from a SubtitleDecoderFactory. The actual rendering of the subtitle Cues is delegated to a TextOutput.

Nested Class Summary
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Renderer
  Renderer.MessageType, Renderer.State, Renderer.WakeupListener
- Nested classes/interfaces inherited from interface com.google.android.exoplayer2.RendererCapabilities
  RendererCapabilities.AdaptiveSupport, RendererCapabilities.Capabilities, RendererCapabilities.DecoderSupport, RendererCapabilities.FormatSupport, RendererCapabilities.HardwareAccelerationSupport, RendererCapabilities.TunnelingSupport

Field Summary
- Fields inherited from interface com.google.android.exoplayer2.Renderer
  MSG_CUSTOM_BASE, MSG_SET_AUDIO_ATTRIBUTES, MSG_SET_AUDIO_SESSION_ID, MSG_SET_AUX_EFFECT_INFO, MSG_SET_CAMERA_MOTION_LISTENER, MSG_SET_CHANGE_FRAME_RATE_STRATEGY, MSG_SET_SCALING_MODE, MSG_SET_SKIP_SILENCE_ENABLED, MSG_SET_VIDEO_FRAME_METADATA_LISTENER, MSG_SET_VIDEO_OUTPUT, MSG_SET_VOLUME, MSG_SET_WAKEUP_LISTENER, STATE_DISABLED, STATE_ENABLED, STATE_STARTED
- Fields inherited from interface com.google.android.exoplayer2.RendererCapabilities
  ADAPTIVE_NOT_SEAMLESS, ADAPTIVE_NOT_SUPPORTED, ADAPTIVE_SEAMLESS, ADAPTIVE_SUPPORT_MASK, DECODER_SUPPORT_FALLBACK, DECODER_SUPPORT_PRIMARY, FORMAT_EXCEEDS_CAPABILITIES, FORMAT_HANDLED, FORMAT_SUPPORT_MASK, FORMAT_UNSUPPORTED_DRM, FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE, HARDWARE_ACCELERATION_NOT_SUPPORTED, HARDWARE_ACCELERATION_SUPPORT_MASK, HARDWARE_ACCELERATION_SUPPORTED, MODE_SUPPORT_MASK, TUNNELING_NOT_SUPPORTED, TUNNELING_SUPPORT_MASK, TUNNELING_SUPPORTED

Constructor Summary

Constructors
Constructor	Description
`TextRenderer(TextOutput output, Looper outputLooper)`
`TextRenderer(TextOutput output, Looper outputLooper, SubtitleDecoderFactory decoderFactory)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`String`	`getName()`	Returns the name of this renderer, for logging and debugging purposes.
`boolean`	`handleMessage(Message msg)`
`boolean`	`isEnded()`	Whether the renderer is ready for the `ExoPlayer` instance to transition to `Player.STATE_ENDED`.
`boolean`	`isReady()`	Whether the renderer is able to immediately render media from the current position.
`protected void`	`onDisabled()`	Called when the renderer is disabled.
`protected void`	`onPositionReset(long positionUs, boolean joining)`	Called when the position is reset.
`protected void`	`onStreamChanged(Format[] formats, long startPositionUs, long offsetUs)`	Called when the renderer's stream has changed.
`void`	`render(long positionUs, long elapsedRealtimeUs)`	Incrementally renders the `SampleStream`.
`void`	`setFinalStreamEndPositionUs(long streamEndPositionUs)`	Sets the position at which to stop rendering the current stream.
`@com.google.android.exoplayer2.RendererCapabilities.Capabilities int`	`supportsFormat(Format format)`	Returns the extent to which the `Renderer` supports a given format.

Methods inherited from class com.google.android.exoplayer2.BaseRenderer
createRendererException, createRendererException, disable, enable, getCapabilities, getConfiguration, getFormatHolder, getIndex, getLastResetPositionUs, getMediaClock, getPlayerId, getReadingPositionUs, getState, getStream, getStreamFormats, getTrackType, handleMessage, hasReadStreamToEnd, init, isCurrentStreamFinal, isSourceReady, maybeThrowStreamError, onEnabled, onReset, onStarted, onStopped, readSource, replaceStream, reset, resetPosition, setCurrentStreamFinal, skipSource, start, stop, supportsMixedMimeTypeAdaptation

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.google.android.exoplayer2.Renderer
setPlaybackSpeed

- Constructor Detail
  - TextRenderer
```
public TextRenderer(TextOutput output,
                    @Nullable
                    Looper outputLooper)
```
    Parameters:
    
    output - The output.
    
    outputLooper - The looper associated with the thread on which the output should be called. If the output makes use of standard Android UI components, then this should normally be the looper associated with the application's main thread, which can be obtained using ContextWrapper.getMainLooper(). Null may be passed if the output should be called directly on the player's internal rendering thread.
  - TextRenderer
```
public TextRenderer(TextOutput output,
                    @Nullable
                    Looper outputLooper,
                    SubtitleDecoderFactory decoderFactory)
```
    Parameters:
    
    output - The output.
    
    outputLooper - The looper associated with the thread on which the output should be called. If the output makes use of standard Android UI components, then this should normally be the looper associated with the application's main thread, which can be obtained using ContextWrapper.getMainLooper(). Null may be passed if the output should be called directly on the player's internal rendering thread.
    
    decoderFactory - A factory from which to obtain SubtitleDecoder instances.
- Method Detail
  - getName
```
public String getName()
```
    Description copied from interface: Renderer
    
    Returns the name of this renderer, for logging and debugging purposes. Should typically be the renderer's (un-obfuscated) class name.
    
    Specified by:
    
    getName in interface Renderer
    
    Specified by:
    
    getName in interface RendererCapabilities
    
    Returns:
    
    The name of this renderer.
  - supportsFormat
```
public @com.google.android.exoplayer2.RendererCapabilities.Capabilities int supportsFormat(Format format)
```
    Description copied from interface: RendererCapabilities
    
    Returns the extent to which the Renderer supports a given format.
    
    Specified by:
    
    supportsFormat in interface RendererCapabilities
    
    Parameters:
    
    format - The format.
    
    Returns:
    
    The RendererCapabilities.Capabilities for this format.
  - setFinalStreamEndPositionUs
```
public void setFinalStreamEndPositionUs(long streamEndPositionUs)
```
    Sets the position at which to stop rendering the current stream.
    Must be called after BaseRenderer.setCurrentStreamFinal().
    
    Parameters:
    
    streamEndPositionUs - The position to stop rendering at or C.LENGTH_UNSET to render until the end of the current stream.
  - onStreamChanged
```
protected void onStreamChanged(Format[] formats,
                               long startPositionUs,
                               long offsetUs)
```
    Description copied from class: BaseRenderer
    
    Called when the renderer's stream has changed. This occurs when the renderer is enabled after BaseRenderer.onEnabled(boolean, boolean) has been called, and also when the stream has been replaced whilst the renderer is enabled or started.
    The default implementation is a no-op.
    
    Overrides:
    
    onStreamChanged in class BaseRenderer
    
    Parameters:
    
    formats - The enabled formats.
    
    startPositionUs - The start position of the new stream in renderer time (microseconds).
    
    offsetUs - The offset that will be added to the timestamps of buffers read via BaseRenderer.readSource(com.google.android.exoplayer2.FormatHolder, com.google.android.exoplayer2.decoder.DecoderInputBuffer, @com.google.android.exoplayer2.source.SampleStream.ReadFlags int) so that decoder input buffers have monotonically increasing timestamps.
  - onPositionReset
```
protected void onPositionReset(long positionUs,
                               boolean joining)
```
    Description copied from class: BaseRenderer
    
    Called when the position is reset. This occurs when the renderer is enabled after BaseRenderer.onStreamChanged(Format[], long, long) has been called, and also when a position discontinuity is encountered.
    After a position reset, the renderer's SampleStream is guaranteed to provide samples starting from a key frame.
    The default implementation is a no-op.
    
    Overrides:
    
    onPositionReset in class BaseRenderer
    
    Parameters:
    
    positionUs - The new playback position in microseconds.
    
    joining - Whether this renderer is being enabled to join an ongoing playback.
  - render
```
public void render(long positionUs,
                   long elapsedRealtimeUs)
```
    Description copied from interface: Renderer
    
    Incrementally renders the SampleStream.
    If the renderer is in the Renderer.STATE_ENABLED state then each call to this method will do work toward being ready to render the SampleStream when the renderer is started. If the renderer is in the Renderer.STATE_STARTED state then calls to this method will render the SampleStream in sync with the specified media positions.
    The renderer may also render the very start of the media at the current position (e.g. the first frame of a video stream) while still in the Renderer.STATE_ENABLED state, unless it's the initial start of the media after calling Renderer.enable(RendererConfiguration, Format[], SampleStream, long, boolean, boolean, long, long) with mayRenderStartOfStream set to false.
    This method should return quickly, and should not block if the renderer is unable to make useful progress.
    This method may be called when the renderer is in the following states: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
    
    Specified by:
    
    render in interface Renderer
    
    Parameters:
    
    positionUs - The current media time in microseconds, measured at the start of the current iteration of the rendering loop.
    
    elapsedRealtimeUs - SystemClock.elapsedRealtime() in microseconds, measured at the start of the current iteration of the rendering loop.
  - onDisabled
```
protected void onDisabled()
```
    Description copied from class: BaseRenderer
    
    Called when the renderer is disabled.
    The default implementation is a no-op.
    
    Overrides:
    
    onDisabled in class BaseRenderer
  - isEnded
```
public boolean isEnded()
```
    Description copied from interface: Renderer
    
    Whether the renderer is ready for the ExoPlayer instance to transition to Player.STATE_ENDED. The player will make this transition as soon as true is returned by all of its renderers.
    This method may be called when the renderer is in the following states: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
    
    Specified by:
    
    isEnded in interface Renderer
    
    Returns:
    
    Whether the renderer is ready for the player to transition to the ended state.
  - isReady
```
public boolean isReady()
```
    Description copied from interface: Renderer
    
    Whether the renderer is able to immediately render media from the current position.
    If the renderer is in the Renderer.STATE_STARTED state then returning true indicates that the renderer has everything that it needs to continue playback. Returning false indicates that the player should pause until the renderer is ready.
    If the renderer is in the Renderer.STATE_ENABLED state then returning true indicates that the renderer is ready for playback to be started. Returning false indicates that it is not.
    This method may be called when the renderer is in the following states: Renderer.STATE_ENABLED, Renderer.STATE_STARTED.
    
    Specified by:
    
    isReady in interface Renderer
    
    Returns:
    
    Whether the renderer is ready to render media.
  - handleMessage
```
public boolean handleMessage(Message msg)
```
    Specified by:
    
    handleMessage in interface Handler.Callback

Class TextRenderer

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.Renderer

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.RendererCapabilities

Field Summary

Fields inherited from interface com.google.android.exoplayer2.Renderer

Fields inherited from interface com.google.android.exoplayer2.RendererCapabilities

Constructor Summary

Method Summary

Methods inherited from class com.google.android.exoplayer2.BaseRenderer

Methods inherited from class java.lang.Object

Methods inherited from interface com.google.android.exoplayer2.Renderer

Constructor Detail

TextRenderer

TextRenderer

Method Detail

getName

supportsFormat

setFinalStreamEndPositionUs

onStreamChanged

onPositionReset

render

onDisabled

isEnded

isReady

handleMessage