com.google.android.exoplayer2.source.dash

Class PlayerEmsgHandler.PlayerTrackEmsgHandler

java.lang.Object

com.google.android.exoplayer2.source.dash.PlayerEmsgHandler.PlayerTrackEmsgHandler

All Implemented Interfaces:

com.google.android.exoplayer2.extractor.TrackOutput

Enclosing class:

PlayerEmsgHandler

public final class PlayerEmsgHandler.PlayerTrackEmsgHandler
extends java.lang.Object
implements com.google.android.exoplayer2.extractor.TrackOutput

Handles emsg messages for a specific track for the player.

Nested Class Summary

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

com.google.android.exoplayer2.extractor.TrackOutput.CryptoData

Method Summary

Modifier and Type	Method and Description
void	format(com.google.android.exoplayer2.Format format)
boolean	maybeRefreshManifestBeforeLoadingNextChunk(long presentationPositionUs) For live streaming, check if the DASH manifest is expired before the next segment start time.
boolean	maybeRefreshManifestOnLoadingError(com.google.android.exoplayer2.source.chunk.Chunk chunk) For live streaming with emsg event stream, forward seeking can seek pass the emsg messages that signals end-of-stream or Manifest expiry, which results in load error.
void	onChunkLoadCompleted(com.google.android.exoplayer2.source.chunk.Chunk chunk) Called when the a new chunk in the current media stream has been loaded.
void	release() Release this track emsg handler.
int	sampleData(com.google.android.exoplayer2.extractor.ExtractorInput input, int length, boolean allowEndOfInput)
void	sampleData(com.google.android.exoplayer2.util.ParsableByteArray data, int length)
void	sampleMetadata(long timeUs, int flags, int size, int offset, com.google.android.exoplayer2.extractor.TrackOutput.CryptoData encryptionData)

Methods inherited from class java.lang.Object

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

Method Detail

format

public void format(com.google.android.exoplayer2.Format format)

Specified by:

format in interface com.google.android.exoplayer2.extractor.TrackOutput

sampleData

public int sampleData(com.google.android.exoplayer2.extractor.ExtractorInput input,
                      int length,
                      boolean allowEndOfInput)
               throws java.io.IOException,
                      java.lang.InterruptedException

Specified by:

sampleData in interface com.google.android.exoplayer2.extractor.TrackOutput

Throws:

java.io.IOException

java.lang.InterruptedException

sampleData

public void sampleData(com.google.android.exoplayer2.util.ParsableByteArray data,
                       int length)

Specified by:

sampleData in interface com.google.android.exoplayer2.extractor.TrackOutput

sampleMetadata

public void sampleMetadata(long timeUs,
                           int flags,
                           int size,
                           int offset,
                           @Nullable
                           com.google.android.exoplayer2.extractor.TrackOutput.CryptoData encryptionData)

Specified by:

sampleMetadata in interface com.google.android.exoplayer2.extractor.TrackOutput

maybeRefreshManifestBeforeLoadingNextChunk

public boolean maybeRefreshManifestBeforeLoadingNextChunk(long presentationPositionUs)

For live streaming, check if the DASH manifest is expired before the next segment start time. If it is, the DASH media source will be notified to refresh the manifest.

Parameters:

presentationPositionUs - The next load position in presentation time.

Returns:

True if manifest refresh has been requested, false otherwise.

onChunkLoadCompleted

public void onChunkLoadCompleted(com.google.android.exoplayer2.source.chunk.Chunk chunk)

Called when the a new chunk in the current media stream has been loaded.

Parameters:

chunk - The chunk whose load has been completed.

maybeRefreshManifestOnLoadingError

public boolean maybeRefreshManifestOnLoadingError(com.google.android.exoplayer2.source.chunk.Chunk chunk)

For live streaming with emsg event stream, forward seeking can seek pass the emsg messages that signals end-of-stream or Manifest expiry, which results in load error. In this case, we should notify the Dash media source to refresh its manifest.

Parameters:

chunk - The chunk whose load encountered the error.

Returns:

True if manifest refresh has been requested, false otherwise.

release

public void release()

Release this track emsg handler. It should not be reused after this call.