Constructor Detail

• Codec

  public Codec​(MediaCodec mediaCodec,
               Format configurationFormat,
               @Nullable
               Surface inputSurface)

  Creates a Codec from a configured and started MediaCodec.

  Parameters:

  mediaCodec - The configured and started MediaCodec.

  configurationFormat - See getConfigurationFormat().

  inputSurface - The input Surface if the MediaCodec receives input from a surface.

Method Detail

• getConfigurationFormat

  public Format getConfigurationFormat()

  Returns the Format used for configuring the codec.

  The configuration Format is the input Format used by the Codec.DecoderFactory or output Format used by the Codec.EncoderFactory for selecting and configuring the underlying MediaCodec.

• getInputSurface

  @Nullable
  public Surface getInputSurface()

  Returns the input Surface, or null if the input is not a surface.

• maybeDequeueInputBuffer

  @EnsuresNonNullIf(expression="#1.data",
                    result=true)
  public boolean maybeDequeueInputBuffer​(DecoderInputBuffer inputBuffer)
                                  throws TransformationException

  Dequeues a writable input buffer, if available.

  Parameters:

  inputBuffer - The buffer where the dequeued buffer data is stored.

  Returns:

  Whether an input buffer is ready to be used.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• queueInputBuffer

  public void queueInputBuffer​(DecoderInputBuffer inputBuffer)
                        throws TransformationException

  Queues an input buffer to the decoder. No buffers may be queued after an end of stream buffer has been queued.

  Parameters:

  inputBuffer - The input buffer.

  Throws:

  IllegalStateException - If called again after an end of stream buffer has been queued.

  TransformationException - If the underlying MediaCodec encounters a problem.

• signalEndOfInputStream

  public void signalEndOfInputStream()
                              throws TransformationException

  Signals end-of-stream on input to a video encoder.

  This method does not need to be called for audio/video decoders or audio encoders. For these the MediaCodec.BUFFER_FLAG_END_OF_STREAM flag should be set on the last input buffer queued.

  Throws:

  IllegalStateException - If the codec is not an encoder receiving input from a Surface.

  TransformationException - If the underlying MediaCodec encounters a problem.

• getOutputFormat

  @Nullable
  public Format getOutputFormat()
                         throws TransformationException

  Returns the current output format, if available.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• getOutputBuffer

  @Nullable
  public ByteBuffer getOutputBuffer()
                             throws TransformationException

  Returns the current output ByteBuffer, if available.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• getOutputBufferInfo

  @Nullable
  public MediaCodec.BufferInfo getOutputBufferInfo()
                                            throws TransformationException

  Returns the MediaCodec.BufferInfo associated with the current output buffer, if available.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• releaseOutputBuffer

  public void releaseOutputBuffer()
                           throws TransformationException

  Releases the current output buffer.

  This should be called after the buffer has been processed. The next output buffer will not be available until the previous has been released.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• releaseOutputBuffer

  public void releaseOutputBuffer​(boolean render)
                           throws TransformationException

  Releases the current output buffer. If the MediaCodec was configured with an output surface, setting render to true will first send the buffer to the output surface. The surface will release the buffer back to the codec once it is no longer used/displayed.

  This should be called after the buffer has been processed. The next output buffer will not be available until the previous has been released.

  Parameters:

  render - Whether the buffer needs to be sent to the output Surface.

  Throws:

  TransformationException - If the underlying MediaCodec encounters a problem.

• isEnded

  public boolean isEnded()

  Returns whether the codec output stream has ended, and no more data can be dequeued.

• release

  public void release()

  Releases the underlying codec.