如何用 Ark-Unpacker 提取明日方舟过场动画:Criware USM 视频解码与 FFmpeg 转码完整教程
如何用 Ark-Unpacker 提取明日方舟过场动画:Criware USM 视频解码与 FFmpeg 转码完整教程
Ark-Unpacker 是一款明日方舟游戏资源批量解包器,除了处理 AB 文件外,它还内置了「Criware USM 音视频提取」模式:借助 FFmpeg 转码,能把游戏里的 USM 过场动画视频批量解码并转换成通用的 mkv / ogg 格式。本文面向新手,带你从找到 USM 文件、安装依赖,到用菜单或一条命令行完成视频提取与转码,最后附上输出目录结构和自定义编码配置的讲解。
一、先认识 USM:明日方舟过场动画的存放方式 🎬
明日方舟由 Unity 开发,绝大多数资源打包在 .ab(AssetBundle)文件中,但过场动画(CG 视频)是例外——它们以 CriWare 流媒体容器 .usm 文件的形式,未打包地直接存放在游戏资源目录的 raw/video/ 文件夹下(详见 docs/zh/AssetsGuide.md 中 raw / 未打包文件(例如视频) 的说明)。
USM 文件内部通常包含两种原始流:
| 原始流 | 容器格式 | 能否直接播放 |
|---|---|---|
| 视频 | .ivf |
❌ 多数播放器不支持 |
| 音频 | .sfa |
❌ 需转码 |
因此需要借助 FFmpeg 把这两路流转成常见的视频/音频格式,并把它们重新合成为一段完整的 mkv 视频。Ark-Unpacker 在 v4.3 版本起就支持了这项功能(见 CHANGELOG.md),其核心实现位于 src/ResolveUSM.py 的 UsmProcessor 类中。
仓库自带一个可直接体验的样例文件:test/res/client-2.5/raw-video-main_10-main_10_enter.usm。
二、准备工作:获取资源、安装 Ark-Unpacker 与 FFmpeg ⚙️
1. 拿到包含 USM 的明日方舟资源
- 安卓端:把
.apk安装包改名.zip打开,解压出assets/AB/Android文件夹;再将手机中Android/data/com.hypergryph.arknights/files/Bundles(热更新资源)复制出来,把Bundles内容覆盖合并进Android文件夹; - PC 端:在
Arknights_Data下找到StreamingAssets/AB/Windows(初始资源)与PersistentData/Bundles(热更新资源),同样思路合并。
完整步骤见 README.md 的「资源准备」章节。对我们来说,重点是其中包含 .usm 的 raw/video/ 目录。
2. 获取 Ark-Unpacker
方式 A:发行版(推荐新手)
到项目的 Releases 页面下载 Windows 64 位可执行文件 ArkUnpacker-vx.x.x_x64.exe,解压即可使用,无需任何环境。
方式 B:从源码运行
git clone https://gitcode.com/gh_mirrors/ar/Ark-Unpacker
cd Ark-Unpacker
poetry install
需要 Python 3.10~3.12 与 Poetry 2,更多细节可参考 docs/zh/ForDevelopers.md。
3. 安装 FFmpeg 并加入 PATH
USM 转码依赖 FFmpeg。请从 FFmpeg 官网下载安装包,并将解压后的 bin 目录加入系统环境变量 Path(修改后需重开终端生效)。
Ark-Unpacker 在进入 USM 提取前会自动生成一个 1 秒测试视频来校验 FFmpeg 是否可用(见 src/ResolveUSM.py 的 is_ffmpeg_available);若检测失败,会弹出「FFmpeg 不可用」提示并询问是否继续(Main.py)。建议检测通过后再开始任务。
三、菜单模式:三步提取 USM 过场动画 🖱️
- 把
raw/video文件夹(或单个.usm文件)放到 Ark-Unpacker 程序所在目录,双击运行程序; - 在主界面选择
6. 自定义 Criware USM 提取(菜单定义见 Main.py); - 依次输入:
- 输入路径:USM 来源文件或目录,支持相对路径;
- 导出目录:默认
USM_Extracted_时间戳; - 导出模式:
| 选项 | 行为 | 产物 |
|---|---|---|
| 1 仅导出音频 | 只转音频流 | .ogg |
| 2 仅导出视频 | 只转视频流(无声) | .mkv |
| 3 合并音视频后导出(推荐) | 视频+音频逐段拼接 | 带声的 .mkv |
确认后程序会显示「正在批量处理Criware USM文件...」的实时任务面板,展示当前阶段、当前文件与累计处理/转换数量(src/ResolveUSM.py),全部完成后打印耗时与统计摘要。
四、命令行模式:一条命令批量转码 USM 💻
熟悉命令行的用户可跳过交互界面,直接指定 cu(resolve-usm)模式运行:
ArkUnpacker -m cu -i raw/video -o USM_Output
常用参数(完整帮助可运行 ArkUnpacker -h,参数定义见 src/utils/ArgParser.py):
| 参数 | 说明 |
|---|---|
-m cu |
指定 Criware USM 提取模式 |
-i INPUT |
源文件或目录路径 |
-o OUTPUT |
导出目录 |
-d |
先删除已存在的导出目录 |
--no-video |
跳过视频处理(即仅导出音频) |
--no-audio |
跳过音频处理(即仅导出视频) |
-l 0~4 |
日志等级,3=info 为默认 |
例如「只把 main_10_enter.usm 转成带声视频、并清空旧结果」:
ArkUnpacker -m cu -i raw/video -o USM_Output -d
源码方式运行则把程序名换成 python Main.py 即可。
五、输出目录结构解读 📁
Ark-Unpacker 会在导出目录下保留源目录的相对层级,每个 USM 文件生成一个以其名字命名的子文件夹。以仓库测试基准 test/_summary/usm.std 为例:
USM_Output/
└─ client-2.5/raw-video-main_10-main_10_enter/
├─ main_10.mkv # ⭐ 最终成品:vp9 + libvorbis 合并视频
└─ raw-video-main_10-main_10_enter/ # 原始分离流(中间产物)
├─ videos/main_10.ivf # 原始视频流
└─ audios/main_1000.sfa # 原始音频流
你只需要播放最上层的 .mkv 文件;内层的 .ivf / .sfa 是解码过程中保存的原始流,确认成品无误后可自行归档。
六、进阶配置:自定义编码器、格式与文件编码 🔧
首次运行后,工作目录会生成 ArkUnpackerConfig.json 配置文件,其中与 USM 提取直接相关的字段如下(默认值定义见 src/utils/Config.py):
| 字段 | 默认值 | 说明 |
|---|---|---|
usm_encoding |
gbk |
读取 USM 时采用的编码,常见 utf-8 与 gbk |
usm_export_video_codec |
vp9 |
视频编码器 |
usm_export_audio_codec |
libvorbis |
音频编码器 |
usm_export_video_ext |
.mkv |
视频导出扩展名 |
usm_export_audio_ext |
.ogg |
音频导出扩展名 |
例如想让成品兼容更多老设备,可以把视频编码器改为 h264。完整字段说明见 docs/zh/ConfigFile.md。
⚠️ 注意:修改或删除配置后必须重启 Ark-Unpacker 才能生效。
七、常见问题 FAQ ❓
Q1:提示「FFmpeg 不可用」怎么办?
重新检查 FFmpeg 的 bin 目录是否已加入 Path,并重开一个终端再运行;仍失败则用命令行输入 ffmpeg -version 验证是否安装成功。
Q2:导出的文件名是乱码?
说明读取 USM 所用的编码不对。把 ArkUnpackerConfig.json 中的 usm_encoding 在 gbk 与 utf-8 之间切换后重启程序重试。
Q3:选「合并音视频」却没有声音? 该 USM 本身可能不含音频流,程序会自动降级为仅导出视频(见 src/ResolveUSM.py 的处理分支),属正常行为。
Q4:为什么解包 AB 文件找不到过场动画?
过场动画不在 AB 里,请直接在原始游戏资源目录的 raw/video/ 下查找 .usm 文件,这也是 USM 模式直接指向原始目录的原因。
Q5:可以只转一个视频吗?
可以。-i / 输入路径既支持目录也支持单个 USM 文件,程序会递归扫描目录中的所有 USM 并用线程池并发处理(src/ResolveUSM.py)。
小结 🎉
借助 Ark-Unpacker 的 USM 提取模式,提取明日方舟过场动画只需三步:找到 raw/video 下的 .usm 文件 → 确保 FFmpeg 可用 → 菜单选 3 或执行 ArkUnpacker -m cu -i 输入 -o 输出。程序会自动完成解码、转码与音视频合成,最终得到即点即播的 mkv 成品。更多资源定位与工具细节可继续浏览 docs/zh/AssetsGuide.md、docs/zh/Essentials.md 与 docs/zh/ConfigFile.md。