AMRWB
将PCM格式音频数据流编码成AMRWB格式音频数据流。
该函数调用流程如下:
- 获取编码需要申请的内存大小dstBufLen。
- 调用Init初始化结构体。
- 调用主函数HMPPA_Amrwb_Encode_16s8u编码。
- 最后调用Release释放结构体所申请的内存。
函数接口声明如下:
- 获取编码需要申请的内存大小:
HmppResult HMPPA_Amrwb_GetEncodeDstBufLen_16s8u(int32_t len, int32_t *dstBufLen, HmppAmrwbMode mode);
- 初始化函数:
HmppResult HMPPA_Amrwb_EncodeInit_16s8u(HmppaAmrnbEncodePolicy_16s **policy, HmppAmrwbMode mode, int32_t dtx);
- 编码函数:
HmppResult HMPPA_Amrwb_Encode_16s8u(const int16_t *src, int32_t len, uint8_t *dst, HmppaAmrwbEncodePolicy_16s *policy, int64_t *bytesConsumed, int32_t *bytesEncoded);
- 释放函数:
HmppResult HMPPA_Amrwb_EncodeRelease_16s8u(HmppaAmrnbEncodePolicy_16s *policy);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
---|---|---|---|
src |
指向待编码的AMRWB码流指针。 |
非空 |
输入 |
len |
待编码数据流长度(以双字节为单位)。 |
(0, INT_MAX] |
输入 |
dst |
指向目的向量的指针。 |
非空 |
输出 |
policy |
特殊结构体的指针。 |
非空 |
输入/输出 |
bytesConsumed |
指向实际编码消耗的长度(以字节为单位)。 |
[0, len] |
输出 |
bytesEncoded |
指向实际编码输出的长度(以字节为单位)。 |
[0, 理论编码len后输出的字节数] |
输出 |
dstBufLen |
指向目的向量需要的长度(以字节为单位)。 |
非空 |
输出 |
mode |
待编码的AMRWB码流的比特率。 |
枚举体HmppAmrwbMode元素: HMPP_AMRWB_6600, HMPP_AMRWB_8850, HMPP_AMRWB_12650, HMPP_AMRWB_14250, HMPP_AMRWB_15850, HMPP_AMRWB_18250, HMPP_AMRWB_19850, HMPP_AMRWB_23050, HMPP_AMRWB_23850 |
输入 |
dtx |
是否开启DTX(非连续传输)功能的标志。 |
|
输入 |
返回值
- 成功:返回HMPP_STS_NO_ERR。
- 失败:返回错误码。
错误码
错误码 |
描述 |
---|---|
HMPP_STS_NULL_PTR_ERR |
src、dst、policy中存在空指针。 |
HMPP_STS_MALLOC_FAILED |
申请内存失败。 |
HMPP_STS_SIZE_WRN |
输入的数据流未能完全编码。 |
示例
#include <stdio.h> #include <stdlib.h> #include <stdint.h> #include <string.h> #include <hmpp.h> int main(int argc, char *argv[]) { if (argc < 3) { fprintf(stderr, "%s in.amr out.wav\n", argv[0]); return 1; } FILE *in = fopen(argv[1], "r"); FILE *out = fopen(argv[2], "w+"); if (!in || !out) { printf("Open file failed!\n"); return 1; } fseek(in, 0, SEEK_END); int32_t srcLen = ftell(in) / 2; fseek(in, 0, SEEK_SET); HmppaAmrwbEncodePolicy_16s *policy; int32_t re = HMPPA_Amrwb_EncodeInit_16s8u(&policy, HMPP_AMRWB_6600, 0); int16_t *src = (int16_t*)malloc(srcLen * sizeof(int16_t)); int dstLen; re = HMPPA_Amrwb_GetEncodeDstBufLen_16s8u(srcLen, &dstLen, HMPP_AMRWB_6600); uint8_t *dst = (uint8_t*)malloc(dstLen * sizeof(uint8_t)); fread(src, sizeof(int16_t), srcLen, in); int64_t bytesConsumed = 0; int32_t bytesDecoded = 0; re = HMPPA_Amrwb_Encode_16s8u(src, srcLen, dst, policy, &bytesConsumed, &bytesDecoded); printf("HmppResult:%d, bytesConsumed:%d, bytesDecoded:%d\n", re, bytesConsumed, bytesDecoded); re = HMPPA_Amrwb_EncodeRelease_16s8u(policy); fwrite(dst, sizeof(uint8_t), dstLen, out); fclose(in); fclose(out); return 0; }
运行结果:
HmppResult:0, bytesConsumed:50560, bytesDecoded:2844