动画剧本语法

语法规则

Creator 使用独创的中文剧本语言来编排动画。以下是语法的详细说明。

基本规则

语法元素说明示例
实体用 【】 包裹的素材名称、数字或自定义名称【主角】 【0.5】
命令命令能够接收实体作为参数，并产生瞬时或连续的动画片段入场 移动到
语句单个或多个命令组合成语句，并以中文逗号（，）、分号（；）、句号（。）结尾【主角】入场。
字符串冒号后用引号包裹文本内容，支持中英文引号说："你好" 说："你好"
注释// 开头的单行注释// 这是注释
多行注释/// 开始，/// 结束/// 多行注释 ///
代码块用三个反引号包裹的 JavaScript 代码代码

所有标点符号均支持中英文两种形式。例如 ， 和 , 效果相同，【】 和 [] 效果相同。

建议总是使用中文标点符号。

实体

实体是用 【】 包裹的参数，根据命令的需要，实体可以有以下类型：

实体类型说明示例
演员场景中的素材对象，包括角色、道具、特效等【主角】 【背景】
场景场景素材【客厅】
摄像机镜头对象【主摄像机】
字幕字幕层对象【主字幕】
音频音频素材【背景音乐1】
数字用于时间、角度、距离、倍数等数值参数【0.5】 【90】 【2】
自定义名称用于分镜名称、动作名称、标签名称、属性名称等【开场分镜】 【走路动作】

时间线

基本原则：命令默认串行执行，通过 ；（分号）并行执行。

以剧本为例（其中每个字母表示一个语句）：

A，B，C；
D，E。
F。

时间线结构如下：

A ─── B ─── C ────┐
                  ├─ F
D ─── E ──────────┘
  • A 和 D 同时执行
  • A、B、C 串行执行
  • D、E 串行执行
  • F 在 C 和 E 都执行完成之后再执行

逗号语句

逗号除了像分号和句号一样分隔语句以外，还有一个额外的功能：可以继承前一句的主语。

示例：

// 标准写法
【主角】出现在【场景1】的【左侧定位点】，【主角】移动到【场景1】的【右侧定位点】。

// 继承主语写法（效果相同）
【主角】出现在【场景1】的【左侧定位点】，移动到【场景1】的【右侧定位点】。

缩进块

部分命令（如分镜、动作、异步执行等）需要在冒号 ： 后换行，使用缩进块来包含一组子语句。缩进块使用 4 个空格 表示一级缩进。

分镜【开场】：
    【主角】入场。
    【主角】说："大家好！"

缩进块支持嵌套：

分镜【开场】：
    异步执行：
        循环播放背景音乐【欢快BGM】。
    【主角】入场。

代码块

