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中,请参见枚举类型。  | 
枚举体HmppAmrnbMode元素: 
  | 
输入  | 
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