调用片段块执行目标 Fragment 的全部 Block,完成后从调用块的下一项继续。适合复用公共剧情或演出。
基本用法
在空白旁白块按 Tab,选择「调用片段」即可插入。
在属性检查器中选择目标 Fragment。下拉列表包含当前章节的全部 Fragment,包括 main 和当前 Fragment。
运行时行为
主线 → 调用片段块 → 跑完目标 Fragment 的全部内容 → 回到主线继续
运行顺序:
- 进入目标 Fragment 的开头
- 执行目标 Fragment 的全部内容
- 返回调用块之后的下一个 Block
不需要在目标 Fragment 末尾添加返回指令。
典型用途
- 公共演出:将开场、过场或结局演出放入独立 Fragment,在多个位置调用
- 拆分长内容:将可独立的部分放入子 Fragment
- 章节小节:将 main 中的不同小节放入 Fragment,再按顺序调用
与分支块、条件判断块的关系
三种 Block 都会执行目标 Fragment,并在结束后返回调用位置:
| Block | 何时调用? |
|---|
| 分支 Branch | 玩家选择某个选项时 |
| 条件判断 If | 表达式结果为真/假时 |
| 调用片段 Call Fragment | 无条件,执行到就调用 |
不需要变量或玩家选择时,使用调用片段。
调用自己(递归调用)
下拉列表包含当前 Fragment,但引擎不支持运行时递归。
自调用会在转换期静态展开,最多 30 层,不能通过运行时条件控制递归退出。循环菜单请使用外层流程,不要使用自调用。
目标为当前 Fragment 时,Block 卡片和属性检查器会显示「自调用」警告。
失败处理
| 情况 | 表现 |
|---|
| 未选择目标 Fragment | 卡片显示「未选择片段」虚线占位,运行时该块无动作 |
| 目标 Fragment 被删除 | 卡片整行变红、显示「片段不存在」,运行时该块无动作 |
| 目标 Fragment 内容为空 | 运行时静默跳过(不会停顿) |
Fragment 与调用片段的关系
调用片段引用的目标必须是同章节内的 Fragment(跟分支块、条件判断块的限制一致)。如果你需要跨章节复用某段公共演出,目前的做法是在每个章节里都放一份相同的 Fragment 副本。
关于 Fragment 的详细说明,参见 编辑器 页面。
将公共内容放入独立 Fragment,再从主线或其他 Fragment 调用。
A 调用 B、B 调用 A 等循环会在转换期展开到 30 层后截断,并可能造成编辑器卡顿。