动画剧本
动画剧本是 Creator 的核心功能。通过编写中文脚本来编排动画——控制角色的对话、表情、动作，管理场景切换和镜头运动，最终生成完整的动画视频。本章详细介绍剧本编辑器的使用方法和脚本语法。
创建剧本
- 在左侧项目树的 剧本 分类下，右键选择 新建
- 输入剧本名称后按回车确认
- 双击剧本名称打开剧本编辑器
编辑器界面
剧本编辑器的界面由以下部分组成：
| 区域 | 说明 |
|---|---|
| 代码编辑区 | 左侧主区域，编写剧本脚本，支持语法高亮和代码补全 |
| 分镜列表 | 管理剧本中定义的分镜片段 |
| 名称映射 | 将项目素材映射到脚本中的引用名称 |
| 语音面板 | 管理 AI 语音合成 |
| 构建信息 | 显示构建结果和错误信息 |
名称映射
在编写脚本前，需要先将项目中的素材映射到脚本中使用的名称。这样脚本中的 【演播室】 才能对应到实际的场景素材。
- 打开名称映射面板
- 点击 + 添加映射条目
- 选择项目中的素材，并设置在脚本中使用的名称
映射名称可以与素材名称相同，也可以使用简短的别名。建议使用简洁易读的名称。
脚本语法
Creator 使用独创的中文脚本语言来编排动画。以下是语法的详细说明。
基本规则
| 语法元素 | 说明 | 示例 |
|---|---|---|
| 实体引用 | 用 【】 引用素材/演员 | 【主角】 |
| 命令结尾 | 每条命令以 。 结尾 | 【主角】入场。 |
| 字符串 | 用 ："" 包裹文本内容 | 说："你好" |
| 注释 | // 单行注释 | // 这是注释 |
| 多行注释 | ///.../// | /// 多行注释 /// |
时间线模型
脚本中的所有命令按照时间线顺序执行：
- 每条命令都有一个开始时间和结束时间
- 前一条命令结束后，下一条命令开始
- 瞬时命令（如入场、变更表情）不占用时间
- 持续性命令（如「说」）会推进时间线
串行与并行
| 分隔符 | 效果 |
|---|---|
。（句号） | 串行执行——前一条完成后才执行下一条 |
；（分号） | 并行执行——分号分隔的多条命令同时开始 |
// 串行：先说话，再变表情
【角色A】说："你好"。
【角色A】变更角色表情为【微笑】。
// 并行：说话的同时变表情
【角色A】说："你好"。；【角色A】变更角色表情为【微笑】。
命令速查
场景命令
| 命令 | 语法 | 说明 |
|---|---|---|
| 变更场景 | 变更场景为【场景名】。 | 加载场景，自动创建主摄像机和主字幕 |
变更场景为命令会自动创建名为主摄像机和主字幕的对象，后续可以直接引用。
演员入场与退场
| 命令 | 语法 | 说明 |
|---|---|---|
| 入场 | 【演员】入场。 | 将演员添加到舞台 |
| 退场 | 【演员】退场。 | 将演员从舞台移除 |
| 出现在 | 【演员A】出现在【位置】。 | 入场并移动到指定位置 |
演员移动与定位
| 命令 | 语法 | 说明 |
|---|---|---|
| 移动到 | 【A】移动到【B】。 | 瞬时移动到 B 的位置 |
| 带时间的移动 | N秒内；【A】移动到【B】。 | N 秒内平滑移动到 B |
| 位置偏移 | 【A】的【角度】度方向【距离】点处 | 以 A 为基准的偏移位置 |
| 显示层级 | 【A】显示在【B】外侧。 | A 显示在 B 前面 |
| 显示层级 | 【A】显示在【B】里侧。 | A 显示在 B 后面 |
角色命令
| 命令 | 语法 | 说明 |
|---|---|---|
| 说话 | 【角色】说："台词"。 | 角色说台词，自动推进时间线并显示字幕 |
| 变更姿势 | 【角色】变更角色姿势为【姿势名】。 | 切换角色姿势 |
| 变更表情 | 【角色】变更角色表情为【表情名】。 | 切换角色表情 |
| 变更表情状态 | 【角色】变更角色表情状态为【状态名】。 | 切换表情动画状态 |
| 变更左手手势 | 【角色】变更角色左手手势为【手势名】。 | 更换左手手势 |
| 变更右手手势 | 【角色】变更角色右手手势为【手势名】。 | 更换右手手势 |
时间控制
| 命令 | 语法 | 说明 |
|---|---|---|
| 延迟 | N秒后。 | 时间线向后推进 N 秒 |
| 回退 | N秒前。 | 时间线向前回退 N 秒 |
| 持续时间 | N秒内。 | 为后续动画命令设置持续时间 |
分镜与流程控制
| 命令 | 语法 | 说明 |
|---|---|---|
| 定义分镜 | 分镜【名称】： + 缩进块 | 定义可复用的分镜片段 |
| 播放分镜 | 播放分镜【名称】。 | 执行已定义的分镜 |
| 异步执行 | 异步执行： + 缩进块 | 块内动画不阻塞时间线 |
| 异步循环 | 异步循环执行【名称】： + 缩进块 | 无限循环播放动画块 |
| 停止循环 | 停止异步循环【名称】。 | 停止指定的异步循环 |
| 循环 N 次 | 循环执行【N】次： + 缩进块 | 有限次循环 |
缩进块使用 4 个空格 表示一级缩进。缩进块的内容在上一行命令后以冒号
：结尾。
摄像机命令
| 命令 | 语法 | 说明 |
|---|---|---|
| 添加摄像机 | 添加摄像机【名称】。 | 创建新摄像机 |
| 切换主摄像机 | 切换主摄像机为【摄像机名】。 | 切换镜头视角 |
| 变焦 | 【摄像机】变焦到【N】倍。 | 绝对缩放 |
| 相对变焦 | 【摄像机】变焦【N】倍。 | 相对缩放 |
| 方向变焦 | 【摄像机】横向变焦到【N】倍。 | 横/纵向变焦 |
字幕命令
| 命令 | 语法 | 说明 |
|---|---|---|
| 添加字幕 | 添加字幕【名称】。 | 创建新字幕层 |
| 设置字幕 | 【字幕】设置字幕："文本"。 | 手动设置字幕内容 |
| 清空字幕 | 【字幕】清空字幕。 | 清除字幕显示 |
角色的
说命令会自动在主字幕上显示对话内容，通常无需手动控制字幕。
音频命令
| 命令 | 语法 | 说明 |
|---|---|---|
| 播放背景音乐 | 播放背景音乐【音频名】。 | 播放背景音乐 |
| 循环播放 | 循环播放背景音乐【音频名】。 | 循环播放背景音乐 |
| 暂停 | 暂停播放背景音乐。 | 暂停背景音乐 |
| 继续 | 继续播放背景音乐。 | 继续播放 |
| 停止 | 停止播放背景音乐。 | 停止背景音乐 |
| 播放音效 | 播放音效【音效名】。 | 播放一次性音效 |
分镜管理
分镜是剧本的组织单元。你可以将剧本拆分为多个分镜片段，每个分镜相当于一个可复用的子过程。
定义分镜
分镜【开场】：
变更场景为【演播厅】。
【主持人】出现在【主持位】。
【主持人】说："大家好！"。
调用分镜
播放分镜【开场】。
1秒后。
播放分镜【第一幕】。
在剧本编辑器右侧的分镜列表面板中，可以看到所有已定义的分镜，方便快速导航。
构建与错误检查
编写完脚本后，需要构建来解析和验证脚本。
- 点击 构建 按钮
- 系统会解析脚本，检查语法和引用是否正确
- 如果存在错误，构建信息面板会显示错误详情，代码编辑区中也会在对应行标记错误
- 根据提示修改脚本，重新构建直到通过
AI 语音合成
构建成功后，可以为剧本中的角色对话生成 AI 语音。
合成流程
- 切换到 语音面板
- 面板中会列出脚本中所有角色的对话内容
- 点击 提交语音合成 按钮
- 系统会使用各角色设置的配音声线进行 AI 语音合成
- 等待合成完成（进度条会显示状态）
- 完成后，语音会自动绑定到对应的对话
AI 语音合成需要消耗代币。合成前请确认代币余额充足。详见代币管理。
预览播放
构建成功后，可以在内置播放器中预览动画效果。
- 点击 预览 按钮，打开动画播放器
- 播放器提供以下控制：
| 控制 | 说明 |
|---|---|
| 播放/暂停 | 开始或暂停动画播放 |
| 逐帧步进 | 逐帧向前/向后查看 |
| 缩放 | 调整预览画面的显示缩放 |
导出视频
确认动画效果满意后，可以导出为视频文件。
- 点击 导出 按钮
- 在导出对话框中：
- 选择输出路径和文件名
- 选择视频格式
- 点击确定，等待导出完成
导出过程中会逐帧渲染动画并混合音频，可能需要一些时间。
脚本编写示例
以下是一个完整的脚本示例，展示了常用命令的综合运用：
// 场景设置
变更场景为【客厅】。
// 角色入场
【小明】出现在【沙发左侧】。
【小红】出现在【沙发右侧】。
【小明】变更角色姿势为【坐姿】。
【小红】变更角色姿势为【坐姿】。
【小明】变更角色表情为【小明默认表情】。
【小红】变更角色表情为【小红默认表情】。
// 播放背景音乐
循环播放背景音乐【轻松BGM】。
// 对话
0.5秒后。
【小明】说："今天天气真好啊。"。
【小红】说："是啊，要不要一起出去走走？"。
【小明】说："好主意！我们去公园吧。"。
// 镜头变化
1秒内；【主摄像机】变焦到【0.8】倍。
// 停止背景音乐
停止播放背景音乐。
使用技巧
- 善用分镜：将长剧本拆分为多个分镜，方便管理和调试
- 注释标注：为关键段落添加注释，方便后续修改
- 节奏控制：使用
N秒后。在对话间添加停顿，让节奏更自然 - 异步特效：用
异步执行为角色添加同步的表情反应或特效 - 逐步构建：边写边构建，及时发现和修复错误