VAT on Last Stand

3D球场项目 (五)

Sat, 30 May 2026 22:40:08 +0800

3D球场项目 (四) 把服务端推到了线上：导演 Agent 把每个 Point 切成 SERVE / RALLY / CONCLUSION 三段，配齐了动作、机位、位置、比分、解说，按 seq 单调下发到客户端。本篇回到客户端，看 Cocos 这一侧拿到 Script 之后，是怎么把它变成屏幕上一拍接一拍的比赛画面的。

整个客户端改造分四层落地，本篇只讲和 3D 球场主干业务直接相关的内容：

CocosEngine 层：场景加载架构升级（进度 / 传参 / Delegate¹ 回调 / JSBridge² 内存语义）；
MagicDanmaku 层：3D 球场的核心业务代码（数据流、状态机、动画 / 球轨迹 / 相机 / 观众）；
MagicDanmaku iOS 层：场景加载回调的演化，以及 CocosPlayer 在调用链里的角色；
业务层：腾讯体育 App 的 SwiftUI³ 视图把上面三层包成一个标准组件。

每一层和业务流程脱钩的内容（性能优化、稳定性 / crash 修复、构建工程化）统一抽到了 3D球场项目 (六)：客户端工程化与优化。

下面这张图先把四层的位置关系和数据流向摆出来，读者可以把它当作整篇文章的导航—— 箭头是数据流方向（服务端 Script 自顶向下灌进引擎、引擎事件自底向上回到 SwiftUI），每个节点旁标了对应章节：

3D球场项目 (六)：客户端工程化与优化

Sun, 31 May 2026 09:00:00 +0800

3D球场项目 (五) 把客户端的核心业务流讲完了：Native 推送 → DataManager 队列 → ScenePlayer 章节调度 → GameController 状态机 → Handler → 渲染层。功能闭环跑通之后，真正的硬仗是 “工程化"和"性能”——前者保证项目能稳定上线（编译跑通、退出不崩、Swift 调用顺手），后者保证在中低端机上画面流畅。

第一版上线时遇到了两类问题：

稳定性 / 工程化：modulemap 编译报错、lipo 架构冲突、A11 设备启动 crash、 Cocos 退出期 OpenAL 资源竞争 crash……这些都不是"画面卡"，但每一个都能让用户体验归零；
性能：中端 iPhone 在比赛回合渲染期间，GPU 和 CPU 都偶尔抖到 80%+，帧率掉到 30 fps 出头。

本篇按这两类拆成两部分，所有改动都遵循一条原则：不动玩法，只把工程问题和帧时间解决掉。

架构改动一览

3D球场项目 (二) 介绍过弹幕引擎的四层架构（腾讯视频 APP / MagicDanmakuiOS / MagicDanmaku / cocos-engine）。这一阶段 每一层都动了——3D 球场不是单点改造，而是一次自上而下的纵贯。下面这张图是把 PartTwo 那张原始架构图重画一遍，改动的节点用蓝色、新增的节点用绿色，没动的节点保持白色：