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 诊断。
WechatOpenSDK 1.8.2（与 daoqi msext 同款）
决策原因：微信 OpenSDK 2.0.x 强制 Universal Link，需要项目方配合： HTTPS 域名 + AASA 部署 + Xcode Associated Domains entitlement + 微信 开放平台后台审核（30min–1d）。daoqi msext 多年使用 1.8.2 上线稳定， ylgamehall 沿用同款避免无谓运维负担。1.x 不强制 UL，URL Scheme 即可。
历史记录：曾尝试 SDK 2.0.5 + 空 universalLink，结果
sendAuthReq直接success=false（SDK 拒绝），无法授权。改回 1.8.2 后行为与 msext 等价。
二进制来源
| 项 | 值 |
|---|---|
| 来源 | 直接从 daoqi/msext/Class/SDKExport/ 拷贝（与现网 msext 同版本） |
| 版本 | 1.8.2 |
| 形态 | fat 静态库 .a + 头文件（无 Swift module，需 Bridging Header） |
| 架构 | i386 + armv7 + armv7s + x86_64 + arm64（不含 ios-arm64-simulator） |
文件结构
Vendor/WechatSDK/
├── README.md ← 本文件
└── v1.8.2/
├── README.txt ← Tencent 官方版本历史
├── WXApi.h ← 主 API（registerApp/sendAuthReq/sendReq/handleOpenURL）
├── WXApiObject.h ← 数据对象（SendAuthReq/SendMessageToWXReq/WXMediaMessage 等）
├── WechatAuthSDK.h ← 扫码授权扩展（项目未用）
└── libWeChatSDK.a ← fat 静态库
Xcode 接入步骤（用户在 Xcode 手动）
- 删除当前 xcframework 引用：Project Navigator → 选中 ylgamehall target → General →
Frameworks, Libraries, and Embedded Content → 选中
WechatOpenSDK-NoPay.xcframework→ 点-删除（文件本身已在上次 commit 从 git 移除） - 加
.a静态库：同位置点+→ Add Other → Add Files → 选Vendor/WechatSDK/v1.8.2/libWeChatSDK.a→ Do Not Embed（静态库不能 embed） - 加 4 个微信 1.x 依赖的系统库（同位置点
+搜索）：- libz.tbd
- libsqlite3.tbd（旧的
libsqlite3.0.tbd也可） - Security.framework
- CFNetwork.framework 全部 Do Not Embed
- 配置 Build Settings：
- Header Search Paths：加
$(PROJECT_DIR)/Vendor/WechatSDK/v1.8.2（recursive 不必要） - Objective-C Bridging Header：设为
ylgamehall/ylgamehall-Bridging-Header.h
- Header Search Paths：加
- 确认 Info.plist 已配（之前 SDK 2.0.5 时已加，沿用即可）：
CFBundleURLTypes含wx586a9b321e56efb7LSApplicationQueriesSchemes含weixin/weixinULAPI/weixinURLParamsAPI
- Clean Build Folder + ⌘B
已知限制：M Mac 模拟器无法链接
fat 库不含 ios-arm64-simulator slice，M 芯片 Mac 模拟器链接会报与 AMap 相同的
arch 冲突错。接受现状，开发期跑真机（与 AMap 同款决策，详见
Vendor/AMap/README.md 「已知限制」）。
凭证
AppID + AppSecret + AuthScope 沿用 msext，参 docs/SDK-Integration-Guide.md §0。