Functions
int	mediacodec_create (mediacodec_h *mediacodec)
	Creates a mediacodec handle for decoding/encoding.
int	mediacodec_destroy (mediacodec_h mediacodec)
	Destroys the mediacodec handle and releases all its resources.
int	mediacodec_set_codec (mediacodec_h mediacodec, mediacodec_codec_type_e codec_type, mediacodec_support_type_e flags)
	Sets the codec type and decoder/encoder.
int	mediacodec_set_vdec_info (mediacodec_h mediacodec, int width, int height)
	Sets the default info for the video decoder.
int	mediacodec_set_venc_info (mediacodec_h mediacodec, int width, int height, int fps, int target_bits)
	Sets the default info for the video encoder.
int	mediacodec_set_adec_info (mediacodec_h mediacodec, int samplerate, int channel, int bit)
	Sets the default info for the audio decoder.
int	mediacodec_set_aenc_info (mediacodec_h mediacodec, int samplerate, int channel, int bit, int bitrate)
	Sets the default info for the audio encdoer.
int	mediacodec_prepare (mediacodec_h mediacodec)
	Prepares mediacodec for encoding/decoding.
int	mediacodec_unprepare (mediacodec_h mediacodec)
	Unprepares mediacodec for encoding/decoding.
int	mediacodec_process_input (mediacodec_h mediacodec, media_packet_h inbuf, uint64_t timeOutUs)
	Decodes/Encodes a packet. The function passed undecoded/unencoded packet to the input queue and decode/encode a frame sequentially.
int	mediacodec_get_output (mediacodec_h mediacodec, media_packet_h *outbuf, uint64_t timeOutUs)
	Gets the decoded or encoded packet from the output queue.
int	mediacodec_flush_buffers (mediacodec_h mediacodec)
	Flushes both input and output buffers.
int	mediacodec_set_input_buffer_used_cb (mediacodec_h mediacodec, mediacodec_input_buffer_used_cb callback, void *user_data)
	set empty buffer callback the media codec for process, asynchronously.
int	mediacodec_unset_input_buffer_used_cb (mediacodec_h mediacodec)
	unset input buffer used callback the media codec for process, asynchronously.
int	mediacodec_set_output_buffer_available_cb (mediacodec_h mediacodec, mediacodec_output_buffer_available_cb callback, void *user_data)
	set output buffer available callback the media codec for process, asynchronously.
int	mediacodec_unset_output_buffer_available_cb (mediacodec_h mediacodec)
	unset output buffer available callback the media codec for process, asynchronously.
int	mediacodec_set_error_cb (mediacodec_h mediacodec, mediacodec_error_cb callback, void *user_data)
	set error callback the media codec for process, asynchronously.
int	mediacodec_unset_error_cb (mediacodec_h mediacodec)
	unset error callback the media codec for process, asynchronously.
int	mediacodec_set_eos_cb (mediacodec_h mediacodec, mediacodec_eos_cb callback, void *user_data)
	set eos callback the media codec for process, asynchronously.
int	mediacodec_unset_eos_cb (mediacodec_h mediacodec)
	unset eos callback the media codec for process, asynchronously.
int	mediacodec_set_buffer_status_cb (mediacodec_h mediacodec, mediacodec_buffer_status_cb callback, void *user_data)
	Registers a callback function to be invoked when the mediacodec needs more data or has enough data.
int	mediacodec_unset_buffer_status_cb (mediacodec_h mediacodec)
	Unregisters the callback function.
int	mediacodec_foreach_supported_codec (mediacodec_h mediacodec, mediacodec_supported_codec_cb callback, void *user_data)
	Retrieves all supported codecs by invoking callback function once for each supported codecs.
int	mediacodec_get_supported_type (mediacodec_h mediacodec, mediacodec_codec_type_e codec_type, bool encoder, int *support_type)
	Verifies whether encoding can be performed with codec_type or not.
Typedefs
typedef struct mediacodec_s *	mediacodec_h
	Media Codec type handle.
typedef void(*	mediacodec_input_buffer_used_cb )(media_packet_h pkt, void *user_data)
	Called when the input buffer(pkt) used up.
