目录

Interface Summary

FileName

Description

dmsdp_audio_decoder_api.h

南向音频解码接口

Public Method Summary

DMSDPGetAudioDecoderHandler 获取设备音频解码器功能方法,存放在DMSDPAudioDecoderHandler结构体中。

形式:int32_t DMSDPGetAudioDecoderHandler(DMSDPAudioDecoderHandler *audioDecoderHandler)

参数:[in] na [out] cameraHandler

输出:0表示成功,<0表示失败。

描述:获取设备音频解码器功能方法,存放在DMSDPAudioDecoderHandler结构体中。

Type

Method

int32_t

(*AudioDecoderGetAbility)( ADecAbility* audioDecAbility, int32_t maxDecNum, int32_t* audioDecCnt)

获取设备音频解码器能力,具体参数存放在ADecoderAbility结构体中,audioDecCnt表示支持那几个编码器。如果支持多个解码器,返回多个解码器,比如同时支持多个解码器。

int32_t

(*AudioDecoderCreate)( ADecHandle* handle, ADecInitParams* initDecParams)

根据初始化参数创建音频解码器,handle为解码器的句柄,initDecParams为解码器初始化参数合集。

int32_t

(*AudioDecoderProcess)( ADecHandle handle, ADecInputData* inputData, ADecOutputData* outputData)

根据输入音频压缩码流进行解码输出PCM数据等,handle为编码器的句柄,inputData待解码压缩码流,outputData为解码输出PCM码流。

int32_t

(*AudioDecoderDestroy) (ADecHandle* handle)

销毁音频解码器。

Public Methods

[h2]AudioDecoderGetAbility

Method

int32_t (*AudioDecoderGetAbility)(ADecAbility *audioDecAbility, int32_t maxDecNum, int32_t *audioDecCnt)

获取设备音频解码器能力,具体参数存放在ADecoderAbility结构体中,audioDecCnt表示支持那几个编码器。如果支持多个解码器,返回多个解码器,比如同时支持多个解码器。

Parameters

Name

Description

audioDecAbility

音频解码器能力。

typedef struct {

/* 解码器类型,0:AAC,1:G.711A目前支持AAC LC */

int32_t codecType;

/* 最大声道数量,目前支持最大值为2 */

int32_t maxChannel;

/* 最大声道数量,目前支持最大值为1 */

int32_t minChannel;

/* 最大采样精度,目前支持最大值为16bit */

int32_t maxSampleRate;

/* 最小采样精度,目前支持最小值为16bit */

int32_t minSampleRate;

/* 最大采样精度,目前支持16bit */

int32_t maxSampleDepth;

/* 最小采样精度,目前支持16bit */

int32_t minSampleDepth;

/* 存储类型,掩码类型,bit0:交织存储 bit1:平面存储 ,目前仅交织存储 */

int32_t pcmStoreTypeMask;

/* 支持同时创建解码器的最大数量 */

int32_t maxCodecNum;

/* 是否支持异步输出,如果支持需要通过注册的回调进行输出 */

int32_t isAsynOutput;

} ADecAbility;

audioEncCnt

支持解码器个数。

maxEncNum

最大解码器个数。

Return

Type

Description

int32_t

0:成功,<0失败。

[h2]AudioDecoderCreate

Method

int32_t (*AudioDecoderCreate)(ADecHandle *handle, ADecInitParams *initDecParams)

根据初始化参数创建音频解码器,handle为解码器的句柄,initDecParams为解码器初始化参数合集。

Parameters

Name

Description

handle

创建解码器句柄。

initDecParams

解码器初始化参数合集。

typedef void (*ADecOutputDataCB)(ADecOutputData *outputDataDec, void *privateData);

typedef struct {

/* 解码器类型,0:AAC,1:G.711A */

int32_t codecType;

/* 通道数量 */

int32_t channel;

/* 采样率 */

int32_t sampleRate;

/* 采样精度 */

int32_t sampleDepth;

/* pcm存储类型 */

int32_t pcmStoreType;

/* 私有数据,通过pfnOutput回调进行透传 */

void *privateData;

/* 输出回调,非NULL则通过回调输出,否则同步输出 */

ADecOutputDataCB pfnOutput;

} ADecInitParams;

Return

Type

Description

int32_t

0:成功,<0失败。

[h2]AudioDecoderProcess

Method

int32_t (*AudioDecoderProcess)(ADecHandle handle, ADecInputData *inputData, ADecOutputData *outputData)

根据输入音频压缩码流进行解码输出PCM数据等,handle为编码器的句柄,inputData待解码压缩码流,outputData为解码输出PCM码流。

Parameters

Name

Description

handle

解码器句柄。

inputData

待解码压缩码流。

typedef struct {

/* 待解码码流 */

uint8_t *bsBuf;

/* 码流长度 */

int32_t bsLength;

/* 时间戳(单位US) */

int64_t timeStamp;

outputData

解码输出PCM码流。

typedef struct {

/* pcm码流 */

uint8_t *pcmBuf;

/* pcm长度 */

int32_t pcmlength;

/* 时间戳(单位US) */

int64_t timeStamp;

} ADecOutputData;

Return

Type

Description

int32_t

0:成功,<0失败。

[h2]AudioDecoderDestroy

Method

int32_t (*AudioDecoderDestroy)(ADecHandle handle)

销毁音频解码器。

Parameters

Name

Description

handle

解码器句柄。

Return

Type

Description

int32_t

0:成功,<0失败。