调用片段块执行目标 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 层后截断,并可能造成编辑器卡顿。