typedef void(*	mediacodec_output_buffer_available_cb )(media_packet_h pkt, void *user_data)
	Called when the output buffer is available.
typedef void(*	mediacodec_error_cb )(mediacodec_error_e error, void *user_data)
	Called when the error has occured.
typedef void(*	mediacodec_eos_cb )(void *user_data)
	Called when there is no data to decode/encode.
typedef void(*	mediacodec_buffer_status_cb )(mediacodec_status_e status, void *user_data)
	Called when the mediacodec needs more data or has enough data.
typedef bool(*	mediacodec_supported_codec_cb )(mediacodec_codec_type_e codec_type, void *user_data)
	Called once for each supported codec types.

The Media Codec APIs provides functions for encodinging and decoding using media data.

Required Header

#include <media_codec.h>

Overview

MEDIA CODEC API allows : The API allows you to direct access to the media codec on device. It operates on "raw" data, so any file headers must be stripped off. media_packet is used for zero-copy.

Typedef Documentation

typedef void(* mediacodec_buffer_status_cb)(mediacodec_status_e status, void *user_data)

Called when the mediacodec needs more data or has enough data.

Since :: 2.4

It is recommended that the application stops calling mediacodec_process_input() when MEDIACODEC_ENOUGH_DATA is invoked.

Parameters:

[in] user_data The user data passed from the callback registration function

See also:: mediacodec_set_buffer_status_cb(); mediacodec_unset_buffer_status_cb()

typedef void(* mediacodec_eos_cb)(void *user_data)

Called when there is no data to decode/encode.

Since :: 2.3

It will be invoked when the end-of-stream is reached.

Parameters:

[in] user_data The user data passed from the callback registration function

Precondition:: It will be invoked when the eos event generate if you register this callback using mediacodec_set_eos_cb().

See also:: mediacodec_set_eos_cb(); mediacodec_unset_eos_cb()

typedef void(* mediacodec_error_cb)(mediacodec_error_e error, void *user_data)

Called when the error has occured.

Since :: 2.3

It will be invoked when the error has occured.

Parameters:

[in]	error_code	The error code
[in]	user_data	The user data passed from the callback registration function

Precondition:: It will be invoked when the error has occured if you register this callback using mediacodec_set_error_cb().

See also:: mediacodec_set_error_cb(); mediacodec_unset_error_cb()

typedef struct mediacodec_s* mediacodec_h

Media Codec type handle.

Since :: 2.3

typedef void(* mediacodec_input_buffer_used_cb)(media_packet_h pkt, void *user_data)

Called when the input buffer(pkt) used up.

Since :: 2.3

It will be invoked when mediacodec has used input buffer.

Parameters:

[in]	pkt	The media packet handle
[in]	user_data	The user data passed from the callback registration function

Precondition:: It will be invoked when input buffer process completed if you register this callback using mediacodec_set_input_buffer_used_cb().

See also:: mediacodec_set_input_buffer_used_cb(); mediacodec_unset_input_buffer_used_cb()

typedef void(* mediacodec_output_buffer_available_cb)(media_packet_h pkt, void *user_data)

Called when the output buffer is available.

Since :: 2.3

It will be invoked when mediacodec has output buffer.

Parameters:

[in]	pkt	The media packet handle
[in]	user_data	The user data passed from the callback registration function

Precondition:: It will be invoked when mediacodec process completed(had output buffer) if you register this callback using mediacodec_set_fill_buffer_cb().

See also:: mediacodec_set_output_buffer_available_cb(); mediacodec_unset_output_buffer_available_cb()

typedef bool(* mediacodec_supported_codec_cb)(mediacodec_codec_type_e codec_type, void *user_data)

Called once for each supported codec types.

Since :: 2.4

Parameters:

[in]	codec_type	The codec type
[in]	user_data	The user data passed from the foreach function

Returns:: true to continue with the next iteration of the loop, false to break out of the loop.

Precondition:: mediacodec_foreach_supported_codec() will invoke this callback.

See also:: mediacodec_foreach_supported_codec()

Enumeration Type Documentation

enum mediacodec_codec_type_e

Enumerations of media codec type.

Since :: 2.3

Enumerator:

