以后再做奖励音游：时间线、判定与设备校准

如果后续决定做奖励音游，先在独立练习项目测试；本课不表示该玩法已正式立项或已经实现。准备一段有许可的短节拍音频、一个按键、一条轨道和简单结果文本。先不做华丽谱面、长按键、多难度和联网排行，目标是让相同输入得到可解释的时间误差。

最关键的问题不是音符够不够漂亮，而是音频、画面和判定是否使用一致时间。若三者各自累加帧数，电脑一掉帧，玩家看到与听到的节奏就可能分开。

用秒记录每个音符的目标时间与轨道，按时间排序。固定 BPM 的练习可用“第 n 拍时间 = 起始偏移 + n × 60 / BPM”生成；出现变速时需分段换算，不能拿一个 BPM 套完整首歌。谱面起始偏移是音乐内容对齐，不等于玩家设备校准值。

画面根据“目标时间减当前歌曲时间”计算音符位置，而不是每帧随便减固定像素。先用几次固定间隔的敲击验证对齐，再接正式音频；这些公式是设计说明，不是已经在本机引擎验证的音游实现。

Godot 官方音频同步教程提供系统时钟补偿和音频播放位置补偿的思路：播放位置可结合距上次混音的时间，再考虑输出延迟。不要把调用 play 的那一刻直接视为扬声器已出声。相关 API 应结合实际音频后端和设备验证，不承诺样本级精确。

注意该官方 4.7 教程页面标有尚未更新完成的提示，应把它作为原理参考，并对照当前类文档实测。系统时钟与音频时钟可能长期漂移；也不能用一个“只许时间前进”的修补，掩盖暂停、重播和 seek 后应重置基准的问题。

按键事件到来时取得同一时间基准下的输入时间，寻找允许窗口内、尚未结算的目标。定义误差为“校正后的输入时间减目标时间”，负值代表提前，正值代表偏晚。判定阈值是设计参数，应通过测试确定，不把某组毫秒值当通用标准。

一次按键通常只结算一个目标，命中或漏判后都标记已处理，避免同一音符连续加分。忽略键盘长按回显，并明确多目标重叠时的选择规则。可视化显示目标、实际输入和误差，先让调试信息解释结果，再优化动效。

做简单的重复点击校准，记录多次误差并观察稳定性，给玩家重试与手动微调。若记录显示一贯晚到，可按已明确的符号约定减去补偿值；必须用可听、可看的测试验证方向，不要凭感觉加一个负号。个人反应、设备延迟和节拍对齐问题不能完全靠一次点击区分。

校准值应与谱面偏移独立保存。更换蓝牙耳机、显示设备或音频输出后提示重新检查，而不是硬套旧值。过低音频缓冲也可能带来破音，不应为了数字更小就盲目降低设置。

用同一短谱测正常运行、降低画面帧率、暂停恢复、重新开始、切换输出设备。确认不会因卡一帧丢掉全部待判定音符，不会暂停时继续扣分，也不会重开后沿用旧的已结算列表。保留每次测试的误差记录与设备信息。

最后决定它是否适合作为可选奖励：退出、重试和结果反馈都要清楚，不能不经设计就用音游成绩锁住核心剧情。若时间一致性仍不可靠，应继续独立验证，而不是把问题埋进主游戏后靠放宽所有判定掩盖。