【聚光灯21天】DAY17–19·从能玩到能上线:音效动效配音重做

一、DAY 17:配音换了口径

旧口径的问题

chensheng_c0_0-1_s1.ogg    ← 事件 0-1 的第 1 段
chensheng_c0_0-1_o1.ogg    ← 事件 0-1 的第 1 个选项结算

新口径:整段合并

intro                → chapter.intro 全部段合并成一条
<事件id>             → event.segs 全部段合并成一条
choice_<ACT-id>      → 抉择卡 segs 合并成一条
choice_<ACT-id>_o<N> → 抉择卡第 N 个选项的结算
ending_<E>[_<变体>]  → 结局「太史公曰」
crisis_<C-id>        → 危机事件
corr_<N>             → 历史修正

这是"少即是多"的取舍:选项结算往往只有一两句,单独念反而打断节奏;
随机事件数量多、单条短,配上反而聒噪。

目录结构也跟着改

voice/<剧本>/<章cN>/<切片>          本章的
voice/<剧本>/_shared/<切片>         跨章共享的(choice_/ending_/crisis_/corr_)

一条不维护清单的设计(沿用)

查不到就是没这条配音;这也是用 glob 而不是「预生成 index.json」的原因 ——
清单会漂移,glob 不会。

四条现实约束(决定了写法)

1. 缓冲窗口只有几百毫秒 → 必须提前把切片拉下来,不能播到哪下到哪
2. 串行播放,不能并发 → 并发拉全表会把连接池打满、拖慢正在播的那条
3. 语音要盖住 BGM → 靠基准音量差(配音 0.8 / BGM 0.6),不做压低联动
4. 页面不可见不念 → visibilitychange 隐藏时暂停当前句、队列挂起,
   回前台从断点续播

四首主题曲换新词

五剧本图标

二、DAY 18:第三条音频通道 + 一个防软锁

音效系统(game/sfx.ts)

原本另备一套 m4a 是为 Safari 兜底,目标平台 TapTap 容器的 WebView 支持 opus,不值得付双份体积。

引擎:财富见底锁(2026-10-16 拍板)

js
Game.prototype._caifuBroke = function () { return (this.attrs.caifu || 0) <= 0; };
Game.prototype.CAIFU_LOCK_REASON = '财富见底，无力为之';

1. UI 锁(展示层,灰显 + 理由)
2. 引擎兜底(UI 锁只是展示层,引擎不依赖 UI 防御)
3. 抉择卡同口径

钱不够不是险招,直接锁 —— 险招是赌属性,支付能力没得赌。

数据实测存在「全部选项都扣财富」的事件(陈胜 R-1、韩信 R-7)。

顺带修的一处记账 bug

js
// 用 += 而非 =：同一章可能两次触顶（钳到 95 后又涨过 100），
// 覆盖写会让第二次的回落从结算里消失。

钳制记账一并清零:回溯把 attrs 退回章首快照,那次回落已随 attrs 撤销。
不清的话,章末结算会再报一次玩家从未经历的危机下降。

三、DAY 19:动效体系

先摸底,再动手

四批全落地

一处值得记的实现

印章抽取(data/seals.ts)

抽到这里避免 game 层反向 import ui 层。

罗盘巡游测试(tests/wheel.cjs)

加速参数(页内钩子):
- __QS_WHEEL_AUTO_IDLE__  = 800ms(默认 20000)
- __QS_WHEEL_AUTO_SPEED__ = 240°/s(默认 3°/s)

动线:主菜单 → 「开 始 游 戏」→ 选择页,之后不操作,等巡游自动选中。
归位后「明」离左上触发区最近(27°),第一个自动选中的必是它。

四、三天的数据

五、三天最值钱的三条

① 配音"按段切"到"按整段合并",是节奏问题不是技术问题

② “钱不够不是险招,直接锁”

险招是赌属性,支付能力没得赌。

③ 加动效时,测试零改动是可以做到的

明天

1. 配音真机验收 —— 整段合并后的播放节奏、_shared 回落
2. 音效真机验收 —— 连发场景(快速连点)的池化表现
3. 上线素材 —— 封面已出(COVER_HORIZONTAL/VERTICAL),待补截图与宣传图
4. 成就图标 64 缺失 —— 仍待 P3 美术批次
5. voice.cjs 偶发红(单跑复绿,与动效无关)—— 待定位