MEDIACODEC_NONE	NONE
MEDIACODEC_L16	L16
MEDIACODEC_ALAW	ALAW
MEDIACODEC_ULAW	ULAW
MEDIACODEC_AMR	MEDIACDEC_AMR indicates AMR-NB (Since 2.4)
MEDIACODEC_AMR_NB	AMR-NB (Since 2.4)
MEDIACODEC_AMR_WB	AMR-WB (Since 2.4)
MEDIACODEC_G729	G729
MEDIACODEC_AAC	MEDIACDEC_AAC indicates AAC-LC (Since 2.4)
MEDIACODEC_AAC_LC	AAC-LC (Since 2.4)
MEDIACODEC_AAC_HE	HE-AAC (Since 2.4)
MEDIACODEC_AAC_HE_PS	HE-AAC-PS (Since 2.4)
MEDIACODEC_MP3	MP3
MEDIACODEC_VORBIS	VORBIS (Since 2.4)
MEDIACODEC_FLAC	FLAC (Since 2.4)
MEDIACODEC_WMAV1	WMA version 1 (Since 2.4)
MEDIACODEC_WMAV2	WMA version 2 (Since 2.4)
MEDIACODEC_WMAPRO	WMA Professional (Since 2.4)
MEDIACODEC_WMALSL	WMA Lossless (Since 2.4)
MEDIACODEC_H261	H.261
MEDIACODEC_H263	H.263
MEDIACODEC_H264	H.264
MEDIACODEC_MJPEG	MJPEG
MEDIACODEC_MPEG1	MPEG1
MEDIACODEC_MPEG2	MPEG2
MEDIACODEC_MPEG4	MPEG4
MEDIACODEC_HEVC	HEVC (Since 2.4)
MEDIACODEC_VP8	VP8 (Since 2.4)
MEDIACODEC_VP9	VP9 (Since 2.4)
MEDIACODEC_VC1	VC1 (Since 2.4)

enum mediacodec_error_e

Enumeration of media codec error.

Since :: 2.3

Enumerator:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation
MEDIACODEC_ERROR_NOT_SUPPORTED_ON_DEVICE	Not supported
MEDIACODEC_ERROR_PERMISSION_DENIED	Permission denied
MEDIACODEC_ERROR_INVALID_STATE	Invalid state
MEDIACODEC_ERROR_INVALID_INBUFFER	Invalid input buffer
MEDIACODEC_ERROR_INVALID_OUTBUFFER	Invalid output buffer
MEDIACODEC_ERROR_INTERNAL	Internal error
MEDIACODEC_ERROR_NOT_INITIALIZED	Not initialized mediacodec
MEDIACODEC_ERROR_INVALID_STREAM	Invalid stream
MEDIACODEC_ERROR_CODEC_NOT_FOUND	Not supported format
MEDIACODEC_ERROR_DECODE	Error while decoding data
MEDIACODEC_ERROR_NO_FREE_SPACE	Out of storage
MEDIACODEC_ERROR_STREAM_NOT_FOUND	Cannot find stream
MEDIACODEC_ERROR_NOT_SUPPORTED_FORMAT	Not supported format
MEDIACODEC_ERROR_BUFFER_NOT_AVAILABLE	Not available buffer
MEDIACODEC_ERROR_OVERFLOW_INBUFFER	Overflow input buffer (Since 2.4)
MEDIACODEC_ERROR_RESOURCE_OVERLOADED	Exceed the instance limits (Since 2.4)

enum mediacodec_status_e

Enumeration of buffer status.

Since :: 2.4

enum mediacodec_support_type_e

Enumeration of media codec support type.

Since :: 2.3

Remarks:: If this codec is to be used as an encoder or decoder, the codec flag must be set to MEDIACODEC_ENCODER or MEDIACODEC_DECODER. If user doesn't set optional flag, default flags will be set to MEDIACODEC_SUPPORT_TYPE_SW.

Enumerator:

MEDIACODEC_ENCODER	This flag is for using the encoder
MEDIACODEC_DECODER	This flag is for using the decoder
MEDIACODEC_SUPPORT_TYPE_HW	This is an optional flag for using the h/w codec
MEDIACODEC_SUPPORT_TYPE_SW	This is an optional flag for using the s/w codec

