Unity Apple Vision Pro 开发（二）：Unity 环境配置、导入 PolySpatial 案例、PlayToDevice 实时预览、程序打包

此教程相关的详细教案，文档，思维导图和工程文件会放入 Spatial XR 社区。这是一个高质量 XR 开发者社区，博主目前在内担任 XR 开发的讲师。该社区提供专人答疑、完整进阶教程、从零到一项目孵化保姆服务、投资|融资对接、工程文件下载等服务。

社区链接：
SpatialXR社区：完整课程、项目下载、项目孵化宣发、答疑、投融资、专属圈子

---

📕教程说明

这期教程我将介绍使用 Unity 开发 Apple Vision Pro 应用所需要的 Unity 环境配置，以及如何导入 PolySpatial 样例场景、配置 Play To Device 实时预览功能、将 Unity 程序打包到头显中运行。

开发前期准备（软硬件要求，开启 vision pro 开发者模式和 Wi-Fi 无线调试功能，Xcode 程序打包至头显）：https://blog.csdn.net/qq_46044366/article/details/139250580

视频讲解：苹果VisionPro开发 2 —Unity环境配置+实时预览调试+程序打包

PolySpatial 官方文档：https://docs.unity3d.com/Packages/com.unity.polyspatial.visionos@1.2/manual/index.html
（需要时刻关注开发者文档，因为 PolySpatial 处于早期阶段，在未来可能有些地方会发生变动）

---

📕教程内容概括

这期教程主要目标是成功运行 PolySpatial 官方样例场景，PolySpatial 是 Unity 提供的用于开发 visionOS 的 MR 应用的开发工具。

---

📕Unity 配置

⭐添加 visionOS Build Support 模块

安装 Unity 编辑器的时候需要添加 visionOS Build Support 模块，如果之前没有添加过，也可以在 Unity Hub 里手动给对应版本的编辑器添加。

安装了这个模块后，我们在打包 Unity 程序的时候就能够选择 visionOS 作为打包发布的平台，visionOS 是苹果头显独立的操作系统。

⭐添加 Unity Pro 许可证

Unity 开发 Apple Vision Pro 的应用有分为三种模式：窗口模式，VR 模式，MR 模式。这三种模式的区分我会在下期教程进行详细的说明。如果开发的是窗口模式，不需要添加 Unity Pro 许可证，如果开发的是 VR 或者 MR 模式，需要添加 Unity Pro 许可证。

添加 Unity Pro 许可证可以在 Unity Hub 中点击自己的头像，选择 Manage licenses

然后点击右上角的 Add，点击第一个选项，输入 Unity Pro 的激活码：

⭐Unity 渲染管线选择

可以选择默认的 3D Build-in 渲染管线，也可以选择 URP。不过导入 PolySpatial 后如果项目不是 URP，也会自动升级成 URP。

⭐Build Settings 里切换 visionOS

在 Unity 的 File>Build Settings 里将打包发布平台切换成切换 visionOS。Target SDK 处，如果要把程序打包到头显中运行，选择 Device SDK。如果要让程序在 Xcode 模拟器里运行，选择 Simulator SDK。

⭐XR Plug-in Management 设置

Edit > Project Settings 添加 XR Plug-in Management，勾选 Apple visionOS（只有添加了 Unity Pro 许可证才能勾选上）

勾选后 Unity 会让你导入新版输入系统 Input System，然后重启编辑器，我们点击 Yes 就能自动进行。

然后 Unity 也会自动帮我们导入这些包：

• Apple visionOS XR Plugin (com.unity.xr.visionos)
• AR Foundation (com.unity.xr.arfoundation)
• XR Core Utilities (com.unity.xr.core-utils)

⭐切换 MR 模式

XR Plug-in Management 下方的 Apple visionOS 中将 App Mode 切换成自己想要的模式，导入 PolySpatial 需要选择 Mixed Reality。

然后 Unity 会帮我们导入 PolySpatial 相关的包。

• PolySpatial (com.unity.polyspatial)
• PolySpatial XR (com.unity.polyspatial.xr)
• PolySpatial visionOS (com.unity.polyspatial.visionos)

