AMRNB
将PCM格式音频数据流编码成AMRNB格式音频数据流。
该函数调用流程如下:
- 获取编码需要申请的内存大小dstBufLen。
- 调用Init初始化结构体。
- 调用主函数HMPPA_Amrnb_Encode_16s8u编码。
- 最后调用Release释放结构体所申请的内存。
函数接口声明如下:
- 获取编码需要申请的内存大小:
HmppResult HMPPA_Amrnb_GetEncodeDstBufLen_16s8u(int32_t len, int32_t *dstBufLen, HmppAmrnbMode mode);
- 初始化函数:
HmppResult HMPPA_Amrnb_EncodeInit_16s8u(HmppaAmrnbEncodePolicy_16s **policy, HmppAmrnbMode mode, int32_t dtx);
- 编码函数:
HmppResult HMPPA_Amrnb_Encode_16s8u(const int16_t *src, int32_t len, uint8_t *dst, HmppaAmrnbEncodePolicy_16s *policy, int64_t *bytesConsumed, int32_t *bytesEncoded);
- 释放函数:
HmppResult HMPPA_Amrnb_EncodeRelease_16s8u(HmppaAmrnbEncodePolicy_16s *policy);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
---|---|---|---|
src |
指向待编码的AMRNB码流指针。 |
非空 |
输入 |
len |
待编码数据流长度(以双字节为单位)。 |
(0, INT_MAX] |
输入 |
dst |
指向目的向量的指针。 |
非空 |
输出 |
policy |
特殊结构体的指针。 |
非空 |
输入/输出 |
bytesConsumed |
指向实际编码消耗的长度(以字节为单位)。 |
[0, len] |
输出 |
bytesEncoded |
指向实际编码输出的长度(以字节为单位)。 |
[0, 理论编码len后输出的字节数] |
输出 |
dstBufLen |
指向目的向量需要的长度(以字节为单位)。 |
非空 |
输出 |
mode |
待编码的AMRNB码流的比特率。 |
枚举体HmppAmrnbMode元素: HMPP_AMRNB_MR475, HMPP_AMRNB_MR515, HMPP_AMRNB_MR59, HMPP_AMRNB_MR67, HMPP_AMRNB_MR74, HMPP_AMRNB_MR795, HMPP_AMRNB_MR102, HMPP_AMRNB_MR122 |
输入 |
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); int16_t *src = (int16_t*)malloc(srcLen * sizeof(int16_t)); fread(src, sizeof(int16_t), srcLen, in); HmppaAmrnbEncodePolicy_16s *policy; int32_t re = HMPPA_Amrnb_EncodeInit_16s8u(&policy, HMPP_AMRNB_MR475, 0); int dstLen; re = HMPPA_Amrnb_GetEncodeDstBufLen_16s8u(srcLen, &dstLen, HMPP_AMRNB_MR475); uint8_t *dst = (uint8_t*)malloc(dstLen * sizeof(uint8_t)); int64_t bytesConsumed = 0; int32_t bytesEncoded = 0; re = HMPPA_Amrnb_Encode_16s8u(src, srcLen, dst, policy, &bytesConsumed, &bytesEncoded); printf("HmppResult:%d, bytesConsumed:%d, bytesDecoded:%d\n", re, bytesConsumed, bytesEncoded); re = HMPPA_Amrnb_EncodeRelease_16s8u(policy); fwrite(dst, sizeof(uint8_t), bytesEncoded, out); fclose(in); fclose(out); return 0; }
运行结果:
HmppResult:0, bytesConsumed:50560, bytesDecoded:2054