AudioEncoder
Overview
The AudioEncoder module provides the functions for audio encoding.
System capability: SystemCapability.Multimedia.Media.Core
Since: 9
Summary
Files
| Name | Description |
|---|---|
| native_avcodec_audioencoder.h | Declares the native APIs used for audio encoding. |
Functions
| Name | Description |
|---|---|
| OH_AVCodec * OH_AudioEncoder_CreateByMime (const char *mime) | Creates an audio encoder instance based on a Multipurpose Internet Mail Extension (MIME) type. |
| OH_AVCodec * OH_AudioEncoder_CreateByName (const char *name) | Creates an audio encoder instance based on an encoder name. |
| OH_AVErrCode OH_AudioEncoder_Destroy (OH_AVCodec *codec) | Clears the internal resources of an audio encoder and destroys the encoder instance. |
| OH_AVErrCode OH_AudioEncoder_SetCallback (OH_AVCodec *codec, OH_AVCodecAsyncCallback callback, void *userData) | Sets an asynchronous callback so that your application can respond to events generated by an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_Configure (OH_AVCodec *codec, OH_AVFormat *format) | Configures an audio encoder. Typically, you need to configure the description information about the audio track to be encoded. |
| OH_AVErrCode OH_AudioEncoder_Prepare (OH_AVCodec *codec) | Prepares internal resources for an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_Start (OH_AVCodec *codec) | Starts an audio encoder. This function can be called only after the encoder is prepared successfully. |
| OH_AVErrCode OH_AudioEncoder_Stop (OH_AVCodec *codec) | Stops an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_Flush (OH_AVCodec *codec) | Clears the input and output data in the internal buffer of an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_Reset (OH_AVCodec *codec) | Resets an audio encoder. |
| OH_AVFormat * OH_AudioEncoder_GetOutputDescription (OH_AVCodec *codec) | Obtains the description information about the output data of an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_SetParameter (OH_AVCodec *codec, OH_AVFormat *format) | Sets dynamic parameters for an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_PushInputData (OH_AVCodec *codec, uint32_t index, OH_AVCodecBufferAttr attr) | Pushes the input buffer filled with data to an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_FreeOutputData (OH_AVCodec *codec, uint32_t index) | Frees an output buffer of an audio encoder. |
| OH_AVErrCode OH_AudioEncoder_IsValid (OH_AVCodec *codec, bool *isValid) | Checks whether an audio encoder instance is valid. This function is used to check the encoder validity when the background recovers from a fault or an application is switched from the background. |
Function Description
OH_AudioEncoder_Configure()
OH_AVErrCode OH_AudioEncoder_Configure (OH_AVCodec *codec, OH_AVFormat *format)
Description
Configures an audio encoder. Typically, you need to configure the description information about the audio track to be encoded. This function must be called prior to Prepare.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Configure
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| format | Pointer to an OH_AVFormat instance, which provides the description information about the audio track to be encoded. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_CreateByMime()
OH_AVCodec* OH_AudioEncoder_CreateByMime (const char *mime)
Description
Creates an audio encoder instance based on a MIME type. This function is recommended in most cases.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_CreateByMime
Parameters
| Name | Description |
|---|---|
| mime | Pointer to a string that describes the MIME type. For details, see AVCODEC_MIMETYPE. |
Returns
Returns the pointer to an OH_AVCodec instance.
OH_AudioEncoder_CreateByName()
OH_AVCodec* OH_AudioEncoder_CreateByName (const char *name)
Description
Creates an audio encoder instance based on an encoder name. To use this function, you must know the exact name of the encoder.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_CreateByName
Parameters
| Name | Description |
|---|---|
| name | Pointer to an audio encoder name. |
Returns
Returns the pointer to an OH_AVCodec instance.
OH_AudioEncoder_Destroy()
OH_AVErrCode OH_AudioEncoder_Destroy (OH_AVCodec *codec)
Description
Clears the internal resources of an audio encoder and destroys the encoder instance.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Destroy
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_Flush()
OH_AVErrCode OH_AudioEncoder_Flush (OH_AVCodec *codec)
Description
Clears the input and output data in the internal buffer of an audio encoder.
This function invalidates the indexes of all buffers previously reported through the asynchronous callback. Therefore, before calling this function, ensure that the buffers with the specified indexes are no longer required.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Flush
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_FreeOutputData()
OH_AVErrCode OH_AudioEncoder_FreeOutputData (OH_AVCodec *codec, uint32_t index)
Description
Frees an output buffer of an audio encoder.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_FreeOutputBuffer
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| index | Index of the output buffer. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_GetOutputDescription()
OH_AVFormat* OH_AudioEncoder_GetOutputDescription (OH_AVCodec *codec)
Description
Obtains the description information about the output data of an audio encoder. The caller must manually release the OH_AVFormat instance in the return value.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_GetOutputDescription
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns the handle to an OH_AVFormat instance. The lifecycle of this instance is refreshed when GetOutputDescription is called again and destroyed when the OH_AVCodec instance is destroyed.
OH_AudioEncoder_IsValid()
OH_AVErrCode OH_AudioEncoder_IsValid (OH_AVCodec *codec, bool *isValid)
Description
Checks whether an audio encoder instance is valid. This function is used to check the encoder validity when the background recovers from a fault or an application is switched from the background.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 10
Deprecated from: 11
Substitute API: OH_AudioCodec_IsValid
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| isValid | Pointer to an instance of the Boolean type. The value true means that the encoder instance is valid and false means the opposite. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_Prepare()
OH_AVErrCode OH_AudioEncoder_Prepare (OH_AVCodec *codec)
Description
Prepares internal resources for an audio encoder. This function must be called after Configure.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Prepare
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_PushInputData()
OH_AVErrCode OH_AudioEncoder_PushInputData (OH_AVCodec *codec, uint32_t index, OH_AVCodecBufferAttr attr)
Description
Pushes the input buffer filled with data to an audio encoder.
The OH_AVCodecOnNeedInputData callback reports the available input buffer and the index. After being pushed to the encoder, a buffer is not accessible until the buffer with the same index is reported again through the OH_AVCodecOnNeedInputData callback.
In addition, some encoders require the input of specific data to initialize the encoding process.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_PushInputBuffer
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| index | Index of the input buffer. |
| attr | Description information about the data in the buffer. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_Reset()
OH_AVErrCode OH_AudioEncoder_Reset (OH_AVCodec *codec)
Description
Resets an audio encoder. To continue encoding, you must call Configure to configure the encoder again.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Reset
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_SetCallback()
OH_AVErrCode OH_AudioEncoder_SetCallback (OH_AVCodec *codec, OH_AVCodecAsyncCallback callback, void *userData)
Description
Sets an asynchronous callback so that your application can respond to events generated by an audio encoder. This function must be called prior to Prepare.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_RegisterCallback
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| callback | Callback function to set. For details, see OH_AVCodecAsyncCallback. |
| userData | User-specific data. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_SetParameter()
OH_AVErrCode OH_AudioEncoder_SetParameter (OH_AVCodec *codec, OH_AVFormat *format)
Description
Sets dynamic parameters for an audio encoder.
This function can be called only after the encoder is started. Incorrect parameter settings may cause encoding failure.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_SetParameter
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
| format | Handle to an OH_AVFormat instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_Start()
OH_AVErrCode OH_AudioEncoder_Start (OH_AVCodec *codec)
Description
Starts an audio encoder. This function can be called only after the encoder is prepared successfully. After being started, the encoder starts to report the OH_AVCodecOnNeedInputData event.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Start
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.
OH_AudioEncoder_Stop()
OH_AVErrCode OH_AudioEncoder_Stop (OH_AVCodec *codec)
Description
Stops an audio encoder. After the encoder is stopped, you can call Start to start it again.
System capability: SystemCapability.Multimedia.Media.AudioEncoder
Since: 9
Deprecated from: 11
Substitute API: OH_AudioCodec_Stop
Parameters
| Name | Description |
|---|---|
| codec | Pointer to an OH_AVCodec instance. |
Returns
Returns AV_ERR_OK if the operation is successful; returns an error code defined in OH_AVErrCode otherwise.