选择输出格式
对照视频、PNG 序列、精灵图元数据和引擎包,了解透明条件、用途与导出权益要求。
本页目录
从使用目标开始选择
想快速检查结果,先下载 PNG 帧 ZIP。自研运行时通常使用精灵图与配套 JSON。需要引擎导入时,选择对应引擎包,并阅读包内说明。
Web 导出对话框初始选择 PNG 帧 ZIP;一键开放 API 省略 output_formats 时默认是 spritesheet。如果流水线依赖固定产物,请显式指定格式。
格式对照
| API 格式 | 返回内容 | 常见用途 |
|---|---|---|
clip_video |
选段 MP4,不透明 | 审核、普通视频播放 |
webm_alpha |
带 Alpha 的 WebM | 支持透明视频的播放器,需实测目标环境 |
prores_4444 |
带 Alpha 的 ProRes 4444 | 合成、视频编辑 |
frames_zip |
PNG 逐帧 ZIP | 逐帧检查、自定义导入 |
spritesheet |
PNG 纹理图集 | 打包成单张纹理 |
spritesheet_json |
配套帧元数据 | 帧矩形和时间信息 |
unity_meta |
Unity 纹理元数据 | 与匹配的精灵图配套使用 |
unity_pack |
Unity ZIP | 图集、元数据、JSON、清单与说明 |
godot_pack |
Godot 4 ZIP | SpriteFrames 与 AnimatedSprite2D 资源 |
unreal_paper2d_pack |
Unreal Paper2D ZIP | PNG 图集及 Paper2D 精灵描述 |
cocos_creator_pack |
Cocos Creator 3.x ZIP | PNG/PLIST 图集和示例播放器 |
元数据本身不是图片,应同时请求或保存配套纹理。以响应中的 outputs 为实际资产清单,不要假设某个数组位置或固定扩展名一定存在。
透明是来源与格式的共同约定
普通 MP4 和原始生成视频保持不透明。透明 PNG、图集、引擎资源、透明 WebM 和 ProRes 4444 需要合适的来源及导出设置。
开放 API 只支持 Alpha Key 来源的透明处理,不对任意背景进行抠图,详见透明动画。
即使文件包含 Alpha,播放器也可能不显示。请在目标软件中测试;可以用 PNG 帧或适配的编辑器,区分显示兼容问题和导出问题。
完整保留引擎包结构
引擎 ZIP 内包含 animgen-manifest.json 和说明文件。不要随意打乱相对路径;Godot 资源会引用包内路径,Unreal Paper2D 导入也需要相应引擎工具。
清单中的帧矩形使用左上角原点;归一化 pivot 使用左下角原点。读取清单,不要仅凭纹理尺寸推断。先在小型测试场景检查帧顺序、播放速度、缩放、锚点和透明效果,再接入整个项目。
积分、权益与下载
免费 Web 访问包含 PNG 帧 ZIP。高级格式需要付费导出权益;积分余额与格式权益是独立检查,详见积分与访问权益。
资产下载使用短期签名链接,应保存文件而不是 URL。API 调用方请查看轮询与下载。
按引擎完成导入
导出后继续阅读 Unity、Godot 4、Unreal Paper2D或 Cocos Creator 3。各指南对应包内真实文件、路径和播放器,不假定所有引擎已经完成运行时验收。
这篇文档有帮助吗?
不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策