如果导入后发现 XR Plug-in Management 下只剩下 Project Validation，可以重启一下 Unity 项目。

⭐Project Validation

XR Plug-in Management 下的 Project Validation 点击 Fix All。

⭐Hand Tracking Usage Description 和 World Sensing Usage Description

XR Plug-in Management 下的 Apple visionOS 中填写 Hand Tracking Usage Description 和 World Sensing Usage Description，填写的内容会在程序请求手追和空间数据权限的时候出现。

例如 Unity 中填写的是：

Hand Tracking Usage Description：Input
World Sensing Usage Description：MR

那么之后在程序中显示的是：

📕导入 PolySpatial 样例场景

Window > Package Manager 中导入 PolySpatial 的两个 Sample

打开 Samples > PolySpatial > Scenes 的 Project Launcher 场景，此场景相当于所有样例场景的启动器，然后根据弹窗的信息导入 TMP Essentials。

如果项目之前的渲染管线是默认的渲染管线，那么你会发现导入样例后场景中物体是紫色的。这时候需要手动进行一次 URP 的材质升级，将原来渲染管线的材质转换成 URP。点击 Window > Rendering > Render Pipeline Converter，勾选所有选项，点击 Initialize And Convert。

📕配置 Play To Device

Play To Device 相当于 Unity 中的 Vision Pro 串流调试工具。当电脑和头显连接到一起的时候，点击 Unity 运行按钮，可以在头显中实时预览 Unity 中的场景，就不用每次调试都打包到头显中运行。

但是，发布这篇文章的时候，Play To Device 只支持显示预览 MR 模式下的 Shared Space 共享空间的应用类型，像 VR 应用和需要用到 ARKit 特性的功能还不支持在 PolySpatial 中预览。

⭐安装 TestFlight 和 Unity Play To Device Host

首先，在 Mac 上下载 TestFlight，然后在 Test Flight 中安装 Unity Play To Device Host，版本必须和 Unity 的 PolySpatial 版本一致。可以从这个链接进入下载：https://testflight.apple.com/join/FVMH8aiG

然后在 VP 上下载 TestFlight，登录和 Mac 相同的 Apple ID，这个时候能在 VP 的 TestFlight 看到 Unity Play To Device Host，安装后点击 Open，也可以直接在应用列表里找到 Play To Device Host 打开，此时界面会显示 IP，这个 IP 待会儿会用到。

⭐Unity 配置 Play To Device

打开 Unity 的 Window > PolySpatial > Play To Device，Advance Settings 里将Name 改成自己喜欢的名字，将 Host IP 改成 VP 里 Play To Device Host 里显示的 IP，然后Add Device，点击Connect，再把 Connect To Play 改成 Enabled

配置完毕后，之后如果想要在头显里实时预览 Unity 画面，只要在头显里打开 Play To Device Host，然后点击 Unity 运行按钮，如果头显显示 Unity 画面即配置成功，关闭应用时最好在 Unity 中再次点击运行按钮将程序退出。如果 Unity 的 Console 控制台里显示连接不上 IP，并且确保输入的 IP 是正确的，可以在 VP 里把 Play To Device Host 的后台清理掉（长按头显上方的两个按钮，会弹出后台应用列表），再重新尝试。

📕Unity 程序打包到头显中运行

打开 File > Build Settings，把所有样例场景拖到 Scenes In Build 列表下，并且将 Project Launcher 场景放置第一位。

点击 Build，选择一个打包的文件夹，接下来 Unity 程序就会被打包成一个 Xcode 工程。我们打开 Xcode，打开刚刚转换的 Xcode 工程，选择后缀为 xcodeproj 的文件。

这个时候 Xcode 界面就会显示出由 Unity 程序转换成的 Xcode 项目。然后点击工程文件夹里最顶端的文件夹，点击 Signing & Capabilities，勾选 Automatically manage signing，然后在 Team 处关联自己的苹果开发者账号。

打包设备选择与电脑相连的头显设备，然后点击运行按钮点击 Xcode 中的运行按钮，就能将 Xcode 程序打包然后传输到头显里。