Function Documentation

int mediacodec_create ( mediacodec_h * mediacodec )

Creates a mediacodec handle for decoding/encoding.

Since :: 2.3

Remarks:: you must release mediacodec using mediacodec_destroy().
Although you can create multiple mediacodec handles at the same time, the mediacodec cannot guarantee proper operation because of limited resources, like audio or display device.

Parameters:

[out] mediacodec A new handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation

int mediacodec_destroy ( mediacodec_h mediacodec )

Destroys the mediacodec handle and releases all its resources.

Since :: 2.3

Remarks:: To completely shutdown the mediacodec operation, call this function with a valid player handle from any mediacodec

Parameters:

[in] mediacodec The handle to mediacodec to be destroyed.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec);

int mediacodec_flush_buffers ( mediacodec_h mediacodec )

Flushes both input and output buffers.

Since :: 2.4

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE Successful

MEDIACODEC_ERROR_INVALID_PARAMETER

Invalid parameter

 #include <media_codec.h>
 mediacodec_h mediacodec;
 media_packet_h pkt;
 media_packet_h out_pkt;

 mediacodec_create(&mediacodec);
 mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER | MEDIACODEC_SUPPORT_TYPE_HW);
 mediacodec_prepare(mediacodec);
 mediacodec_process_input(pkt);
 mediacodec_flush_buffers(mediacodec);

int mediacodec_foreach_supported_codec	(	mediacodec_h	mediacodec,
		mediacodec_supported_codec_cb	callback,
		void *	user_data
	)

Retrieves all supported codecs by invoking callback function once for each supported codecs.

Since :: 2.4

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mediacodec_foreach_supported_codec()

int mediacodec_get_output	(	mediacodec_h	mediacodec,
		media_packet_h *	outbuf,
		uint64_t	timeOutUs
	)

Gets the decoded or encoded packet from the output queue.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[out]	outbuf	The current output of the decoder/encoder. this function passed decoded/encoded frame to output queue.
[in]	timeOutUs	The timeout in microseconds. The input buffer wait up to "timeOutUs" microseconds.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; media_packet_h pkt; media_packet_h out_pkt; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER \| MEDIACODEC_SUPPORT_TYPE_HW); mediacodec_prepare(mediacodec); mediacodec_process_input(pkt); mediacodec_get_output(mediacodec, &out_pkt, 1000);

int mediacodec_get_supported_type	(	mediacodec_h	mediacodec,
		mediacodec_codec_type_e	codec_type,
		bool	encoder,
		int *	support_type
	)

Verifies whether encoding can be performed with codec_type or not.

Since :: 2.4

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	codec_type	The identifier of the codec type of the encoder.
[in]	encoder	Whether the encoder or decoder : (`true` = encoder, `false` = decoder).
[out]	support_type	(`MEDIACODEC_SUPPORT_TYPE_HW` = mediacodec can be performed with hardware codec, `MEDIACODEC_SUPPORT_TYPE_SW` = mediacodec can be performed with software codec)

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE Successful

MEDIACODEC_ERROR_INVALID_PARAMETER

Invalid parameter

 #include <media_codec.h>
 mediacodec_h mediacodec;
 mediacodec_support_type_e type;
 mediacodec_codec_type_e codec_type = MEDIACODEC_H264;

 mediacodec_create(&mediacodec);
 mediacodec_get_supported_type(mediacodec, codec_type, 1, &type);

 if(type == MEDIACODEC_SUPPORT_TYPE_HW)
     // only h/w supported
 else if (type == MEDIACODEC_SUPPORT_TYPE_SW)
     // only s/w supported
 else if (type == (MEDIACODEC_SUPPORT_TYPE_HW|MEDIACODEC_SUPPORT_TYPE_SW)
     // both supported

 mediacodec_set_codec(mediacodec, codec_type, MEDIACODEC_ENCODER | MEDIACODEC_SUPPORT_TYPE_HW);

int mediacodec_prepare ( mediacodec_h mediacodec )

Prepares mediacodec for encoding/decoding.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation

Precondition:

The mediacodec should call mediacodec_set_codec()and mediacodec_set_vdec_info()/mediacodec_set_venc_info() before calling mediacodec_prepare() If the decoder is set by mediacodec_set_codec(), mediacodec_set_vdec_info() should be called. If the encoder is set by mediacodec_set_codec(), mediacodec_set_venc_info() should be called.

 #include <media_codec.h>
 mediacodec_h mediacodec;

 mediacodec_create(&mediacodec);
 mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER | MEDIACODEC_SUPPORT_TYPE_HW);
 mediacodec_prepare(mediacodec);

