Godot 剧情 Cutscene 编排：AnimationPlayer、Timeline 和可跳过流程

剧情演出不是一段动画播完

Godot 做剧情 cutscene 时，很容易把镜头、角色动作、音效、对话都塞进一个 AnimationPlayer。时间轴从 0 播到 30 秒，演出看起来完成了。上线后会遇到很多边界：玩家跳过怎么办，资源没加载怎么办，字幕和语音怎么同步，演出中断后角色状态如何恢复，联网游戏里能不能暂停，镜头接管结束后回哪里。

Cutscene 是一段受控流程，而不只是动画。它需要进入前准备、播放中协调、跳过和失败恢复。AnimationPlayer 可以承载时间轴，但不应该独自承担所有业务状态。

stateDiagram-v2
    [*] --> Preparing
    Preparing --> Playing: 资源和场景 ready
    Playing --> WaitingChoice: 需要玩家选择
    WaitingChoice --> Playing: 选择确认
    Playing --> Skipping: 玩家跳过
    Playing --> Finished: 自然结束
    Skipping --> Restoring: 应用最终状态
    Finished --> Restoring
    Restoring --> [*]

演出入口要先锁定上下文

进入 cutscene 前，客户端要确认当前场景允许演出、相关角色存在、相机可接管、必要资源已加载、玩家输入将被切换。不要在玩家还处于战斗技能中途时直接播放剧情，除非剧情设计就是打断。

准备阶段可以预载角色动作、语音、特效、字幕文本和镜头路径。预载失败时，选择降级还是阻止演出。主线剧情关键演出可以显示加载，支线小演出可以跳过某些语音或特效。

进入演出后，保存需要恢复的状态：玩家输入上下文、相机状态、角色控制权、UI 可见性、背景音乐。结束或跳过时按这个记录恢复。不要只在自然结束回调里恢复，因为玩家可能跳过或场景卸载。

AnimationPlayer 负责时间点，Sequencer 负责流程

AnimationPlayer 很适合驱动镜头位置、角色动作、音效事件、淡入淡出。Sequencer 则负责流程：准备、播放、暂停、等待选择、跳过、结束、恢复。两者分工后，时间轴不会变成业务逻辑仓库。

动画轨道可以调用轻量事件，比如“播放脚步声”“显示字幕 key”“切换镜头 marker”。但奖励发放、任务完成、场景切换这类业务动作最好由 Sequencer 在明确阶段执行。否则跳过演出时，很难保证这些业务动作也正确发生。

如果演出中有分支选择，AnimationPlayer 的线性时间轴不够。可以把 cutscene 拆成多个段落，每段一个 timeline。玩家选择后，Sequencer 决定下一段。这样结构更清晰。

跳过不是直接 stop

玩家跳过剧情时，不能简单 animation_player.stop()。演出可能已经隐藏 UI、移动角色、切音乐、打开门、设置任务状态。跳过应该进入 Skipping 流程：停止音频和动画，应用演出的最终状态，恢复输入和相机，触发必要业务结果。

最终状态要显式配置。比如门应该打开、NPC 应该站到目标位置、任务节点推进、玩家位置是否改变。不要依赖动画播放到了最后一帧。跳过就是从当前状态直接应用 final snapshot。

有些演出不能跳过，或者首次观看不能跳过。UI 要明确。即使不能跳过，也应允许暂停或打开设置，取决于平台要求。

字幕、语音和对话要同步

Cutscene 里的字幕通常由时间轴触发，但语言不同，语音长度不同。可以让 Sequencer 按字幕事件显示文本，AudioService 播放语音，并在需要时等待语音结束。纯时间轴硬编码 3 秒后下一句，在多语言下很容易错。

字幕和对话历史也要记录。玩家跳过后，是否能在日志里回看？如果剧情含关键信息，最好保存已显示文本。跳过整段时，可以把关键摘要加入日志。

语音缺失时，演出不应卡死。等待语音的节点要有超时或文本阅读时间回退。

镜头接管要可恢复

剧情镜头会接管 Camera2D/Camera3D。接管前记录原相机状态，演出中由 timeline 或 camera rig 控制，结束后平滑回到 gameplay 相机。不要直接删除或替换相机节点，让 gameplay 系统找不到引用。

如果剧情过程中玩家切后台或场景卸载，恢复逻辑仍要执行。Camera request 带 owner，结束时释放 owner，是比较稳的做法。

调试和验收

Cutscene 要有调试面板：当前段落、时间、等待事件、可跳过、已加载资源、当前相机 owner、最终状态配置。演出 bug 往往发生在跳过、中断和多语言，调试信息能快速定位。

验收不要只看自然播放。还要测试：刚开始跳过、中途跳过、等待选择时跳过、语音缺失、资源加载失败、切后台恢复、重复播放。剧情越重要，边界越要测。

小结

Godot cutscene 应该由 Sequencer 管流程，AnimationPlayer 管时间点。进入前准备资源和上下文，播放中协调字幕语音镜头，跳过时应用最终状态，结束后恢复输入和相机。这样剧情演出既能做出节奏，也能在玩家跳过和异常恢复时保持游戏状态可信。
我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。

我会为每段剧情配置 final snapshot，并在测试工具里提供“从任意时间点跳过”按钮。只要任意时间点跳过都能恢复到正确状态，剧情系统就比单纯播完时间轴可靠得多。