# 第二篇：动作、奖励与回忆录

[教程总入口](../README.md) · 上一篇：[基础编排](01-basics.md) · 下一篇：[导出与部署](03-publishing.md)

在第一篇导入的副本 `tutorial-001-copy` 中操作。此前的对应工程是 `chapter-001-restore-test`。本篇先单独测试每项功能，最后接回主线；不要删除原先验证好的开场和分支。

新增视频节点不必重新导入同一视频：素材卡片“添加节点”可以生成多个节点，共用本章的一份素材。

## A01 添加动作训练片段

1. 从素材库给庭院视频 `1-提示-探索庭院-1.mp4` 再添加一个视频节点，命名 `动作训练`。
2. 不改全章入口，先保持原开场为入口。
3. 选中训练节点，等视频时长加载出来，确保素材至少超过 5 秒。

示例用庭院镜头验证交互逻辑；正式剧情可以换成相应闪避/格挡镜头。

**验收**：训练是独立视频节点，视频能播放。建议回复：`已添加动作训练`。

## A02 准备成功与失败片段

1. 用交锋视频新增 `动作成功`；用汇合视频新增 `动作失败`。
2. 确保训练、成功、失败是三个不同的节点。可以共用媒体，不能把三个目标都指向同一节点。
3. 为方便当前测试，成功和失败暂设为剧情结局。

**验收**：三个节点均存在且素材有效。建议回复：`成功失败片段已准备`。

## A03 配置限时动作

1. 选 `动作训练`，右侧“剧情功能”点“⚡ 动作 / 奖励 / 回忆录”。
2. 选“动作判定”，填写下表并“应用配置”。

| 字段 | 示例值 |
| --- | --- |
| 按钮名称 | 闪避 |
| 动作按钮图片 | 圆点.png |
| 出现时间（秒） | 1 |
| 消失时间（秒） | 5（不得超过当前素材时长） |
| 点击成功 → | 动作成功 |
| 未操作失败 → | 动作失败 |

3. 生成后在节点列表能看到“闪避”和“未操作 → 失败”。后者是无画面的条件路由节点，不需要给它选视频。

应用动作向导会替换宿主的自动后继，但保留原交互。独立训练节点更容易避免其他选项抢先跳走；重新应用同一动作向导会更新受其管理的规则。

**验收**：训练节点下有动作按钮及失败路由，成功/失败目标正确。建议回复：`动作判定已配置`。

## A04 分别验证成功与失败

1. 选训练节点，“试走剧情”，在 1–5 秒内点击闪避，确认进入 `动作成功`。
2. 返回“布局编辑”，重新选训练，再试走一次，这次不点击。
3. 5 秒后按钮消失，等训练视频自然结束，确认进入 `动作失败`。

**准确语义**：消失时刻关闭点击窗口；失败跳转发生在视频结束，而非到 5 秒立即跳转。若要即时失败，先把动作素材裁成以判定窗口结束为片尾的独立片段。

**验收**：窗口内点击成功，不点最终失败。建议回复：`动作成功失败都正常`。

## A05 配置失败重试

1. 选 `动作失败` → 剧情功能 →“失败重试”。
2. “重新开始的动作片段”选 `动作训练`，重试按钮图片选 `圆点.png`，应用。
3. 向导会取消失败片段的结局标记，在片尾显示“重新挑战”。
4. 再走一次失败路线，等片尾点击重试；回到训练后这次点击闪避。

每次重新进入训练片段都会重置动作判定变量，不应手工把这个变量固定为成功。

**验收**：失败 → 重试 → 训练 → 成功可走通。建议回复：`失败重试正常`。

## A06 配置一次性奖励

1. 选 `动作成功`，取消“设为剧情结局”，不添加自动视频后继，避免奖励出现前离开。
2. 剧情功能 →“奖励点”，配置：

| 字段 | 示例值 |
| --- | --- |
| 按钮文案 | 解锁新回忆 |
| 领取 / 解锁变量 | practice_memory_1 |
| 未领取按钮图片 | 圆点.png |
| 已领取图片 | 可先留空，沿用原图 |
| 领取前观看激励广告 | 开启 |
| 数值奖励变量 | 练习积分 |
| 增加数值 | 5 |
| 领取后 / 已领取再次点击 → | 先选“留在当前画面” |

