文档
核心
元素
控制

控制

⚠️

本页面正在建设中

⚠️

测试功能，可能会有变动

控制是一个类，它具有一些用于流程控制的实用方法。

Control.do([
    character1.say("hello"),
 
    // 播放声音并同时摇动图像
    Control.allAsync([
        sound.play(),
        shake(image1),
    ]),
]);

静态方法

do

按顺序执行操作，等待每个操作完成

  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

doAsync

按顺序执行操作，不等待操作完成

  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

any

同时执行所有操作，等待任意一个操作完成

  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

all

同时执行所有操作，等待所有操作完成

  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

allAsync

同时执行所有操作，不等待所有操作完成

  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

repeat

多次执行操作

  • times: number - 次数
  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

whileLoop

当条件为真时执行操作

  • condition: Lambda<boolean> | LambdaHandler<boolean> - 要检查的条件
  • actions: ActionStatements - ActionStatements
  • 返回 ChainedControl - 链式控制实例

breakLoop

打破当前循环（repeat/while） 只能在循环体内使用

  • 返回 ChainedControl - 链式控制实例

sleep

休眠一段时间

  • duration: number | Awaitable<any> | Promise<any> - 休眠时长
  • 返回 ChainedControl - 链式控制实例

waitForClick

暂停执行，直到用户在舞台任意位置点击（不包括对话框、按钮、菜单等 GUI 元素）。类似于在 Sentence 中插入无时长的暂停。

适用于在 ADV 模式中创建「点击继续」的停顿，或在 NVL 块内等待玩家准备好后再继续。

scene.action([
    character.say("请仔细阅读..."),
    Control.waitForClick(),
    character.say("我们继续。"),
]);
  • 返回 ChainedControl - 链式控制实例
条件文本