Method Detail

• format

  public void format(Format format)

  Description copied from interface: TrackOutput
  Called when the Format of the track has been extracted from the stream.

  Specified by:

  format in interface TrackOutput

  Parameters:

  format - The extracted Format.

• sampleData

  public int sampleData(ExtractorInput input,
                        int length,
                        boolean allowEndOfInput)
                 throws IOException,
                        InterruptedException

  Description copied from interface: TrackOutput
  Called to write sample data to the output.

  Specified by:

  sampleData in interface TrackOutput

  Parameters:

  input - An ExtractorInput from which to read the sample data.

  length - The maximum length to read from the input.

  allowEndOfInput - True if encountering the end of the input having read no data is allowed, and should result in C.RESULT_END_OF_INPUT being returned. False if it should be considered an error, causing an EOFException to be thrown.

  Returns:

  The number of bytes appended.

  Throws:

  IOException - If an error occurred reading from the input.

  InterruptedException - If the thread was interrupted.

• sampleData

  public void sampleData(ParsableByteArray data,
                         int length)

  Description copied from interface: TrackOutput
  Called to write sample data to the output.

  Specified by:

  sampleData in interface TrackOutput

  Parameters:

  data - A ParsableByteArray from which to read the sample data.

  length - The number of bytes to read.

• sampleMetadata

  public void sampleMetadata(long timeUs,
                             int flags,
                             int size,
                             int offset,
                             @Nullable
                             TrackOutput.CryptoData encryptionData)

  Description copied from interface: TrackOutput
  Called when metadata associated with a sample has been extracted from the stream.

  The corresponding sample data will have already been passed to the output via calls to TrackOutput.sampleData(ExtractorInput, int, boolean) or TrackOutput.sampleData(ParsableByteArray, int).

  Specified by:

  sampleMetadata in interface TrackOutput

  Parameters:

  timeUs - The media timestamp associated with the sample, in microseconds.

  flags - Flags associated with the sample. See C.BUFFER_FLAG_*.

  size - The size of the sample data, in bytes.

  offset - The number of bytes that have been passed to TrackOutput.sampleData(ExtractorInput, int, boolean) or TrackOutput.sampleData(ParsableByteArray, int) since the last byte belonging to the sample whose metadata is being passed.

  encryptionData - The encryption data required to decrypt the sample. May be null.

• 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(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(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.