3. 应用后生成未领取和已领取两个互斥的图片交互。可选中各节点调整位置与出现时间，避免和其他交互重叠。

**验收**：奖励向导字段正确，解锁变量和积分变量已登记。建议回复：`奖励点已配置`。

## A07 验证奖励只发一次

1. 为测试首次领取，在右侧底部“工程变量 / 预览状态”→“试走存档”→“清空试走存档”。这会清除当前浏览器编辑器的试走变量，不会改工程默认值或线上游戏存档。
2. 选成功片段开始试走，点击解锁按钮。
3. 先模拟广告取消，再重试并模拟失败。通过“工程变量 / 预览状态”检查：解锁仍为 0，积分仍为 0。
4. 模拟观看完成，检查解锁变为 1，积分变为 5，界面切换为已领取状态。
5. 重进成功片段或刷新后再试走，不能再次增加积分、不能要求再次看领取广告。

重新试走会读已有存档，不等于第一次游玩。测试记录中要写清是否先清过试走存档。

**验收**：取消/失败不发奖；完成加 5，重复进入仍为 5。建议回复：`奖励测试正常`。

## A08 登记一个回忆

1. 用汇合视频再建独立节点 `回忆片段`，关闭循环，不勾结局。
2. 选这个节点 → 剧情功能 →“登记回忆”。
3. 回忆名称填 `庭院回忆`，解锁变量填 `practice_memory_1`，回放入口选 `回忆片段`。
4. **关闭“进入当前片段时直接解锁”**，提示图片暂留空，应用。

登记的作用是定义回忆及回放跳转点。此练习由广告奖励负责解锁；若保留直接解锁，就会绕过奖励条件。不要复制以前工程的跳转点 ID，应由当前工程生成。

**验收**：入口被标记为跳转点，回忆使用与奖励相同的变量，没有进入即授奖规则。建议回复：`回忆已登记`。

## A09 添加回放返回按钮

1. 选 `回忆片段` → 剧情功能 →“返回按钮”。
2. 选 `圆点.png` 并应用，生成“返回上一画面”。
3. 根据需要把按钮放在左上角。这里暂不把它连接到固定章节或固定视频。

返回按钮使用客户端原生的上一画面记录。直接从回忆片段开始试走没有来源画面，此时无法验证返回；下一步从卡片进入再测试。

**验收**：返回交互已生成并挂在回忆入口下。建议回复：`返回按钮已添加`。

## A10 添加同章回忆录卡片

1. 用庭院视频再建节点 `回忆录`，不设结局，不加自动视频后继。
2. 选它 → 剧情功能 →“回忆录卡片”。
3. “已登记回忆”选本章的 `庭院回忆`。未解锁、已解锁图片可以先都选 `圆点.png`，正式制作换成不同图片。
4. 应用后生成可回放卡片、禁用卡片和回放跳转节点。

布局编辑用于摆放，会显示条件不同的两个卡片，它们可能重叠；判断“解锁前后互斥”应进入试走。正式运行时未解锁卡片不可点击。

**验收**：卡片指向刚登记的回忆，解锁条件来自 `practice_memory_1`。建议回复：`回忆录卡片已添加`。

## A11 验证同章完整流程

1. 清空试走存档，选 `回忆录` 开始试走：卡片应是未解锁状态，不可点击。
2. 返回编辑，从 `动作成功` 试走并完成广告奖励。
3. 返回编辑，再从 `回忆录` 试走：卡片应可点击。
4. 点击卡片进入回忆片段，再点返回按钮：回到来源回忆录。

这套示例是单段回放。多段回放遵循客户端上一视频链，返回可能逐段返回，不能假定末段一次返回必然回到回忆录首页。

**验收**：未解锁不可点、奖励后能回放、返回正确。建议回复：`回忆录完整流程正常`。

## A12 添加解锁提示片段

1. 用汇合视频再新增 `解锁提示`，素材最好长于 3 秒，暂设为结局。
2. 选 `解锁提示` →“登记回忆”。回忆名称继续用 `庭院回忆`，变量必须仍是 `practice_memory_1`，入口仍选 `回忆片段`。
3. 关闭“进入当前片段时直接解锁”，提示图片选 `圆点.png`，应用。

同一解锁变量会更新已有回忆登记，把提示宿主移到此片段，不是另建一个无关回忆。向导生成顶部提示交互，进入后约 0.001 秒出现，3 秒消失；有解锁条件，且不可点击。