int mediacodec_process_input	(	mediacodec_h	mediacodec,
		media_packet_h	inbuf,
		uint64_t	timeOutUs
	)

Decodes/Encodes a packet. The function passed undecoded/unencoded packet to the input queue and decode/encode a frame sequentially.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	inbuf	The current input format for the decoder/encoder
[in]	timeOutUs	The timeout in microseconds. The input buffer wait up to "timeOutUs" microseconds.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation
MEDIACODEC_ERROR_OVERFLOW_INBUFFER	Overflow inputbuffer #include <media_codec.h> mediacodec_h mediacodec; media_packet_h pkt; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER \| MEDIACODEC_SUPPORT_TYPE_HW); mediacodec_prepare(mediacodec); mediacodec_process_input(pkt);

int mediacodec_set_adec_info	(	mediacodec_h	mediacodec,
		int	samplerate,
		int	channel,
		int	bit
	)

Sets the default info for the audio decoder.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	samplerate	The samplerate for audio decoding.
[in]	channel	The channels for audio decoding.
[in]	bit	The bits resolution for audio decoding.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_AAC, MEDIACODEC_DECODER \| MEDIACODEC_SUPPORT_TYPE_SW); mediacodec_set_adec_info(mediacodec, 44100, 2, 16);

int mediacodec_set_aenc_info	(	mediacodec_h	mediacodec,
		int	samplerate,
		int	channel,
		int	bit,
		int	bitrate
	)

Sets the default info for the audio encdoer.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	samplerate	The samplerate for audio encoding.
[in]	channel	The channels for audio encoding.
[in]	bit	The bits resolution for audio encoding.
[in]	bitrate	The bitrate for audio encoding.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_AAC, MEDIACODEC_ENCODER \| MEDIACODEC_SUPPORT_TYPE_SW); mediacodec_set_aenc_info(mediacodec, 44100, 2, 16, 128);

int mediacodec_set_buffer_status_cb	(	mediacodec_h	mediacodec,
		mediacodec_buffer_status_cb	callback,
		void *	user_data
	)

Registers a callback function to be invoked when the mediacodec needs more data or has enough data.

Since :: 2.4

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: mediacodec_set_buffer_status_cb should be called before mediacodec_preare().

Postcondition:: mediacodec_buffer_status_cb will be invoked.

See also:: mediacodec_set_buffer_status_cb(); mediacodec_unset_buffer_status_cb()

int mediacodec_set_codec	(	mediacodec_h	mediacodec,
		mediacodec_codec_type_e	codec_type,
		mediacodec_support_type_e	flags
	)

Sets the codec type and decoder/encoder.

Since :: 2.3

Remarks:: If this codec is to be used as a decoder, pass the MEDIACODEC_DECODER flag. If this codec is to be used as an encoder, pass the MEDIACODEC_ENCODER flag. By default, It is used software default setting. If user want software setting, pass the MEDIACODEC_SUPPORT_TYPE_SW flags.

Parameters:

[in]	mediacodec	The handle of mediacodec
[in]	codec_type	The identifier of the codec type of the decoder/encoder
[in]	flags	The encoding/decoding scheme.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation
MEDIACODEC_ERROR_CODEC_NOT_FOUND	Codec not found #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_destroy(mediacodec);

int mediacodec_set_eos_cb	(	mediacodec_h	mediacodec,
		mediacodec_eos_cb	callback,
		void *	user_data
	)

set eos callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: mediacodec_set_eos_cb should be called before mediacodec_preare().

Postcondition:: mediacodec_eos_cb will be invoked.

See also:: mediacodec_set_eos_cb(); mediacodec_unset_eos_cb()

