SuperAPI AI 工具集

pixi-vn-ink-pause-continue

编程与开发

查看项目

更新于 11-06 16:21

技能介绍

该技能用于解决 Pixi’VN 中 ink 脚本的两类节奏控制问题。

用途:第一,当某一步只需改变屏幕内容(显示图片、播放声音、编辑画布元素)而暂不进入对白时,用 # pause 阻断自动推进;第二,当一句对白及其后的选项菜单希望作为同一个节拍同时显示,而不是分两步出现时,用 <># continue 合并。

主要能力:\n1. # pause:任何 hashtag 命令执行后,引擎会自动 continue 到下一步,因此仅改画面而无对白的步骤会立即落入下一步内容。在步骤中加入 # pause 会清除当前对白并等待玩家继续,使场景铺垫步骤成为独立节拍。内部上,# pause 返回 dialogue/clean 操作并清空该步骤自身的 dialogue / goNextStep 字段;它由 addBaseHashtagCommands() 的旁白部分注册,属于普通 hashtag 命令。\n2. <># continue:默认情况下,一句对白后接选项菜单需要两步——第一步只显示对白,第二步显示对白加选项。在对白行末尾追加 <># continue 可合并为一步。其中 <> 是 ink 的 glue(其后的内容前不断行),# continue 是强制自动推进到下一步的 hashtag 命令(设置 goNextStep = true 并禁用 glue),二者组合才产生“对白与选项同屏”的效果。

使用方式:在 ink 脚本中按需插入相应命令,示例:\n=== start ===\n# show image alien eggHead\n# pause\nHello, world!\n-> DONE\n以及:\n=== start ===\nWho are we going to rescue: the kitten or the wizard?<># continue\n* [the kitten] -> DONE\n* [the wizard] -> DONE\n需确保 addBaseHashtagCommands() 已运行(其旁白部分默认开启)。

适用场景:视觉小说或互动叙事中需要先展示画面/音效再进入对白的场景铺垫;希望对白与选项一次呈现的选择节点。

限制与相关:# pause 与 # continue 不是特殊 ink 语法,而是普通 hashtag 命令;若要注册类似的一次性流程控制命令,可参考 pixi-vn-ink-hashtag-commands;与 divert 相关的 glue/时序规则见 pixi-vn-ink;底层依赖 narration.continue/canContinue 机制(官方文档 pixi-vn.com/start/labels-flow)。