**验收**：新提示片段有“解锁新回忆 · 庭院回忆”交互，回放入口仍是原回忆片段。建议回复：`已添加解锁提示片段`。

## A13 连接奖励到提示

1. 选 `动作成功` → 剧情功能 →“奖励点”。
2. 保留原有广告、变量、积分等配置，只把“领取后 / 已领取再次点击 →”选为 `解锁提示`，应用。
3. 检查未领取和已领取两个奖励交互都连接到提示片段。不要直接把成功视频自动连接过去，以免跳过广告奖励。

**验收**：领取后路线指向提示，奖励变量仍只由领取成功设置。建议回复：`解锁提示已连接`。

## A14 测试提示

1. 清空预览存档，从成功片段试走。
2. 完成奖励广告，自动进入解锁提示。
3. 观察提示前 3 秒可见，随后隐藏；回忆解锁状态保持。

此处提示按“已解锁”条件显示，再次进入提示片段仍可能显示。若要只在首次解锁提示一次，需要另加独立提示已读变量，当前练习未配置这一规则。

**验收**：奖励成功后才走入提示，显示时长正常。建议回复：`解锁提示正常`。

## A15 新建独立回忆录章节

1. 保存主线副本。章节库中新建名为 `回忆录` 的章节，目录名 `tutorial-album`。
2. 记下它的实际章节 ID；不要把新章当作主线副本里的一个视频节点。
3. 素材库应为空，导入庭院视频和按钮图片。即使主线已有同样素材，新章也需自己导入首页和卡片所用资源。

**验收**：章节库多出独立回忆录工程，主线副本仍在。建议回复：`已新建回忆录章节`。

## A16 准备回忆录首页与跨章卡片

1. 庭院素材添加节点，命名 `回忆录首页`，设为本章入口，不设结局。
2. 首页 → 剧情功能 →“回忆录卡片”。在“已登记回忆”中选**主线副本**的 `庭院回忆`，注意区分同名章节。
3. 两种卡片图片都选本章已导入的图片，应用。
4. 检查生成的“回放 · 庭院回忆”跳转节点：跨章开启，目标为实际主线副本的章节 ID，跳转点为回忆登记生成的值。

此操作引用原章回放入口，不把回忆视频再次复制到回忆录章；回忆录首页和卡片图片则仍归本章独立管理。

**验收**：首页为入口，卡片明确指向主线副本。建议回复：`回忆录首页已准备`。

## A17 测试跨章回放与返回

1. 未解锁测试：清空预览存档，从回忆录首页试走，卡片应禁用。
2. 在章节库切回主线副本，选成功片段，试走并领取奖励。
3. 返回编辑，切回独立回忆录，选首页开始试走。不要清空存档。
4. 点卡片进入原章回忆片段，再点击该片段的返回按钮。
5. 应返回此次来源——独立回忆录首页，而不是固定回到同章回忆录。

预览变量保存在当前网站的浏览器存储中，同一编辑器站点可跨章共享；它不负责同步不同电脑或线上游戏。若同一域名/端口切换了另一个仓库，旧预览变量也可能保留，测试新练习时应明确处理存档。

**验收**：跨章进入、返回和解锁状态正确。建议回复：`跨章回放返回正常`。

## A18 把动作训练接入原主线

1. 回到主线副本，选 `03 / 回归主线`，取消“设为剧情结局”。
2. 开启自动衔接、关闭循环，添加后继 `动作训练`。
3. 原章节入口保留 `01 / 开场`。
4. 从入口分别走两条分支，验证都经过汇合进入动作训练；验证失败重试和成功领奖。
5. 最后打开独立回忆录，确认本次流程解锁的回忆可回放。

最终主要路线：

```text
开场 → 二选一分支 → 回归主线 → 动作训练
                               ├─ 窗口内点击 → 动作成功 → 广告领奖 → 解锁提示
                               └─ 不点击，片尾 → 动作失败 → 重试 → 动作训练

独立回忆录首页 ── 已解锁卡片 ──→ 主线副本 / 回忆片段
独立回忆录首页 ←── 返回上一画面 ─ 主线副本 / 回忆片段
```

**验收**：动作已接入全章，奖励和跨章回忆链仍正常。建议回复：`动作已接入主线`。

进入 [第三篇](03-publishing.md)，准备双章节交付。