int mediacodec_set_error_cb	(	mediacodec_h	mediacodec,
		mediacodec_error_cb	callback,
		void *	user_data
	)

set error callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: mediacodec_set_error_cb should be called before mediacodec_preare().

Postcondition:: mediacodec_error_cb will be invoked.

See also:: mediacodec_set_error_cb(); mediacodec_unset_error_cb()

int mediacodec_set_input_buffer_used_cb	(	mediacodec_h	mediacodec,
		mediacodec_input_buffer_used_cb	callback,
		void *	user_data
	)

set empty buffer callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: mediacodec_set_input_buffer_used_cb should be called before mediacodec_preare().

Postcondition:: mediacodec_input_buffer_used_cb will be invoked.

See also:: mediacodec_set_input_buffer_used_cb(); mediacodec_unset_input_buffer_used_cb()

int mediacodec_set_output_buffer_available_cb	(	mediacodec_h	mediacodec,
		mediacodec_output_buffer_available_cb	callback,
		void *	user_data
	)

set output buffer available callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

Precondition:: mediacodec_set_output_buffer_available_cb should be called before mediacodec_preare().

Postcondition:: mediacodec_output_buffer_available_cb will be invoked.

See also:: mediacodec_set_output_buffer_available_cb(); mediacodec_unset_output_buffer_available_cb()

int mediacodec_set_vdec_info	(	mediacodec_h	mediacodec,
		int	width,
		int	height
	)

Sets the default info for the video decoder.

Since :: 2.3

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	width	The width for video decoding.
[in]	height	The height for video decoding.

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER \| MEDIACODEC_SUPPORT_TYPE_HW);

int mediacodec_set_venc_info	(	mediacodec_h	mediacodec,
		int	width,
		int	height,
		int	fps,
		int	target_bits
	)

Sets the default info for the video encoder.

Since :: 2.3

Remarks:: The frame rate is the speed of recording and the speed of playback. If user wants the default setting for ratecontrol, set target_bits to 0.

Parameters:

[in]	mediacodec	The handle to mediacodec
[in]	width	The width for video encoding.
[in]	height	The height for video encoding.
[in]	fps	The frame rate in frames per second.
[in]	target_bits	The target bitrates in bits per second.(a unit of kbit)

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_ENCODER \| MEDIACODEC_SUPPORT_TYPE_HW); mediacodec_set_venc_info(mediacodec, 640, 480, 30, 1000);

int mediacodec_unprepare ( mediacodec_h mediacodec )

Unprepares mediacodec for encoding/decoding.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter
MEDIACODEC_ERROR_OUT_OF_MEMORY	Out of memory
MEDIACODEC_ERROR_INVALID_OPERATION	Invalid operation #include <media_codec.h> mediacodec_h mediacodec; mediacodec_create(&mediacodec); mediacodec_set_codec(mediacodec, MEDIACODEC_H264, MEDIACODEC_DECODER \| MEDIACODEC_SUPPORT_TYPE_HW); mediacodec_prepare(mediacodec); mediacodec_unprepare(mediacodec);

int mediacodec_unset_buffer_status_cb ( mediacodec_h mediacodec )

Unregisters the callback function.

Since :: 2.4

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

int mediacodec_unset_eos_cb ( mediacodec_h mediacodec )

unset eos callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mediacodec_set_event_handler_cb()

int mediacodec_unset_error_cb ( mediacodec_h mediacodec )

unset error callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mediacodec_set_error_cb()

int mediacodec_unset_input_buffer_used_cb ( mediacodec_h mediacodec )

unset input buffer used callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mediacodec_set_input_buffer_used_cb()

int mediacodec_unset_output_buffer_available_cb ( mediacodec_h mediacodec )

unset output buffer available callback the media codec for process, asynchronously.

Since :: 2.3

Parameters:

[in] mediacodec The handle to mediacodec

Returns:: 0 on success, otherwise a negative error value

Return values:

MEDIACODEC_ERROR_NONE	Successful
MEDIACODEC_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: mediacodec_set_output_buffer_available_cb()

Functions

Typedefs

Required Header

Overview

Typedef Documentation

Enumeration Type Documentation

Function Documentation