SpatialMediaKit 开源项目教程
项目介绍
SpatialMediaKit 是一个用于处理空间媒体的实用工具。该项目的主要目的是为新兴的 Apple MV-HEVC 立体视频格式提供支持。截至 2024 年 1 月,Apple 的 MV-HEVC 格式非常新,几乎没有任何工具支持。然而,已经有数百万台 iPhone(如 iPhone 15 Pro/Pro Max)能够捕捉空间视频。SpatialMediaKit 填补了这一空白,提供了开源工具来处理这些空间媒体文件。
SpatialMediaKit 的主要功能包括:
- Split:将单个 MV-HEVC 输入文件分割成左右眼的独立视频文件。
- Merge:将两个视频文件(左眼和右眼)合并成一个 MV-HEVC 文件。
项目快速启动
安装
-
下载 SpatialMediaKit 工具:
git clone https://github.com/sturmen/SpatialMediaKit.git cd SpatialMediaKit
-
将工具标记为可执行文件并复制到 PATH 中:
chmod +x spatial-media-kit-tool sudo cp spatial-media-kit-tool /usr/local/bin
使用
Split 命令
将单个 MV-HEVC 文件分割成左右眼的独立视频文件:
spatial-media-kit-tool split --input-file <input-file> [--output-dir <output-dir>]
Merge 命令
将两个视频文件合并成一个 MV-HEVC 文件:
spatial-media-kit-tool merge --left-file <left-file> --right-file <right-file> --quality <quality> [--left-is-primary] [--right-is-primary] --horizontal-field-of-view <horizontal-field-of-view> [--horizontal-disparity-adjustment <horizontal-disparity-adjustment>] --output-file <output-file>
应用案例和最佳实践
电影制作
SpatialMediaKit 可以帮助电影制作人将现场拍摄的立体视频素材准备用于后期处理。通过将 MV-HEVC 文件分割成左右眼的独立视频文件,制作人可以更方便地进行编辑和特效处理。
VR 内容开发
对于 VR 内容开发者来说,SpatialMediaKit 是一个不可或缺的工具。开发者可以使用该工具将独立的左右眼视角内容融合,创建沉浸式观影体验。
创意工作者
任何需要处理双目立体视频的创意工作者都可以使用 SpatialMediaKit 简化复杂的转换流程,无需依赖昂贵的商业软件或云服务,保障隐私安全。
典型生态项目
ffmpeg
ffmpeg 是一个强大的多媒体处理工具,可以与 SpatialMediaKit 结合使用,进行音频和视频的重新编码和处理。
MP4Box
MP4Box 是一个用于处理 MP4 文件的工具,可以与 SpatialMediaKit 结合使用,进行音频和视频的重新封装,确保 Apple 的定制空间视频元数据得以保留。
其他开源工具
SpatialMediaKit 还可以与其他开源工具结合使用,如 Blender 用于 3D 建模和动画,GIMP 用于图像处理等,构建一个完整的多媒体处理生态系统。
通过以上步骤,您可以快速上手使用 SpatialMediaKit,并结合其他开源工具,构建强大的多媒体处理工作流。