如何用 Ark-Unpacker 提取明日方舟过场动画:Criware USM 视频解码与 FFmpeg 转码完整教程

原创2026-10-31 18:39:501,672 阅读

如何用 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 过场动画 🖱️

  1. 把 raw/video 文件夹(或单个 .usm 文件)放到 Ark-Unpacker 程序所在目录,双击运行程序;
  2. 在主界面选择 6. 自定义 Criware USM 提取(菜单定义见 Main.py);
  3. 依次输入:
    • 输入路径: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。

登录后查看全文
Ark-Unpacker