AMRWB

将AMRWB（Adaptive Multi-rate Wideband）格式音频数据流解码成PCM格式音频数据流，目前仅支持单通道解码。

该函数调用流程如下：

获取解码需要申请的内存大小dstBufLen。
调用Init初始化结构体。
调用主函数HMPPA_Amrwb_Decode_8u16s解码。
最后调用Release释放结构体所包含的内存。

函数接口声明如下：

获取解码需要申请的内存大小：
HmppResult HMPPA_Amrwb_GetDecodeDstBufLen_8u16s(const uint8_t *src, int32_t len, int32_t *dstBufLen);
初始化函数：
HmppResult HMPPA_Amrwb_DecodeInit_8u16s(HmppaAmrwbDecodePolicy_16s** policy);
解码函数：
HmppResult HMPPA_Amrwb_Decode_8u16s(uint8_t *src, int32_t len, int16_t *dst, HmppaAmrwbDecodePolicy_16s*policy, int32_t *bytesConsumed, int64_t *byteDecoded);
释放函数：
HmppResult HMPPA_Amrwb_DecodeRelease_8u16s(HmppaAmrwbDecodePolicy_16s* policy);

参数

参数名	描述	取值范围	输入/输出
src	指向待解码的AMRWB码流指针。	非空	输入
len	待解码数据流长度（以字节为单位）。	(0, INT_MAX]	输入
dst	指向目的向量的指针。	非空	输出
policy	特殊结构体的指针。	非空	输入/输出
bytesConsumed	指向实际解码消耗的长度（以字节为单位）。	[0, len]	输出
bytesDecoded	指向实际解码输出的长度（以字节为单位）。	[0, 理论解码len后输出的字节数]	输出
dstBufLen	指向目的向量需要的长度（以双字节为单位）。	非空	输出

返回值

成功：返回HMPP_STS_NO_ERR。
失败：返回错误码。

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src、dst、policy中存在空指针。
HMPP_STS_MALLOC_FAILED	申请内存失败。
HMPP_STS_SIZE_WRN	输入的数据流未能完全解码。
HMPP_STS_HEAD_ERR	输入的数据流头信息错误，即非AMRWB音频格式码流。

示例

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <hmppa.h>

#define FRAMES 158

int main(int argc, char *argv[]) {
    FILE* in;
    FILE* out;
    int32_t re;
    int32_t bytesConsumed = 0;
    int64_t bytesDecoded = 0;
    if (argc < 3) {
        fprintf(stderr, "%s in.amr out.pcm\n", argv[0]);
        return 1;
    }

    in = fopen(argv[1], "rb");
    out = fopen(argv[2], "w+");
    if (!in) {
        perror(argv[1]);
        return 1;
    }

    fseek(in, 0, SEEK_END);
    int32_t srcLen = ftell(in);
    fseek(in, 0, SEEK_SET);
    uint8_t* src = (uint8_t*)malloc(srcLen * sizeof(uint8_t));
    int32_t n = fread(src, 1, srcLen, in);
    if (n != srcLen) {
        return -1;
    }

    int32_t dstLen;
    re = HMPPA_Amrnb_GetDecodeDstBufLen_8u16s(src, srcLen, &dstLen);
    int16_t* dst = (int16_t*)malloc(dstLen * sizeof(int16_t));

    HmppaAmrwbDecodePolicy_16s *amrwb = NULL;
    re = HMPPA_Amrwb_DecodeInit_8u16s(&amrwb);
    if (re != HMPP_STS_NO_ERR) {
        return 0;;
    }
    re = HMPPA_Amrwb_Decode_8u16s(src, srcLen, dst, amrwb, &bytesConsumed, &bytesDecoded);
    if (re == HMPP_STS_NO_ERR) {
        fwrite(dst, 2, dstLen, out);
        printf("SUCCESS: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
    } else if (re == HMPP_STS_SIZE_WRN) {
        fwrite(dst, 2, dstLen, out);
        printf("WARNING: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
    } else {
        printf("WRONG: result = %d, bytesConsumed = %d, bytesDecoded = %lld\n", re, bytesConsumed, bytesDecoded);
    }

    re = HMPPA_Amrwb_DecodeRelease_8u16s(amrwb);
    fclose(in);
    fclose(out);

    return 0;
}

运行结果：

SUCCESS: result = 0, bytesConsumed = 9647, bytesDecoded = 50560

父主题： 音频解码