Spatial-Metadata 的安装和配置教程

1. 项目基础介绍和主要编程语言

Spatial-Metadata 是一个开源项目，旨在为 Apple Vision Pro 和 Meta Quest HMDs 准备沉浸式内容，通过编码 MV-HEVC 格式的视频实现。该项目提供了一个图形用户界面（GUI），使得用户能够轻松地选择视频文件并进行编码。主要编程语言包括使用 Xojo 开发的 GUI 包装器和 Lua 脚本。

2. 项目使用的关键技术和框架

• Xojo：用于编译 GUI 包装程序，快速开发桌面应用程序。
• Lua：用于在 DaVinci Resolve 中实现媒体命令和触发脚本，以批量处理视频文件。
• Homebrew：macOS 上的包管理器，用于安装项目所需的 Spatial CLI 工具。
• Spatial CLI：命令行工具，用于执行视频编码和嵌入空间元数据。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

• 确保您的操作系统为 macOS 14+（Sonoma）。
• 安装 Homebrew 包管理器（如果尚未安装）。

安装步骤

1. 打开 macOS 终端。

2. 安装 Homebrew（如果尚未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

3. 使用 Homebrew 安装 Spatial CLI 工具：

   brew install spatial
   

   安装完成后，Spatial CLI 工具将位于 /opt/homebrew/bin/spatial。

4. 下载 Spatial Metadata GUI 的最新版本。您可以从项目的 GitHub 释放页面上下载 zip 归档文件。

5. 解压下载的 zip 文件，您将得到一个包含程序的文件夹。

6. 运行 Spatial Metadata GUI 程序。在文件夹中找到 Spatial Metadata GUI 应用程序并打开它。

7. 在 GUI 中，点击 "Select Movie" 按钮选择视频文件，然后点击 "Encode Video" 按钮开始编码。

注意事项

• 在使用 Spatial Metadata GUI 之前，请确保您的视频文件格式和分辨率符合项目要求。
• 如果需要重新导出视频文件，请确保勾选 "Overwrite an Existing Movie File Export" 复选框。

通过上述步骤，您可以成功安装和配置 Spatial-Metadata 项目，并开始准备沉浸式内容进行播放。