AVP Play：Quest 游戏移植工具

项目简介

AVP Play 是一款 Mac 应用，用来把你已经购买的 Quest 游戏安装到 Apple Vision Pro 上。它用你自己的 Meta 账号从商店下载已购游戏，在 Mac 上用 Klepton 工具链转换，再用你自己的 Apple 开发者账号签名，最后复制到头显。项目本身不附带任何游戏内容，也不会下载 Meta 未确认你已购买的内容。

主要功能

• 游戏目录与状态标签：Meta Store 的 Quest 游戏会以四种状态列出——Verified（项目测试过，recipes/ 中有配方）、Community Verified（玩家反馈可运行，或经社区修复后可运行）、Untested、Incompatible。未测试但你已拥有的游戏也可以尝试。
• 本地转换：游戏的 Android 版本由随应用附带的 Klepton 工具链转成 visionOS 应用，全部在你的 Mac 上完成。
• 签名与传输：用你的 Apple 账号签名，通过 Wi-Fi 复制到 Vision Pro，或在开发者腕带上用 USB 线传输（更快）。
• 统一启动窗口：每个游戏都从同一个窗口打开——Start、Settings（画面、游玩区域、控制），房间只需测量一次。
• 头显遥控：在侧边栏开启 Remote Control 后，可用 visionOS 应用 AVP Play Remote 浏览游戏、安装与更新、查看任务进度，实际工作仍由 Mac 完成；同一 Wi-Fi 内六位码配对一次，通信保持在本机网络内并加密。
• 菜单栏常驻：显示当前任务与进度、Vision Pro 与 AVP Play Remote 的连接状态，以及免费 Apple 账号下游戏的到期时间；关闭窗口后任务继续运行。
• 其他：保留已保存的游戏、可把下载放到外置磁盘、混合现实游戏在你自己的房间中显示、从本仓库的 release 自动更新。

安装与使用

1. 从最新 release 下载 AVP-Play-<version>.dmg，打开后把 AVP Play 拖进「应用程序」。
2. 打开应用，Setup 页面会检查 Xcode、Vision Pro、Apple 团队和商店账号，缺什么会提示怎么做。
3. 在 Games 里选一个游戏，点击 Install。Jobs 页面显示每一步，任务可随时停止和继续，已下载的部分不会丢失。

环境要求

• Mac：Apple 芯片，macOS 14 或更高，安装带 visionOS 平台的 Xcode。
• Vision Pro：已与 Xcode 配对、开启开发者模式、与 Mac 在同一 Wi-Fi。
• Apple 账号：Xcode 中登录了 Apple 开发者团队。免费账号受 Apple 限制（安装后 7 天内可打开，重新安装可续期；同时 3 个应用），付费的 Apple Developer Program 无此限制。
• Meta / Steam 账号：拥有这些游戏的账号。
• 控制器：游戏所需的控制器，通常是体感手柄；普通手柄可与双手一起使用。
• 磁盘空间：游戏体积从几百 MB 到 70 GB 以上，Mac 和头显上各需要一份。

自行构建

cd avp-play/core
tools/make-app.sh

core/Sources/AVPPlayCore 是库，AVPPlayApp 是 Mac 应用，avpplay 是功能相同的命令行工具。配方格式见 docs/recipes.md。

注意事项

• 账号与数据：登录交给商店官方工具（Meta 的 ovr-platform-util、Valve 的 SteamCMD），输入的内容不会被应用保存；Meta 的 token 存在 macOS 钥匙串中，只发送给 Meta。
• 只处理你拥有的内容：下载前会先确认所有权，附加内容也只处理已确认购买的部分。
• 文件留在本地：游戏文件、构建和存档都在你的 Mac 和头显上，不会与本项目共享。
• 遥测：项目目录服务 avpplay.martek.de 会收到你搜索的内容、打开的游戏页面、你主动提交的报告，以及每天一次的匿名使用与安装统计，这些都可以在设置中关闭。项目本身没有账号系统。
• 兼容性：作者一人开发，只在一台 Mac 和一台 Vision Pro 上测试，加上其他玩家的反馈，可能会有粗糙之处。
• 法律：本项目与 Apple、Meta 及任何游戏发行商无关联，也不受其支持。它不包含游戏内容，不绕过购买校验；这样使用已购游戏是否符合商店与游戏条款，需要你自行确认，使用风险自负。项目本身以 MIT 许可证发布。

本作品整理自 GitHub 开源项目 myMartek/avp-play，原作者 @myMartek，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。