聚光灯上海场复盘：十万积分打水漂，手机端不支持视频播放的血泪
精华03/31125 浏览开发日记 包含 AI 合成内容
作者：浠涫
开发引擎：TapTap Maker (UrhoX)
项目：方格屋
赛事：聚光灯24小时gamejam · 上海场
一、事情经过
聚光灯上海场，24小时 GameJam。
我参加了现场开造。游戏是一个叙事驱动的舒尔特方格游戏——玩家扮演一个能感受到他人情绪的主角，通过方格训练帮助三位来访者（阿尔茨海默症老人、ADHD 儿童、抑郁症大学生）。
为了追求最好的叙事体验，我在序章做了 11 段 AI 生成的视频，标题页做了循环背景视频和开门过渡视频。视频画面跟着对话走，每行文字都有对应的场景——教室、情绪烟雾、方格屋的木牌……
桌面预览效果非常好。视频播放流畅，首尾帧衔接丝滑，双播放器预加载零延迟切换。我甚至做了 3 秒超时降级机制，视频加载失败自动切到纯文字模式。
一切看起来都很完美。
直到最后一天，我准备做手机适配测试。
二、发现问题的那一刻
手机端打开游戏，标题页没有视频——只有一张静态图和报错
我以为是加载慢，等了 10 秒，还是静态图。
打开日志：
[Title] 标题页已构建, 视频支持=false, 标题视频=false
Video.isSupported = false
。
手机端不支持视频播放。
我查了引擎文档，确认了：TapTap Maker 的 VideoPlayer 组件仅在 WASM（网页端）支持，手机端完全不支持。
这意味着：
标题页的循环背景视频 → 手机上看不到
开门过渡视频 → 手机上看不到
序章的 11 段叙事视频 → 手机上看不到
总共 13 段视频，花了大约 10 万积分，在手机端一个都播不了。
三、为什么没早点发现
3.1 开发全程在桌面端预览
TapTap Maker 的预览默认在浏览器中运行（WASM），视频播放完全正常。我从头到尾都在桌面端开发、预览、调试，从来没有在手机上测试过。
3.2 文档里其实写了
翻回引擎文档，关于 VideoPlayer 的说明里确实提到了"仅 WASM 平台支持"。但我在开发时没有仔细看这一行——因为桌面预览一切正常，我就默认手机端也能用。
3.3 时间压力下的选择性忽略
GameJam 24小时，时间紧。视频系统是我投入最大的模块（11 段视频 + 双播放器预加载 + 时序同步），占了总开发时间的三分之一。在时间压力下，我选择了"先做出来再说"，没有做跨平台验证。
四、匆忙上线
发现手机端不支持视频的时候，距离提交截止已经不到 2小时了。
我没有时间重新设计序章的叙事体验。fallback 机制虽然能保证游戏不崩溃（3 秒超时自动切到纯文字 ADV 模式），但纯文字模式的效果和视频模式差距太大了——相当于花了三分之一开发时间做的系统，在手机上直接被跳过。
更糟糕的是，匆忙上线还带了其他 bug：
特效位置偏移：NanoVG 和 UI 的坐标空间不一致，手机端特效飘到格子外面
自由练习无反馈：只用 onClick（touchend 触发），按下没有视觉反馈，手机端体验很差
UI 错位：cellSize 用固定像素值，小屏手机上方格溢出屏幕
这些 bug 在桌面端都不明显（桌面端屏幕大，偏移和溢出看不出来），但手机端一测就全暴露了。
五、经验总结：给后来者的 5 条建议
建议 1：第一天就做手机端测试
不要等到最后一天。GameJam 开始后，第一件事应该是：在手机上打开预览，确认基础功能正常。
视频、音效、UI 布局——这三个东西在桌面端和手机端的差异最大。越早发现，越有时间调整。
建议 2：先确认平台限制，再决定技术方案
如果我在第一天就查了 VideoPlayer 的平台支持情况，我就不会在视频系统上投入三分之一的时间。我会选择纯代码动画（Tween + NanoVG）来做叙事效果——虽然视觉效果差一些，但至少手机端能用。
技术选型的优先级应该是：平台兼容性 > 视觉效果 > 开发效率。
建议 3：fallback 不是保险，是底线
我做了 3 秒超时降级机制，这保证了游戏不会崩溃。但 fallback 的体验和正常体验差距太大了——纯文字 ADV 模式和视频叙事模式完全是两个游戏。
真正的保险是在设计阶段就考虑好"如果这个功能不可用，整体体验是否还成立"。 如果去掉视频，游戏的核心玩法（舒尔特方格）和叙事（对话文字）仍然完整，那视频就是锦上添花。但如果叙事体验严重依赖视频，那就要重新考虑方案。
建议 4：手机端适配要留足时间
手机端适配不是"最后调一调 UI 就行"。它涉及：
分辨率适配（不同屏幕尺寸）
触摸交互（touchstart vs touchend vs click）
平台 API 差异（Video、Audio 等）
性能（手机端 CPU/GPU 远弱于桌面）
建议至少留 20% 的总时间给手机端适配。24 小时的 GameJam，至少留 5小时。
六、最后说两句
聚光灯的现场氛围确实很好——周围都是人在疯狂敲代码、调 AI、做素材。那种"大家一起造东西"的感觉很上头，容易让人沉浸在桌面端的完美预览里，忘记最终产品是要在手机上玩的。
10 万积分打了水漂，心疼吗？心疼。但教训是真的。
如果你也在准备 GameJam，记住一句话：第一天就在手机上跑一遍。