joywayerandClaude Opus 5
3f8b382ad3
现象：大厅 H5 能正确拿到定位，子游戏拿不到。已静态排除「子游戏未注册 handler」与「回调错发给大厅」两个猜测（BridgeBus 是 per-WebView 实例、 handlers 是实例状态，反向 call 捕获各自的 bridge，物理上不可能串台； 下载真实子游戏 zip 比对后确认 H5 侧大厅/子游戏逻辑完全对称）。 为定位真正的失败层，在各组件边界加日志（纯诊断，不改任何行为）： - BridgeBus 加 label（lobby / subGame）区分来源，记录 ← H5 调用、 → H5 反向 call、native handler 未注册、evaluateJavaScript 失败 - sendToJS 改为返回 'ok'/'no-bridge'，H5 侧 bridge 未就绪导致的静默丢包 现在会打错误日志（原实现 `if (window.X)` 直接丢弃，完全不可见） - LocationService 记录 requestOnce 序号 / shared manager id / requestLocation 的 BOOL 返回值 / completionBlock 是否回来 / stop() 调用 —— 高德文档明确 requestLocation 返回 NO 时 completionBlock 永不调用， 当前代码忽略该返回值会让 continuation 永挂，H5 连 errorCode 12 都收不到 - H5ErrorRelay 补 console.warn 中继，让 WVJB「H5 侧无对应 handler」的 warn 能出现在 Xcode console 契约影响：无。仅新增日志与可选 label 参数，桥接接口名 / 字段名 / 数据结构 均未变动（docs/H5-Native-Contract.md §3.1［20］/ §3.2［6］不变）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UMPCLfsuxvwgMotzsb67QH
84 lines
4.6 KiB
Swift
84 lines
4.6 KiB
Swift
//
|
||
// BackGameDataHandler.swift
|
||
// ylgamehall
|
||
//
|
||
// H5 → Native handler：backgameData — 子游戏退出并把数据回传给大厅。
|
||
// 契约：docs/H5-Native-Contract.md §3.1 ［18］
|
||
//
|
||
// 与 msext gameController.m:691-709 等价：
|
||
// 1) 停背景音（无条件，与 stopBackground 不同 — msext 不看 type 直接 nil）
|
||
// 2) AppCoordinator.shared.popSubGame(returningData: data)
|
||
// 内部 popViewController + 发 .subGameDidReturn 通知，由大厅监听后
|
||
// 回调 H5 `getWebdata` 完成反向闭环
|
||
// 3) responseCallback("backgameData") 无论 data 是否解析成功都回（msext 字面）
|
||
//
|
||
// ⚠️ 仅注册到子游戏 SubGameViewController；大厅 WebContainerViewController 不注册。
|
||
// H5 大厅页若误调 backgameData 会落空（bridge 无对应 handler → JS 端的 callback 直接卡），
|
||
// msext 同款行为 — 这是契约边界，不在原生侧兜底。
|
||
//
|
||
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
// SDK 清理钩子状态（每接入新 SDK 都必须确认或新增）：
|
||
//
|
||
// ✅ Phase 4.E 微信：新版 SDK（2.x）无 static delegate API，逐次调用 handleOpenURL/sendAuthReq
|
||
// 时传入并被 SDK 弱引用；WeChatManager singleton 长生命周期，子游戏 pop 不析构，无需清理
|
||
// ✅ Phase 5 高德定位：`LocationService.shared.stop()`（已加，canImport 守卫，
|
||
// Xcode Embed AMapLocationKit 后激活）
|
||
// ⏳ Phase 3.B/C/D 录音 / 七牛上传：`AudioRecorder.shared.cancel()` 待 opencore-amr
|
||
// 接入后取消注释；`QiniuUploader.cancelInFlight()` 依赖 Task.cancel 传播无需显式调
|
||
// ⏳ Phase 8 Agora（若未来重启视频）：`agoraKit.leaveChannel(...)`
|
||
// （目前 VideoRoomHandlers 是 stub 无需清理）
|
||
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
//
|
||
|
||
import Foundation
|
||
|
||
public enum BackGameDataHandler {
|
||
|
||
public static func register(on bridge: any BridgeProtocol) {
|
||
// 【18】backgameData
|
||
// 入参 data（字符串，子游戏 H5 自定义透传给大厅 getWebdata）
|
||
// cb: "backgameData"
|
||
bridge.register("backgameData") { data, callback in
|
||
await MainActor.run {
|
||
// data 可能是 string / object，统一序列化为 string（msext NSString 透传等价）。
|
||
// - 直接是 .string → 取字面
|
||
// - 其它类型 → JSON 序列化（保留对象结构传给大厅 H5）
|
||
let payload = serialize(data)
|
||
|
||
// 子游戏 push 期间挂载的 SDK 资源在 pop 前显式清理（避免 delegate 悬挂 /
|
||
// 后台任务残留），与 msext gameController.m:691-709 + cleanUpAction 等价。
|
||
AudioPlayer.shared.stopAllBackground()
|
||
|
||
// 微信 SDK 1.8.2 delegate 通过 sendAuthReq:viewController:delegate: 或
|
||
// handleOpenURL:delegate: 逐次调用时传入并被 SDK 弱引用。WeChatManager
|
||
// 作为 shared singleton 长生命周期持有，子游戏 pop 不会让它析构，无悬挂回调风险。
|
||
// msext gameController.m:699 的 [WXApi setDelegate:nil] 是 1.x 早期 API，
|
||
// 1.8.x 之后已废弃，不需要清理。
|
||
|
||
#if canImport(AMapLocationKit)
|
||
// msext gameController.m:2473-2478 cleanUpAction 等价
|
||
LocationService.shared.stop(caller: "backgameData")
|
||
#endif
|
||
|
||
// Phase 3.C 录音 / Phase 3.B 七牛上传 清理（QiniuUploader.cancelInFlight 当前
|
||
// 依赖 Task.cancel 传播；AudioRecorder 待 opencore-amr 接入后激活清理）
|
||
// AudioRecorder.shared.cancel() // ← Phase 3.C 接入时取消注释
|
||
|
||
AppCoordinator.shared.popSubGame(returningData: payload)
|
||
}
|
||
callback?(.string("backgameData"))
|
||
}
|
||
}
|
||
|
||
private static func serialize(_ data: BridgeData?) -> String {
|
||
if let s = data?.asString { return s }
|
||
guard let data else { return "" }
|
||
let any = data.jsonObject
|
||
if let bytes = try? JSONSerialization.data(withJSONObject: any, options: [.fragmentsAllowed]),
|
||
let s = String(data: bytes, encoding: .utf8) {
|
||
return s
|
||
}
|
||
return ""
|
||
}
|
||
}
|