aitalk.cloud 沙雕动画小助手插件使用手册

版本: 1.0.1
适用软件: Adobe Animate

1. 简介

沙雕动画小助手 是一款专为 Adobe Animate 设计的批量导出插件。它可以自动扫描舞台上的元件、组、位图和文本，并根据用户的配置将它们批量导出为 PNG 序列或单张图片。该插件特别优化了多层级元件的导出流程，支持自动烘焙缩放、创建动画子文件夹等功能。

2. 安装方法

1. 下载插件压缩包并解压。
2. 进入解压后的目录，双击运行 一键安装.bat 脚本即可自动安装。

安装完成后，在 Adobe Animate 菜单中选择 窗口 (Window) > 扩展 (Extensions) > aitalk.cloud沙雕动画小助手 即可打开插件面板。

3. 界面概览

1. 工具栏: 包含扫描、全选/反选、类型筛选功能。
2. 设置与导出区: 位于工具栏下方，配置导出路径、层级、缩放选项及执行导出。
3. 列表区: 显示扫描到的舞台元素树状列表，占据剩余空间。

4. 使用流程

步骤 1: 扫描舞台

打开包含动画角色的 FLA 文件，将时间轴播放头移动到包含角色的那一帧（通常是第1帧）。

点击工具栏的 「扫描舞台」 按钮。插件将分析当前帧的所有图层（自动忽略引导层、遮罩层和隐藏图层），并将发现的元素列在下方列表中。

步骤 2: 选择导出元素

在列表中勾选需要导出的元素。

• 全选/全不选: 使用工具栏的快捷按钮。
• 筛选: 点击工具栏的图标（元件、组、位图、文本）可快速显示或隐藏特定类型的元素。
• 展开/折叠: 对于包含嵌套结构的元件或组，点击左侧的箭头或“展开”按钮可查看其内部结构，并单独勾选/取消勾选子部位。

注意: “形状 (Shape)” 类型的元素在扫描时会被自动过滤，插件仅支持 元件(Symbol)、组(Group)、位图(Bitmap) 和 文本(Text)。如果需要导出“形状 (Shape)” 类型的元素，请先将其转换为元件(F8)或组(Ctrl+G)。

步骤 3: 配置导出设置

在工具栏下方的 设置区域 进行配置：

1. 输出路径: 点击 「浏览...」 选择导出的根目录。
2. 导出层级:
   • 导出一级元件: 仅导出舞台上选中的元素本身。
     • 适用场景:
       • 背景 (Backgrounds): 将整个背景图层组合为一个元件导出。
       • 道具 (Props): 单个桌子、椅子等不可动的物体。
       • 人物整体: 如果不需要拆分部位，只想导出整个人作为序列帧或静态图。
   • 导出二级元件 (默认): 深入导出元素内部的第一层子元素。
     • 适用场景:
       • 人物 (Characters): 自动拆分为头、身体、手臂、腿等独立部位，保存到对应的文件夹中。
3. 导出选项:
   • 为动画关键帧创建文件夹: 勾选后，对于多帧动画，会为每个关键帧段创建一个子文件夹；不勾选则所有帧平铺输出。
4. 缩放选项:
   • 原始大小: 按元件原始尺寸导出。
   • 缩放比例: 选择 5% - 5000% 的比例。插件会将缩放“烘焙”到导出的图片中（即导出大图而非仅仅修改属性）。
   • 自定义大小: 指定目标宽或高，插件将按比例缩放导出。

步骤 4: 执行导出

点击设置区域下方的 「导出选中元件」 按钮。

插件将显示进度条，依次处理每个元素。

• 导出过程中可点击 「取消」 按钮中止操作。
• 导出完成后会弹出提示框显示成功数量。

5. 导出文件结构说明

假设舞台上有一个名为 Character 的元件，内部包含 Head (多帧) 和 Body (单帧)。

一级导出 (Level 1):

输出目录/
  └── Character/           (如果 Character 是多帧)
      ├── 1.png
      ├── 2.png
      ...
  └── Character.png        (如果 Character 是单帧)

二级导出 (Level 2):

输出目录/
  └── Character/           (自动创建角色文件夹)
      ├── Head/            (Head 是多帧动画)
      │   ├── 1.png
      │   ├── 2.png
      │   ...
      └── Body.png         (Body 是单帧图片)

6. 常见问题 (FAQ)

Q: 为什么我看不到舞台上的某些图形？
A: 插件不支持直接导出散落的“形状 (Shape)”。请选中这些图形，按 F8 转换为元件，或按 Ctrl+G 组合成组，然后重新扫描。

Q: 点击元件名称为什么会跳转？
A: 在列表中点击元件名称（非组）会尝试在 Animate 中进入该元件的编辑模式，方便预览和检查。

Q: 导出速度慢怎么办？
A: 导出高分辨率图片（或高倍率缩放）和长动画序列会消耗较多时间。尝试减少不必要的帧数或降低分辨率。