joywayer
5b38456c66
为支撑 H5 的 prepareaudio / mediaTypeAudio 录音上传 + 远端语音播放
（docs/H5-Native-Contract.md §3.1 ［4］［5］ + §3.2 ［9］）接入 AMR-NB
编解码能力。AMR-NB 是跨端（iOS / Android / 旧版本客户端）契约硬约束，
不可换 AAC / Opus。
## 接入路径
直接 vendor daoqi msext 现成的 fat .a（已上线多年），不打 xcframework /
不重编源码：
- Vendor/OpenCoreAMR/v0.1.x/libopencore-amrnb.a：daoqi 同款 5-slice fat
库（含 2026-06-20 lipo -segalign 8 修过的对齐版本）
- Vendor/OpenCoreAMR/v0.1.x/{interf_dec,interf_enc}.h：amrnb 公开头
- Vendor/OpenCoreAMR/README.md：来源、版本、修复历史、为何不打 xcframework
- ylgamehall/Source/Audio/AMRFileCodec/{amrFileCodec.h,amrFileCodec.mm}：
daoqi 同款 wrapper（文件级 WAV↔AMR 处理）
- ylgamehall/Source/Audio/AMRCodec.swift：Swift 薄 wrapper（wavToAmr /
amrToWav 两个纯函数 + AMRCodec.Error）
理由见 Vendor/OpenCoreAMR/README.md「为何不打 xcframework / 不重编源码」
一节，本质是 opencore-amr 整个 iOS 生态没有"现代主流"分发形态，社区无
官方 SPM / xcframework 维护，强行打反而引入新风险。
## 关键技术点：extern "C" 修复 ObjC++ name mangling
amrFileCodec.h 在原项目里没有 extern "C" 包裹函数声明，daoqi 能跑是
因为调用方 VoiceConverter.mm 也是 ObjC++，双方按相同 C++ name mangling
链接能对上。
新外壳从 Swift 通过 bridging-header 调用，Swift 按 C 函数解析，期望符号
_EncodeWAVEFileToAMRFile / _DecodeWAVEFileToWAVEFile（C 链接）；但
.mm 编译时默认 C++ name mangling，符号变成 __Z25Encode...，导致链接器
报 Undefined symbol。
修复：在 amrFileCodec.h 的函数声明外加 #ifdef __cplusplus / extern "C"
包裹。这是标准 C/C++ 头文件兼容写法，对 daoqi 老路径无影响（ObjC++
调用方仍能链接 C-linkage 函数）。
## .gitignore：白名单 Vendor 下的 .a
发现历史遗留问题：原 .gitignore *.a 通配规则把 libWeChatSDK.a 也排除
了，意味着别人 clone 此仓库后链接失败。本次顺带修复：
!Vendor/**/*.a
让 Vendor 下的 .a 显式纳入跟踪。本提交同时把 libWeChatSDK.a（历史
缺失）+ libopencore-amrnb.a（本次新增）一并加入 git 跟踪。
## 工程改动
pbxproj 改动由用户在 Xcode UI 完成（4 项 Build Settings：Add .a 到
Frameworks group / Header Search Paths +2 / Library Search Paths +1；
EXCLUDED_ARCHS arm64-simulator 因真机调试场景暂未配，需要时再加）。
## 验证
BuildProject 通过，0 错误，符号链接正确。XcodeRefreshCodeIssuesInFile
对 AMRCodec.swift 0 诊断。
90 lines
2.0 KiB
C
Executable File
90 lines
2.0 KiB
C
Executable File
//
|
||
// amrFileCodec.h
|
||
// amrDemoForiOS
|
||
//
|
||
// Created by Tang Xiaoping on 9/27/11.
|
||
// Copyright 2011 test. All rights reserved.
|
||
//
|
||
#ifndef amrFileCodec_h
|
||
#define amrFileCodec_h
|
||
#include <stdlib.h>
|
||
#include <string.h>
|
||
#include <stdio.h>
|
||
#include "interf_dec.h"
|
||
#include "interf_enc.h"
|
||
|
||
#define AMR_MAGIC_NUMBER "#!AMR\n"
|
||
|
||
#define PCM_FRAME_SIZE 160 // 8khz 8000*0.02=160
|
||
#define MAX_AMR_FRAME_SIZE 32
|
||
#define AMR_FRAME_COUNT_PER_SECOND 50
|
||
|
||
typedef struct
|
||
{
|
||
char chChunkID[4];
|
||
int nChunkSize;
|
||
}XCHUNKHEADER;
|
||
|
||
typedef struct
|
||
{
|
||
short nFormatTag;
|
||
short nChannels;
|
||
int nSamplesPerSec;
|
||
int nAvgBytesPerSec;
|
||
short nBlockAlign;
|
||
short nBitsPerSample;
|
||
}WAVEFORMAT;
|
||
|
||
typedef struct
|
||
{
|
||
short nFormatTag;
|
||
short nChannels;
|
||
int nSamplesPerSec;
|
||
int nAvgBytesPerSec;
|
||
short nBlockAlign;
|
||
short nBitsPerSample;
|
||
short nExSize;
|
||
}WAVEFORMATX;
|
||
|
||
typedef struct
|
||
{
|
||
char chRiffID[4];
|
||
int nRiffSize;
|
||
char chRiffFormat[4];
|
||
}RIFFHEADER;
|
||
|
||
typedef struct
|
||
{
|
||
char chFmtID[4];
|
||
int nFmtSize;
|
||
WAVEFORMAT wf;
|
||
}FMTBLOCK;
|
||
|
||
// extern "C" 在 ObjC++ (.mm) 编译时禁用 C++ name mangling，
|
||
// 保证 .o 里函数符号是 _EncodeWAVEFileToAMRFile / _DecodeAMRFileToWAVEFile（C 链接），
|
||
// 与 Swift bridging-header 从 amrFileCodec.h 推导出的 C 函数签名匹配。
|
||
//
|
||
// daoqi msext 原版无 extern "C" 包裹，因为调用方 VoiceConverter.mm 也是 ObjC++，
|
||
// 双方都按 C++ name mangling 链接能匹配上。新外壳从 Swift 通过 bridging-header
|
||
// 调用，Swift 按 C 函数解析，必须显式标 C linkage。
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
// WAVE音频采样频率是8khz
|
||
// 音频样本单元数 = 8000*0.02 = 160 (由采样频率决定)
|
||
// 声道数 1 : 160
|
||
// 2 : 160*2 = 320
|
||
// bps决定样本(sample)大小
|
||
// bps = 8 --> 8位 unsigned char
|
||
// 16 --> 16位 unsigned short
|
||
int EncodeWAVEFileToAMRFile(const char* pchWAVEFilename, const char* pchAMRFileName, int nChannels, int nBitsPerSample);
|
||
|
||
// 将AMR文件解码成WAVE文件
|
||
int DecodeAMRFileToWAVEFile(const char* pchAMRFileName, const char* pchWAVEFilename);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif |