daoqi/youle_app_ios_v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
151 Commits 1 Branch 0 Tags
d76064c4c529b845eba78d6c68c3341286b9f5bf
Commit Graph
6 Commits
Author SHA1 Message Date
joywayer c1e51d2183 微信分享去sdk 2026-06-30 17:40:54 +08:00
joywayer 173bf79a74 3.D：VoicePlayer 远端语音播放器 + gameui_stop_voice 触发点 
支撑 Phase 3.F mediaTypeAudio handler 的播放子链路。

## 行为对齐原项目

- `lastUserId`：mediaTypeAudio 入参 user 字段，每次进来都更新（无论
  voicePlaying=1/0、无论是否实际播放），对齐 daoqi gameController.m:438
  `self.User_id=userid;` 总是执行的行为
- `gameui_stop_voice` payload 用 `lastUserId`，**不**是 didFinishPlaying
  传入的 player 关联值（多条消息连发时 stop 发最新 user，与 daoqi 行为
  一致——这是原项目的"特征"，不是 bug）
- 覆盖式 play：前一条还在播时收到第二条直接替换 player（对齐 daoqi
  `voicePlayer = [[AVAudioPlayer alloc]...]` ARC 覆盖行为）
- 主动 stop 不触发 onFinish（daoqi 没有主动 stop 路径）

## Swift 6 并发处理

AVAudioPlayerDelegate 方法签名 nonisolated；AVAudioPlayer 是
non-Sendable 不能跨 actor 传递。用 ObjectIdentifier（Sendable）传递
身份，handleFinish 在 MainActor 内重新查 self.player 比对身份。

防御覆盖式 play 时旧 player stop 触发延迟 delegate：仅当 didFinish
的 player 与当前 self.player 同身份时才清理 + 触发 onFinish。

## 验证

BuildProject 通过 0 错误。
 2026-06-24 01:31:52 +08:00
joywayer c398a8dd58 3.C：录音组件落地（VoiceRecorder + Overlay + Presenter + Window 子类） 
完整支撑 Phase 3.E prepareaudio handler 的录音子链路：用户按住 H5 麦克风按钮
→ Native 录音 → 松手停止 → 触发完成回调。

## 新增模块

- `RecordingAwareWindow`：UIWindow 子类，提供 touch 旁路监听通道
  （static touchObserver closure）。默认行为与 UIWindow 完全一致，仅
  RecordingPresenter 注册 observer 后才触发额外行为。daoqi msext
  CustomWindow.m + nScreenTouch 通知同款思路，改用 closure 注入
- `VoiceRecorder`：AVAudioRecorder + AudioSession + 0.1s 计时器封装。
  ObservableObject + @Published（暴露 averagePower / elapsed 给 SwiftUI）。
  录音参数 8kHz/16bit/mono PCM 严格对齐 daoqi（AMR-NB 编码硬要求）。
  60s 上限对齐 daoqi kDefaultMaxRecordTime
- `RecordingOverlay`：SwiftUI 浮层（UI 内部实现，按 CLAUDE.md「原则 B 原生
  内部自由」与 daoqi 不一致）。半透明黑底胶囊 + SF Symbols 麦克风 + 音量
  光晕动画 + 倒计时（剩 10s 显示秒数，对齐 daoqi UI 逻辑）
- `RecordingPresenter`：组装入口。挂载 overlay 到 hostVC 全屏覆盖 +
  注册 touchObserver。提供 `start(on:fileName:onFinish:)` 单一 API +
  `cancelActive()` 强制取消

## SceneDelegate 改动

UIWindow → RecordingAwareWindow 实例化。变量类型仍为 UIWindow?
（多态），sendEvent 走子类版本。零行为变化（observer 未注册时）。

## 为何必须走 UIWindow 子类

H5 麦克风按钮按下触发 prepareaudio → 录音浮层在按住状态下中途弹出。
iOS touch 事件流是 view hit-test 链，**in-flight touch 不传给中途加入
的 view**，浮层 view 自身收不到 touchesEnded，用户松手时检测不到。

唯一可靠路径是 UIWindow.sendEvent 旁路截获（UIWindow 接收所有 touch
event 无论 in-flight 还是新 touch）。daoqi msext 也是这条路。

## Combine 引入

VoiceRecorder 用 ObservableObject + @Published 给 SwiftUI 数据绑定，
需要 import Combine。CLAUDE.md「避免 Combine」精神是禁用 Publisher 链
替代 async/await，不是禁止 ObservableObject（iOS 15.6 无 @Observable
宏可替代）。已在 VoiceRecorder.swift 注释说明。

## 验证

BuildProject 通过 0 错误，全部新文件 XcodeRefreshCodeIssuesInFile 0 诊断。
 2026-06-24 01:29:04 +08:00
joywayer 5b38456c66 3.B：vendor opencore-amr + AMRCodec Swift wrapper，打通 AMR↔WAV 编解码 
为支撑 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 诊断。
 2026-06-24 01:20:30 +08:00
joywayerandClaude Opus 4.7 5f3a435180 Phase 6 commit C：backgameData pop + getWebdata 反向 callback 
- 新增 Source/Bridge/Handlers/BackGameDataHandler.swift（仅 SubGameViewController 注册）：
  - 调 AudioPlayer.stopAllBackground 停背景音
  - AppCoordinator.popSubGame(returningData:) → popViewController + 发 .subGameDidReturn
  - data 兼容 string / object（非字符串走 JSONSerialization 序列化透传）
  - 字面 cb "backgameData"（msext gameController.m:691-709 等价，
    WXApi 清理跳过 — 微信 SDK 待 Phase 4.E）
- AudioPlayer.stopAllBackground：无条件停背景音（msext 不看 type 直接 nil 行为）
- SubGameViewController.registerBridgeHandlers：挂上 BackGameDataHandler，
  注释更新 exitRoom/getVideoinfo/createRoom 推迟到 Phase 8
- WebContainerViewController：在 setupExternalSubscriptions 挂 .subGameDidReturn
  观察者 → bridge.call("getWebdata", .string(data))，teardown 时 removeObserver
  （生命周期与 battery/network/appservice 同一对，子游戏栈顶时大厅已 teardown
  避免双发）
- Plan §5.6.3 / 6.5 / 6.6 / §8 进度已勾选

至此 SwitchOverGameData → push 子游戏 → backgameData → pop + getWebdata
完整链路接通；子游戏视频房间（exitRoom/getVideoinfo/createRoom）留待 Phase 8。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 21:05:23 +08:00
joywayerandClaude Opus 4.7 0602b9d4b6 Phase 3.A：srcIsloop 本地音频 + 3.B/3.C/3.D handler stub 
3.A 本地音频完整落地（与 msext NewRootVC initJSdata 等价）：

  Source/Audio/AudioPlayer.swift（@MainActor 状态机）：
    - playOnce(url) 单次按钮音；buttonPlayers 数组保活池避免多次点击
      互相打断（duration + 0.5s 后清理）
    - loopBackground(url, type:) 循环背景音；numberOfLoops = -1 +
      backgroundType 记录用于同名停止
    - stopBackground(type:) 同名校验后才停止（msext 同款语义）

  Source/Bridge/Handlers/LocalAudioHandler.swift：
    - 注册 srcIsloop handler（@MainActor enum）
    - 入参 src + isloop，按 0/1/-1 分支调 AudioPlayer.shared 对应方法
    - audioFileURL 路径：{Caches}/{gamedir}/{gamestart}/assets/wav/{src}
      与 msext NewRootVC 路径约定 1:1（H5 zip 内 assets/wav 子目录）
    - audioFileURL 标 nonisolated 因 SandboxPaths 是 nonisolated 静态
    - cb 字面 "Response from srcIsloop" 严格保持

  Source/Bridge/Handlers/RemoteAudioHandler.swift（3.B/3.C/3.D stub）：
    - prepareaudio + mediaTypeAudio 仅 cb 维持契约，无真实业务
    - 待 Phase 3.B（opencore-amr .a 接入）+ 3.C（七牛 SPM + token）+
      3.D（远端播放）完整后升级
    - 按 CLAUDE.md 原则 A：H5 调啥就得有人接，即使是 stub

WebContainerViewController.registerBridgeHandlers 接入：
  - LocalAudioHandler.register（完整实现）
  - RemoteAudioHandler.register（stub）

Plan §5 Phase 3.1 勾选；3.2 真机验证留待 H5 提供音频文件后做。

Verification-Checklist.md 新增 Phase 3 章节：
  - H. 本地音频（E.14-E.16 srcIsloop 三个 isloop 值）
  - I. prepareaudio / mediaTypeAudio stub（E.17 E.18）

BuildProject 通过

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-06-22 19:11:34 +08:00