代码块用于编写 JavaScript 动画代码，使用三个反引号 包裹。代码块仅在 动画代码` 命令中使用。

动画代码【自定义动画】：
    ```
    stopTime = startTime + 1.0;
    ```

命令列表

基础命令

这些命令用于控制动画的基本流程，包括分镜、动作、异步执行等。

编号命令名语法
1001分镜分镜【名称】： + 缩进块
1002播放分镜播放分镜【名称】
1003动作动作【名称】： + 缩进块
1004异步执行异步执行： + 缩进块
1005异步循环执行异步循环执行【名称】： + 缩进块
1006循环执行循环执行【N】次： + 缩进块
1007秒后【N】秒后
1008秒前【N】秒前
1009秒内【N】秒内
1010停止异步循环停止异步循环【名称】
1011动画代码动画代码【名称】： + 代码块

演员命令

所有素材对象（角色、道具、特效等）都属于演员的范畴，以下命令适用于所有演员类型。对于特定类型的演员（如角色、表情等），还有专门的命令，详见后续章节。

编号命令名语法
1501的【演员】的【子演员名】
1502执行动作【演员】执行动作【动作名】
1503添加标签【演员】添加标签【标签名】
1504移除标签【演员】移除标签【标签名】
1505使用模板添加演员使用【演员】的模板添加【N】个名字前缀为【前缀】的演员
1506修改属性【演员】修改属性【属性名】的值为【值】
1507入场【演员】入场
1508退场【演员】退场
1509显示在外侧【演员A】显示在【演员B】外侧
1510显示在里侧【演员A】显示在【演员B】里侧
1511执行动画代码【演员】执行动画代码【代码名】

2D 演员命令

这些命令用于控制可移动的 2D 演员。

场景、角色、表情、手势、道具、特效等具有位置属性的演员，就可以通过这些命令控制。而音频等不具有位置属性的演员则不能通过这些命令控制。

编号命令名语法
2001偏移位置【演员】的【角度】度方向【距离】点处
2002出现在【演员A】出现在【演员B】
2003移动到【演员A】移动到【演员B】
2004向方向移动【演员】向【角度】度方向移动【距离】点
2005缩放到【演员】缩放到【N】倍
2006方向缩放【演员】向【角度】度方向缩放【N】倍
2007旋转到【演员】旋转到【N】度
2008顺时针旋转【演员】顺时针旋转【N】度
2009逆时针旋转【演员】逆时针旋转【N】度
2010朝向【演员A】朝向【演员B】
2011设置透明度到【演员】设置透明度到【N】
2012降低透明度【演员】降低透明度【N】
2013提升透明度【演员】提升透明度【N】
2014绕目标顺时针旋转【演员A】绕【演员B】顺时针旋转【N】度
2015绕目标逆时针旋转【演员A】绕【演员B】逆时针旋转【N】度

场景命令

编号命令名语法
2501变更场景为变更场景为【场景名】

角色命令

编号命令名语法
3001说【角色】说："台词"
3002变更角色姿势为【角色】变更角色姿势为【姿势名】
3003变更角色表情为【角色】变更角色表情为【表情名】
3004变更角色表情状态为【角色】变更角色表情状态为【状态名】
3007变更角色左手手势为【角色】变更角色左手手势为【手势名】
3008变更角色右手手势为【角色】变更角色右手手势为【手势名】

表情命令

编号命令名语法
3501变更表情状态为【表情】变更表情状态为【状态名】
3502播放表情动画【表情】播放表情动画
3503停止表情动画【表情】停止表情动画

手势命令

编号命令名语法
4001变更手势状态为【手势】变更手势状态为【状态名】

道具命令

编号命令名语法
4501变更道具状态为【道具】变更道具状态为【状态名】

特效命令

编号命令名语法
5001变更特效状态为【特效】变更特效状态为【状态名】
5002播放特效动画【特效】播放特效动画
5003停止特效动画【特效】停止特效动画

音频命令

编号命令名语法
5501变更音频片段为【音频】变更音频片段为【片段名】
5502播放背景音乐播放背景音乐【音频名】
5503暂停播放背景音乐暂停播放背景音乐
5504继续播放背景音乐继续播放背景音乐
5505停止播放背景音乐停止播放背景音乐
5506播放音效播放音效【音频名】
5507播放音效片段播放音效【音频名】的【片段名】片段
5508停止播放音效停止播放音效【音频名】
5509循环播放背景音乐循环播放背景音乐【音频名】

摄像机命令

编号命令名语法
6001添加摄像机添加摄像机【名称】
6002切换主摄像机为切换主摄像机为【摄像机名】
6003变焦到【摄像机】变焦到【N】倍
6004横向变焦到【摄像机】横向变焦到【N】倍
6005纵向变焦到【摄像机】纵向变焦到【N】倍
6006变焦【摄像机】变焦【N】倍
6007横向变焦【摄像机】横向变焦【N】倍
6008纵向变焦【摄像机】纵向变焦【N】倍

字幕命令

编号命令名语法
6501添加字幕添加字幕【名称】
6502设置字幕【字幕】设置字幕："文本"
6503清空字幕【字幕】清空字幕

命令使用说明

1001 分镜

定义一个可复用的分镜片段，供后续通过 播放分镜 命令调用。

语法： 分镜【名称】： + 缩进块

示例：

分镜【开场动画】：
    【主角】入场。
    【主角】说："大家好！"

播放分镜【开场动画】。

1002 播放分镜

执行一个已定义的分镜片段。

语法： 播放分镜【名称】

示例：

播放分镜【开场动画】。

禁止循环调用分镜（例如分镜 A 中播放分镜 B，分镜 B 中又播放分镜 A）。

1003 动作

定义一个可复用的动作，与分镜不同的是，动作会绑定到执行它的演员上下文中。

语法： 动作【名称】： + 缩进块

示例：

动作【挥手】：
    【0.3】秒内，【目标演员】顺时针旋转【15】度。
    【0.3】秒内，【目标演员】逆时针旋转【15】度。

【主角】执行动作【挥手】。

动作块内使用 【目标演员】 来引用执行该动作的演员。

1004 异步执行

异步执行一个语句块，块内的动画不会阻塞主时间线。

语法： 异步执行： + 缩进块

示例：

// 背景音乐和角色入场同时进行，角色入场不必等待音乐播放完毕
异步执行：
    播放背景音乐【欢快BGM】。
【主角】入场。

1005 异步循环执行

创建一个后台无限循环，持续执行语句块中的动画。通过名称标识，以便后续停止。

语法： 异步循环执行【名称】： + 缩进块

示例：

异步循环执行【闪烁】：
    【0.5】秒内，【星星】设置透明度到【0】。
    【0.5】秒内，【星星】设置透明度到【1】。

// 后续停止循环
停止异步循环【闪烁】。

1006 循环执行

将语句块中的动画重复执行指定次数。

语法： 循环执行【N】次： + 缩进块

示例：

循环执行【3】次：
    【0.5】秒内，【主角】顺时针旋转【360】度。

1007 秒后

将时间线向后推进指定秒数，产生一段延迟。

语法： 【N】秒后

示例：

【主角】入场。
【2】秒后。
【主角】说："等了两秒才开始说话。"

1008 秒前

将时间线向前回退指定秒数。回退不会超过时间线起点（最小为 0）。

语法： 【N】秒前

示例：

【主角】说："第一句话。"
【0.5】秒前。
// 时间线回退 0.5 秒，下一句话会提前开始
【配角】说："第二句话。"

1009 秒内

为后续的动画命令设置持续时间，使瞬时命令变为平滑的过渡动画。

语法： 【N】秒内

以下命令支持 秒内 持续时间：

  • 移动到、向方向移动
  • 缩放到、方向缩放
  • 旋转到、顺时针旋转、逆时针旋转
  • 绕目标顺时针旋转、绕目标逆时针旋转
  • 设置透明度到、降低透明度、提升透明度
  • 变焦到、横向变焦到、纵向变焦到
  • 变焦、横向变焦、纵向变焦
  • 切换主摄像机为

示例：

// 1 秒内平滑移动到目标位置
【1】秒内，【主角】移动到【场景1】的【右侧定位点】。

// 也可以用分号使 秒内 与后续命令并行生效
【2】秒内；
【主角】移动到【终点】，【主角】缩放到【2】倍。

1010 停止异步循环

停止一个正在运行的异步循环。

语法： 停止异步循环【名称】

示例：

停止异步循环【闪烁】。

1011 动画代码

定义一段 JavaScript 动画代码块，供后续通过 执行动画代码 命令调用。适用于需要精细控制动画逻辑的高级场景。

语法： 动画代码【名称】： + 代码块

代码块中可用的全局变量：

变量类型说明
actorsArray<Actor>执行该代码的目标演员数组
startTimenumber动画开始时间（秒）
stopTimenumber动画结束时间（秒），必须在代码中赋值

可选的回调函数：

代码块中可以定义 initialize() 和 update() 回调函数，用于逐帧控制动画：

回调 / 变量说明
initialize()动画初始化时调用一次
update()每帧调用一次
currentFrame当前帧编号（在 update 中可用）
currentFrameWeight当前帧权重 0~1（在 update 中可用）
isFirstFrame是否为第一帧（在 update 中可用）
isLastFrame是否为最后一帧（在 update 中可用）
totalFrames总帧数（在 initialize 中设置）

示例：

动画代码【渐入】：
    ```
    stopTime = startTime + 1.0;

    function initialize() {
        totalFrames = 30;
    }

    function update() {
        actors[0].Alpha = currentFrameWeight;
    }
    ```

【主角】执行动画代码【渐入】。

1501 的

访问演员的子演员或内置属性。可以链式调用。

语法： 【演员】的【子演员名】

可用的内置属性：

属性名说明
位置演员的位置信息
旋转角度演员的旋转角度
缩放比例演员的缩放比例
透明度演员的透明度
变换矩阵演员的变换矩阵

示例：

// 访问场景中的子演员（定位点）
【主角】移动到【场景1】的【左侧定位点】。

// 链式访问
【主角】移动到【场景1】的【桌子】的【右侧】。

1502 执行动作

让演员执行一个已定义的动作。动作可以是通过 动作 命令定义的，也可以是演员自带的内置动作。

语法： 【演员】执行动作【动作名】

示例：

动作【点头】：
    【0.2】秒内，【目标演员】顺时针旋转【10】度。
    【0.2】秒内，【目标演员】逆时针旋转【10】度。

【主角】执行动作【点头】。

禁止循环调用动作（例如动作 A 中执行动作 B，动作 B 中又执行动作 A）。

1503 添加标签

为演员添加一个或多个标签，用于分组管理。

语法： 【演员】添加标签【标签名】

示例：

【角色A】添加标签【团队1】。
【角色B】添加标签【团队1】。

1504 移除标签

移除演员的标签。

语法： 【演员】移除标签【标签名】

示例：

【角色A】移除标签【团队1】。

1505 使用模板添加演员

以一个已有的演员作为模板，批量创建多个新演员。

语法： 使用【演员】的模板添加【N】个名字前缀为【前缀】的演员

示例：

// 以【观众模板】为模板，创建 5 个名为 观众1、观众2、...、观众5 的演员
使用【观众模板】的模板添加【5】个名字前缀为【观众】的演员。

1506 修改属性

修改演员的自定义属性值。

语法： 【演员】修改属性【属性名】的值为【值】

示例：

【主角】修改属性【速度】的值为【2.5】。
【按钮】修改属性【可见】的值为【true】。

1507 入场

将演员添加到舞台上。支持多个演员同时入场。

语法： 【演员】入场

示例：

【主角】入场。
// 多个演员同时入场
【主角】【配角】入场。

1508 退场

将演员从舞台移除。支持多个演员同时退场。

语法： 【演员】退场

示例：

【主角】退场。
// 多个演员同时退场
【主角】【配角】退场。

1509 显示在外侧

将演员的显示层级调整到参考演员的前面（外侧）。

语法： 【演员A】显示在【演员B】外侧

示例：

// 主角显示在桌子前面
【主角】显示在【桌子】外侧。

1510 显示在里侧

将演员的显示层级调整到参考演员的后面（里侧）。

语法： 【演员A】显示在【演员B】里侧

示例：

// 主角显示在桌子后面
【主角】显示在【桌子】里侧。

1511 执行动画代码

在指定的演员上执行已定义的 JavaScript 动画代码。

语法： 【演员】执行动画代码【代码名】

代码中可用的全局变量：

  • actors — 目标演员数组，即命令中指定的演员
  • startTime — 动画开始时间
  • stopTime — 需要在代码中设置结束时间

详细的代码编写说明请参考 1011 动画代码。

示例：

动画代码【弹跳】：
    ```
    stopTime = startTime + 0.5;

    function update() {
        var offset = Math.sin(currentFrameWeight * Math.PI) * 50;
        actors[0].Position = { x: actors[0].Position.x, y: actors[0].Position.y - offset };
    }
    ```

【主角】执行动画代码【弹跳】。

2001 偏移位置

以某个演员的位置为基准，按指定角度和距离计算出一个偏移位置。通常作为其他命令的位置参数使用。

语法： 【演员】的【角度】度方向【距离】点处

  • 角度：0 度为正右方，逆时针增加
  • 距离：以像素点为单位

示例：

// 主角出现在定位点右方 100 点的位置
【主角】出现在【定位点】的【0】度方向【100】点处。

2002 出现在

让演员入场并瞬间移动到指定位置。相当于 入场 + 移动到 的组合。

语法： 【演员A】出现在【演员B】

示例：

【主角】出现在【场景1】的【左侧定位点】。

2003 移动到

将演员移动到目标演员的位置。默认为瞬时移动，配合 秒内 可实现平滑移动。

语法： 【演员A】移动到【演员B】

示例：

// 瞬时移动
【主角】移动到【场景1】的【右侧定位点】。

// 1 秒内平滑移动
【1】秒内，【主角】移动到【场景1】的【右侧定位点】。

2004 向方向移动

让演员向指定角度方向移动指定距离。配合 秒内 可实现平滑移动。

语法： 【演员】向【角度】度方向移动【距离】点

示例：

// 向右移动 200 点
【主角】向【0】度方向移动【200】点。

// 2 秒内向上移动 100 点
【2】秒内，【主角】向【90】度方向移动【100】点。

2005 缩放到

将演员缩放到指定倍数（绝对值）。配合 秒内 可实现平滑缩放。

语法： 【演员】缩放到【N】倍

示例：

// 瞬时放大到 2 倍
【主角】缩放到【2】倍。

// 0.5 秒内缩小到 0.5 倍
【0.5】秒内，【主角】缩放到【0.5】倍。

2006 方向缩放

让演员在指定方向上进行缩放。角度必须是 45 的倍数（0、45、90、135 等）。

语法： 【演员】向【角度】度方向缩放【N】倍

示例：

// 横向拉伸到 2 倍（0 度为水平方向）
【主角】向【0】度方向缩放【2】倍。

// 纵向拉伸到 1.5 倍（90 度为垂直方向）
【主角】向【90】度方向缩放【1.5】倍。

2007 旋转到

将演员旋转到指定的绝对角度。配合 秒内 可实现平滑旋转。

语法： 【演员】旋转到【N】度

示例：

// 旋转到 45 度
【主角】旋转到【45】度。

// 1 秒内旋转到 180 度
【1】秒内，【主角】旋转到【180】度。

2008 顺时针旋转

让演员顺时针旋转指定角度（相对值）。配合 秒内 可实现平滑旋转。

语法： 【演员】顺时针旋转【N】度

示例：

【主角】顺时针旋转【90】度。

// 2 秒内顺时针旋转一圈
【2】秒内，【主角】顺时针旋转【360】度。

2009 逆时针旋转

让演员逆时针旋转指定角度（相对值）。配合 秒内 可实现平滑旋转。

语法： 【演员】逆时针旋转【N】度

示例：

【主角】逆时针旋转【45】度。

2010 朝向

让演员旋转到面向目标演员的方向。

语法： 【演员A】朝向【演员B】

示例：

【主角】朝向【配角】。

2011 设置透明度到

将演员的透明度设置为指定值（绝对值，0 为完全透明，1 为完全不透明）。配合 秒内 可实现淡入淡出效果。

语法： 【演员】设置透明度到【N】

示例：

// 瞬间变为半透明
【主角】设置透明度到【0.5】。

// 1 秒内淡出
【1】秒内，【主角】设置透明度到【0】。

// 1 秒内淡入
【1】秒内，【主角】设置透明度到【1】。

2012 降低透明度

降低演员的透明度（相对值），使演员变得更透明。配合 秒内 可实现平滑过渡。

语法： 【演员】降低透明度【N】

示例：

// 降低 0.3 的透明度
【主角】降低透明度【0.3】。

2013 提升透明度

提升演员的透明度（相对值），使演员变得更不透明。配合 秒内 可实现平滑过渡。

语法： 【演员】提升透明度【N】

示例：

// 提升 0.5 的透明度
【0.5】秒内，【主角】提升透明度【0.5】。

2014 绕目标顺时针旋转

让演员绕另一个演员的位置顺时针旋转指定角度。配合 秒内 可实现平滑旋转。

语法： 【演员A】绕【演员B】顺时针旋转【N】度

示例：

// 绕中心点顺时针旋转 90 度
【2】秒内，【卫星】绕【地球】顺时针旋转【90】度。

2015 绕目标逆时针旋转

让演员绕另一个演员的位置逆时针旋转指定角度。配合 秒内 可实现平滑旋转。

语法： 【演员A】绕【演员B】逆时针旋转【N】度

示例：

【3】秒内，【月球】绕【地球】逆时针旋转【360】度。

2501 变更场景为

切换到指定的场景。执行后会重置所有演员，并自动创建名为 主摄像机 和 主字幕 的对象。

语法： 变更场景为【场景名】

示例：

变更场景为【客厅】。
// 此时可以直接使用【主摄像机】和【主字幕】
【主角】出现在【客厅】的【中央定位点】。

变更场景为 是通常是剧本的第一条命令。执行后即可直接引用 【主摄像机】 和 【主字幕】。

3001 说

让角色说出台词。该命令会自动推进时间线（根据台词长度估算时长），并在 主字幕 上显示对话内容。

语法： 【角色】说："台词"

示例：

【主角】说："大家好，欢迎来到沙柚动画！"

说 命令会自动将台词显示在 主字幕 上，通常无需手动控制字幕。

3002 变更角色姿势为

切换角色的姿势形态。支持多个角色同时变更。

语法： 【角色】变更角色姿势为【姿势名】

示例：

【主角】变更角色姿势为【坐姿】。

// 多个角色同时变更
【主角】【配角】变更角色姿势为【站姿】。

3003 变更角色表情为

为角色更换表情素材。支持多个角色同时变更。

语法： 【角色】变更角色表情为【表情名】

示例：

【主角】变更角色表情为【微笑】。

3004 变更角色表情状态为

切换角色当前表情的动画状态。支持多个角色同时变更。

语法： 【角色】变更角色表情状态为【状态名】

示例：

【主角】变更角色表情状态为【眨眼】。

3007 变更角色左手手势为

为角色更换左手手势。支持多个角色同时变更。

语法： 【角色】变更角色左手手势为【手势名】

示例：

【主角】变更角色左手手势为【握拳】。

3008 变更角色右手手势为

为角色更换右手手势。支持多个角色同时变更。

语法： 【角色】变更角色右手手势为【手势名】

示例：

【主角】变更角色右手手势为【竖大拇指】。

3501 变更表情状态为

变更表情的动画状态，并循环播放该状态的动画。

语法： 【表情】变更表情状态为【状态名】

示例：

// 直接对表情演员使用
【主角表情】变更表情状态为【开心】。

// 对角色使用（自动定位到其表情）
【主角】变更表情状态为【开心】。

3502 播放表情动画

开始循环播放表情的动画。

语法： 【表情】播放表情动画

示例：

【主角】播放表情动画。

3503 停止表情动画

停止正在播放的表情动画。

语法： 【表情】停止表情动画

示例：

【主角】停止表情动画。

4001 变更手势状态为

变更手势的动画状态。

语法： 【手势】变更手势状态为【状态名】

示例：

【主角左手】变更手势状态为【张开】。

4501 变更道具状态为

变更道具的动画状态。支持多个道具同时变更。

语法： 【道具】变更道具状态为【状态名】

示例：

【宝箱】变更道具状态为【打开】。

5001 变更特效状态为

变更特效的动画状态，并自动循环播放新状态的动画。支持多个特效同时变更。

语法： 【特效】变更特效状态为【状态名】

示例：

【烟花特效】变更特效状态为【绽放】。

5002 播放特效动画

开始循环播放特效动画。支持多个特效同时播放。

语法： 【特效】播放特效动画

示例：

【下雨特效】播放特效动画。

5003 停止特效动画

停止正在播放的特效动画。支持多个特效同时停止。

语法： 【特效】停止特效动画

示例：

【下雨特效】停止特效动画。

5501 变更音频片段为

变更音频演员使用的音频片段。支持多个音频同时变更。

语法： 【音频】变更音频片段为【片段名】

示例：

【背景音乐1】变更音频片段为【欢快版本】。

5502 播放背景音乐

播放背景音乐（单次播放，不循环）。如果当前已有背景音乐在播放，会先停止旧的再播放新的。

语法： 播放背景音乐【音频名】

示例：

播放背景音乐【开场曲】。

5503 暂停播放背景音乐

暂停当前正在播放的背景音乐。

语法： 暂停播放背景音乐

示例：

暂停播放背景音乐。

5504 继续播放背景音乐

继续播放已暂停的背景音乐，从暂停位置继续。

语法： 继续播放背景音乐

示例：

继续播放背景音乐。

5505 停止播放背景音乐

完全停止背景音乐的播放。

语法： 停止播放背景音乐

示例：

停止播放背景音乐。

5506 播放音效

播放一次性音效。

语法： 播放音效【音频名】

示例：

播放音效【掌声】。

5507 播放音效片段

播放音频演员的指定片段。

语法： 播放音效【音频名】的【片段名】片段

示例：

播放音效【音效集】的【爆炸】片段。

5508 停止播放音效

停止正在播放的音效。

语法： 停止播放音效【音频名】

示例：

停止播放音效【掌声】。

5509 循环播放背景音乐

循环播放背景音乐。如果当前已有背景音乐在播放，会先停止旧的再播放新的。

语法： 循环播放背景音乐【音频名】

示例：

循环播放背景音乐【轻快BGM】。

6001 添加摄像机

创建一个新的摄像机。

语法： 添加摄像机【名称】

示例：

添加摄像机【特写镜头】。

变更场景为 命令会自动创建名为 主摄像机 的默认摄像机，无需手动添加。仅在需要多镜头切换时才需要添加额外的摄像机。

6002 切换主摄像机为

切换当前的活动摄像机。配合 秒内 可实现平滑的镜头切换。

语法： 切换主摄像机为【摄像机名】

示例：

// 瞬时切换
切换主摄像机为【特写镜头】。

// 1 秒内平滑切换
【1】秒内，切换主摄像机为【特写镜头】。

6003 变焦到

将摄像机缩放到指定倍数（绝对值，同时影响横向和纵向）。配合 秒内 可实现平滑变焦。支持多个摄像机同时操作。

语法： 【摄像机】变焦到【N】倍

示例：

// 放大到 2 倍
【主摄像机】变焦到【2】倍。

// 1 秒内平滑变焦
【1】秒内，【主摄像机】变焦到【1.5】倍。

6004 横向变焦到

仅在横向（X 轴）上将摄像机缩放到指定倍数。配合 秒内 可实现平滑变焦。

语法： 【摄像机】横向变焦到【N】倍

示例：

【主摄像机】横向变焦到【2】倍。

6005 纵向变焦到

仅在纵向（Y 轴）上将摄像机缩放到指定倍数。配合 秒内 可实现平滑变焦。

语法： 【摄像机】纵向变焦到【N】倍

示例：

【主摄像机】纵向变焦到【1.5】倍。

6006 变焦

在当前缩放倍数的基础上进行相对缩放（同时影响横向和纵向）。配合 秒内 可实现平滑变焦。支持多个摄像机同时操作。

语法： 【摄像机】变焦【N】倍

示例：

// 在当前基础上再放大 1.5 倍
【主摄像机】变焦【1.5】倍。

6007 横向变焦

仅在横向（X 轴）上进行相对缩放。配合 秒内 可实现平滑变焦。

语法： 【摄像机】横向变焦【N】倍

示例：

【主摄像机】横向变焦【2】倍。

6008 纵向变焦

仅在纵向（Y 轴）上进行相对缩放。配合 秒内 可实现平滑变焦。

语法： 【摄像机】纵向变焦【N】倍

示例：

【主摄像机】纵向变焦【0.5】倍。

6501 添加字幕

创建一个新的字幕层。

语法： 添加字幕【名称】

示例：

添加字幕【旁白字幕】。

变更场景为 命令会自动创建名为 主字幕 的默认字幕层。角色的 说 命令会自动在 主字幕 上显示对话内容，通常无需手动控制字幕。

6502 设置字幕

手动设置字幕层的文本内容。

语法： 【字幕】设置字幕："文本"

示例：

【旁白字幕】设置字幕："第二天清晨"

6503 清空字幕

清除字幕层上的文本内容。

语法： 【字幕】清空字幕

示例：

【主字幕】清空字幕。