GSMHR
将PCM格式音频数据流编码成GSMHR格式音频数据流。
该函数调用流程如下:
- 获取编码需要申请的内存大小dstBufLen。
- 调用HMPPA_Gsmhr_EncodeInit_16s8u初始化HmppaGsmhrEncodePolicy_16s结构体。
- 调用主函数HMPPA_Gsmhr_Encode_16s8u解码。
- 最后调用HMPPA_Gsmhr_EncodeRelease_16s8u释放HmppaGsmhrEncodePolicy_16s结构体所包含的内存。
函数接口声明如下:
- 获取编码需要申请的内存大小:
HmppResult HMPPA_Gsmhr_GetEncodeDstBufLen_16s8u(int32_t len, int32_t *dstBufLen);
- 初始化函数:
HmppResult HMPPA_Gsmhr_EncodeInit_16s8u(HmppaGsmhrEncodePolicy_16s **policy);
- 编码函数:
HmppResult HMPPA_Gsmhr_Encode_16s8u(const int16_t *src, int32_t len, int32_t dtx, uint8_t *dst, HmppaGsmhrEncodePolicy_16s *policy, int64_t *bytesConsumed, int32_t *bytesEncoded);
- 释放函数:
HmppResult HMPPA_Gsmhr_EncodeRelease_16s8u(HmppaGsmhrEncodePolicy_16s *policy);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
src |
指向待编码的PCM码流指针。 |
非空 |
输入 |
len |
待编码PCM码流长度(以字节为单位)。 |
(0, INT_MAX] |
输入 |
dtx |
是否开启DTX(非连续传输)功能的标志。 |
|
输入 |
dst |
指向目的向量的指针。 |
非空 |
输出 |
policy |
指向GSMHR结构体的指针。 |
非空 |
输入/输出 |
bytesConsumed |
指向实际编码消耗的长度(以字节为单位)。 |
[0, len] |
输出 |
bytesEncoded |
指向实际编码输出的长度(以字节为单位)。 |
[0, 理论编码len后输出的字节数] |
输出 |
dstBufLen |
指向目的向量需要的长度(以双字节为单位)。 |
非空 |
输出 |
返回值
- 成功:返回HMPP_STS_NO_ERR。
- 失败:返回错误码。
错误码
错误码 |
描述 |
|---|---|
HMPP_STS_NULL_PTR_ERR |
指针参数中包含空指针。 |
HMPP_STS_SIZE_ERR |
len不为正数。 |
HMPP_STS_SIZE_WRN |
src未全部编码。 |
示例
#include<stdlib.h>
#include<stdio.h>
#include"hmppa.h"
#define ONE_FRAME_GSM 14
#define ONE_FRAME_PCM 160
int main(int argc, char* argv[])
{
if (argc <3) {
printf("%s in.pcm out.gsmhr\n", argv[0]);
return 0;
}
FILE *file =fopen(argv[1], "rb");
if (file ==NULL) {
printf("Open File %s Failed\n", argv[1]);
return 0;
}
fseek(file, 0, SEEK_END);
int32_t srcLen =ftell(file) / 2;
int32_t dstLen;
HMPPA_Gsmhr_GetEncodeDstBufLen_16s8u(srcLen, &dstLen);
fseek(file, 0, SEEK_SET);
short src[srcLen];
unsigned char rb[dstLen];
HmppaGsmhrEncodePolicy_16s *policy;
HMPPA_Gsmhr_EncodeInit_16s8u(&policy);
FILE *out = fopen(argv[2], "wb");
fread(src, sizeof(short), srcLen, file);
long int bytesConsumed;
int bytesEncoded;
int dtx = 1;
int res = HMPPA_Gsmhr_Encode_16s8u(src, srcLen, dtx, rb, policy, &bytesConsumed, &bytesEncoded);
HMPPA_Gsmhr_EncodeRelease_16s8u(policy);
printf("bytesConsumed = %d, bytesDecoded = %d, res = %d\n", bytesConsumed, bytesEncoded, res);
fwrite(rb, sizeof(unsigned char), bytesEncoded, out);
}
运行结果:
bytesConsumed = 50560, bytesDecoded = 2212, res = 0