Constructor Detail

• FakeSampleStream

  public FakeSampleStream​(Allocator allocator,
                          @Nullable
                          MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher,
                          DrmSessionManager drmSessionManager,
                          DrmSessionEventListener.EventDispatcher drmEventDispatcher,
                          Format initialFormat,
                          List<FakeSampleStream.FakeSampleStreamItem> fakeSampleStreamItems)

  Creates a fake sample stream which outputs the given Format followed by the provided items.

  Parameters:

  allocator - An Allocator.

  mediaSourceEventDispatcher - A MediaSourceEventListener.EventDispatcher to notify of media events.

  drmSessionManager - A DrmSessionManager for DRM interactions.

  drmEventDispatcher - A DrmSessionEventListener.EventDispatcher to notify of DRM events.

  initialFormat - The first Format to output.

  fakeSampleStreamItems - The items to output.

Method Detail

• append

  public void append​(List<FakeSampleStream.FakeSampleStreamItem> items)

  Appends FakeSampleStreamItems to the list of items that should be written to the queue.

  Note that this data is only written to the queue once writeData(long) is called.

  Parameters:

  items - The items to append.

• writeData

  public void writeData​(long startPositionUs)

  Writes all not yet written sample stream items to the sample queue starting at the given position.

  Parameters:

  startPositionUs - The start position, in microseconds.

• seekToUs

  public boolean seekToUs​(long positionUs)

  Seeks the stream to a new position using already available data in the queue.

  Parameters:

  positionUs - The new position, in microseconds.

  Returns:

  Whether seeking inside the available data was possible.

• reset

  public void reset()

  Resets the sample queue.

  A new call to writeData(long) is required to fill the queue again.

• isLoadingFinished

  public boolean isLoadingFinished()

  Returns whether data has been written to the sample queue until the end of stream signal.

• getLargestQueuedTimestampUs

  public long getLargestQueuedTimestampUs()

  Returns the timestamp of the largest queued sample in the queue, or Long.MIN_VALUE if no samples are queued.

• discardTo

  public void discardTo​(long positionUs,
                        boolean toKeyframe)

  Discards data from the queue.

  Parameters:

  positionUs - The position to discard to, in microseconds.

  toKeyframe - Whether to discard to keyframes only.

• release

  public void release()

  Release the stream and its underlying sample queue.

• isReady

  public boolean isReady()

  Description copied from interface: SampleStream
  Returns whether data is available to be read.

  Note: If the stream has ended then a buffer with the end of stream flag can always be read from SampleStream.readData(FormatHolder, DecoderInputBuffer, boolean). Hence an ended stream is always ready.

  Specified by:

  isReady in interface SampleStream

  Returns:

  Whether data is available to be read.

• maybeThrowError

  public void maybeThrowError()
                       throws IOException

  Description copied from interface: SampleStream
  Throws an error that's preventing data from being read. Does nothing if no such error exists.

  Specified by:

  maybeThrowError in interface SampleStream

  Throws:

  IOException - The underlying error.

• readData

  public int readData​(FormatHolder formatHolder,
                      DecoderInputBuffer buffer,
                      boolean formatRequired)

  Description copied from interface: SampleStream
  Attempts to read from the stream.

  If the stream has ended then C.BUFFER_FLAG_END_OF_STREAM flag is set on buffer and C.RESULT_BUFFER_READ is returned. Else if no data is available then C.RESULT_NOTHING_READ is returned. Else if the format of the media is changing or if formatRequired is set then formatHolder is populated and C.RESULT_FORMAT_READ is returned. Else buffer is populated and C.RESULT_BUFFER_READ is returned.

  Specified by:

  readData in interface SampleStream

  Parameters:

  formatHolder - A FormatHolder to populate in the case of reading a format.

  buffer - A DecoderInputBuffer to populate in the case of reading a sample or the end of the stream. If the end of the stream has been reached, the C.BUFFER_FLAG_END_OF_STREAM flag will be set on the buffer. If a flags-only buffer is passed, then no DecoderInputBuffer.data will be read and the read position of the stream will not change, but the flags of the buffer will be populated.

  formatRequired - Whether the caller requires that the format of the stream be read even if it's not changing. A sample will never be read if set to true, however it is still possible for the end of stream or nothing to be read.

  Returns:

  The status of read, one of SampleStream.ReadDataResult.

• skipData

  public int skipData​(long positionUs)

  Description copied from interface: SampleStream
  Attempts to skip to the keyframe before the specified position, or to the end of the stream if positionUs is beyond it.

  Specified by:

  skipData in interface SampleStream

  Parameters:

  positionUs - The specified time.

  Returns:

  The number of samples that were skipped.