MediaCodec

This indicated that the buffer marked as such contains codec initialization / codec specific data instead of media data.

This signals the end of stream, i.e. no buffers will be available after this, unless of course, flush() follows.

This indicates that the buffer marked as such contains the data for a sync frame.

If this codec is to be used as an encoder, pass this flag.

The output buffers have changed, the client must refer to the new set of output buffers returned by getOutputBuffers() from this point on.

The output format has changed, subsequent data will follow the new format. getOutputFormat() returns the new format.

If a non-negative timeout had been specified in the call to dequeueOutputBuffer(MediaCodec.BufferInfo, long) , indicates that the call timed out.

Request that the encoder produce a sync frame "soon". Provide an Integer with the value 0.

Temporarily suspend/resume encoding of input data. While suspended input data is effectively discarded instead of being fed into the encoder. This parameter really only makes sense to use with an encoder in "surface-input" mode, as the client code has no control over the input-side of the encoder in that case. The value is an Integer object containing the value 1 to suspend or the value 0 to resume.

Change a video encoder's target bitrate on the fly. The value is an Integer object containing the new bitrate in bps.

The content is scaled to the surface dimensions

The content is scaled, maintaining its aspect ratio, the whole surface area is used, content may be cropped

Configures a component.

If you know the exact name of the component you want to instantiate use this method to instantiate it. Use with caution. Likely to be used with information obtained from MediaCodecList

Instantiate a decoder supporting input data of the given mime type. The following is a partial list of defined mime types and their semantics:

• "video/x-vnd.on2.vp8" - VP8 video (i.e. video in .webm)
• "video/x-vnd.on2.vp9" - VP9 video (i.e. video in .webm)
• "video/avc" - H.264/AVC video
• "video/mp4v-es" - MPEG4 video
• "video/3gpp" - H.263 video
• "audio/3gpp" - AMR narrowband audio
• "audio/amr-wb" - AMR wideband audio
• "audio/mpeg" - MPEG1/2 audio layer III
• "audio/mp4a-latm" - AAC audio (note, this is raw AAC packets, not packaged in LATM!)
• "audio/vorbis" - vorbis audio
• "audio/g711-alaw" - G.711 alaw audio
• "audio/g711-mlaw" - G.711 ulaw audio

Instantiate an encoder supporting output data of the given mime type.

Requests a Surface to use as the input to an encoder, in place of input buffers. This may only be called after configure(MediaFormat, Surface, MediaCrypto, int) and before start() .

The application is responsible for calling release() on the Surface when done.

Returns the index of an input buffer to be filled with valid data or -1 if no such buffer is currently available. This method will return immediately if timeoutUs == 0, wait indefinitely for the availability of an input buffer if timeoutUs < 0 or wait up to "timeoutUs" microseconds if timeoutUs > 0.

Dequeue an output buffer, block at most "timeoutUs" microseconds. Returns the index of an output buffer that has been successfully decoded or one of the INFO_* constants below.

Flush both input and output ports of the component, all indices previously returned in calls to dequeueInputBuffer(long) and dequeueOutputBuffer(MediaCodec.BufferInfo, long) become invalid.

Get the codec info. If the codec was created by createDecoderByType or createEncoderByType, what component is chosen is not known beforehand, and thus the caller does not have the MediaCodecInfo.

Call this after start() returns.

Get the component name. If the codec was created by createDecoderByType or createEncoderByType, what component is chosen is not known beforehand.

Call this after start() returns and whenever dequeueOutputBuffer signals an output buffer change by returning INFO_OUTPUT_BUFFERS_CHANGED

Call this after dequeueOutputBuffer signals a format change by returning INFO_OUTPUT_FORMAT_CHANGED

After filling a range of the input buffer at the specified index submit it to the component. Many decoders require the actual compressed data stream to be preceded by "codec specific data", i.e. setup data used to initialize the codec such as PPS/SPS in the case of AVC video or code tables in the case of vorbis audio. The class MediaExtractor provides codec specific data as part of the returned track format in entries named "csd-0", "csd-1" ... These buffers should be submitted using the flag BUFFER_FLAG_CODEC_CONFIG . To indicate that this is the final piece of input data (or rather that no more input data follows unless the decoder is subsequently flushed) specify the flag BUFFER_FLAG_END_OF_STREAM .

Similar to queueInputBuffer(int, int, int, long, int) but submits a buffer that is potentially encrypted.

Make sure you call this when you're done to free up any opened component instance instead of relying on the garbage collector to do this for you at some point in the future.

If you are done with a buffer, use this call to return the buffer to the codec. If you previously specified a surface when configuring this video decoder you can optionally render the buffer.

Communicate additional parameter changes to the component instance.

If a surface has been specified in a previous call to configure(MediaFormat, Surface, MediaCrypto, int) specifies the scaling mode to use. The default is "scale to fit".

Signals end-of-stream on input. Equivalent to submitting an empty buffer with BUFFER_FLAG_END_OF_STREAM set. This may only be used with encoders receiving input from a Surface created by createInputSurface() .

After successfully configuring the component, call start. On return you can query the component for its input/output buffers.

Finish the decode/encode session, note that the codec instance remains active and ready to be start() ed again. To ensure that it is available to other client call release() and don't just rely on garbage collection to eventually do this for you.

Invoked when the garbage collector has detected that this instance is no longer reachable. The default implementation does nothing, but this method can be overridden to free resources.

Note that objects that override finalize are significantly more expensive than objects that don't. Finalizers may be run a long time after the object is no longer reachable, depending on memory pressure, so it's a bad idea to rely on them for cleanup. Note also that finalizers are run on a single VM-wide finalizer thread, so doing blocking work in a finalizer is a bad idea. A finalizer is usually only necessary for a class that has a native peer and needs to call a native method to destroy that peer. Even then, it's better to provide an explicit close method (and implement Closeable ), and insist that callers manually dispose of instances. This works well for something like files, but less well for something like a BigInteger where typical calling code would have to deal with lots of temporaries. Unfortunately, code that creates lots of temporaries is the worst kind of code from the point of view of the single finalizer thread.

If you must use finalizers, consider at least providing your own ReferenceQueue and having your own thread process that queue.

Unlike constructors, finalizers are not automatically chained. You are responsible for calling super.finalize() yourself.

Uncaught exceptions thrown by finalizers are ignored and do not terminate the finalizer thread. See Effective Java Item 7, "Avoid finalizers" for more.