GSMFR

将GSMFR格式音频数据流解码成PCM格式音频数据流。

该函数调用流程如下：

调用HMPPA_Gsmfr_DecodeInit_8u16s初始化HmppaGsmfrDecodePolicy_16s结构体。
调用主函数HMPPA_Gsmfr_Decode_8u16s解码。
最后调用HMPPA_Gsmfr_DecodeRelease_8u16s释放HmppaGsmfrDecodePolicy_16s结构体所包含的内存。

函数接口声明如下：

初始化函数：
HmppResult HMPPA_Gsmfr_DecodeInit_8u16s(HmppaGsmfrDecodePolicy_16s **policy);
解码函数：
HmppResult HMPPA_Gsmfr_Decode_8u16s(const uint8_t *src, int32_t len, int16_t *dst, HmppaGsmfrDecodePolicy_16s *policy, int32_t *bytesConsumed, int64_t *bytesDecoded);
释放函数：
HmppResult HMPPA_Gsmfr_DecodeRelease_8u16s(HmppaGsmfrDecodePolicy_16s *policy);

参数

参数名	描述	取值范围	输入/输出
src	指向待解码的GSMFR码流指针。	非空	输入
len	待解码GSMFR码流长度（以字节为单位）。	(0, INT_MAX]	输入
dst	指向目的向量的指针。	非空	输出
policy	指向GSMFR结构体的指针。	非空	输入/输出
bytesConsumed	指向实际解码消耗的长度（以字节为单位）。	输入：空或者非空。输出：当输入为空，不输出；当输入为非空时，输出范围为[0, len]。	输出
bytesDecoded	指向实际解码输出的长度（以字节为单位）。	输入：空或者非空。输出：当输入为空，不输出；当输入为非空时，输出范围为[0, 理论解码len后输出的字节数]。	输出

返回值

成功：返回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 <stdint.h>
#include "hmppa.h"

#define ONE_FRAME_GSM 33
#define ONE_FRAME_PCM 160

int main(int argc, char* argv[])
{
    if (argc <3) {
        printf("%s in.gsmfr out.pcm\n", argv[0]);
        return 0;
    }
    FILE *in = fopen(argv[1], "rb");
    FILE *out = fopen(argv[2], "wb");
    if (!in || !out) {
        printf("Open file failed!\n");
        return 1;
    }

    fseek(in, 0, SEEK_END);
    int srcLen =ftell(in);
    int dstLen = srcLen / ONE_FRAME_GSM * ONE_FRAME_PCM;
    fseek(in, 0, SEEK_SET);
    uint8_t *src = (uint8_t*)malloc(srcLen * sizeof(uint8_t));
    int16_t *pcm= (int16_t*)malloc(dstLen * sizeof(int16_t));
    fread(src, sizeof(uint8_t), srcLen, in);
    int32_t bytesConsumed;
    int64_t bytesDecoded;

    HmppaGsmfrDecodePolicy_16s *policy;
    HMPPA_Gsmfr_DecodeInit_8u16s(&policy);
    HmppResult res = HMPPA_Gsmfr_Decode_8u16s(src, srcLen, pcm, policy, &bytesConsumed, &bytesDecoded);
    HMPPA_Gsmfr_DecodeRelease_8u16s(policy);
    
    printf("bytesConsumed = %d, bytesDecoded = %d, res = %d\n", bytesConsumed, bytesDecoded, res);
    fwrite(pcm, sizeof(short), bytesDecoded / 2, out);
    free(src);
    free(dst);
    fclose(in);
    fclose(out);
}

运行结果：

bytesConsumed = 5214, bytesDecoded = 50560, res = 0

父主题： 音频库接口函数