视频教程

---

Unity Vision Pro 中文课堂教程地址：

Unity3D Vision Pro 开发教程【保姆级】 | Unity 中文课堂

---

教程说明

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

开发前期准备（软硬件要求，开启 vision pro 开发者模式和 Wi-Fi 无线调试功能，Xcode 程序打包至头显）：

打开开发者选项，XCode无线调试发布

PolySpatial 官方文档：https://docs.unity3d.com/Packages/com.unity.polyspatial.visionos@1.3/manual/index.html

（需要时刻关注开发者文档，因为 PolySpatial 处于早期阶段，在未来可能有些地方会发生变动）

创建工程

要求

• 安装 visionOS Build Support

• 确保unity 账号为授权pro ，输入授权码激活授权

选择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)

导入PolySpatial 相关包

XR Plug-in Management 下方的 Apple visionOS 中将 App Mode 切换成自己想要的模式， 选择 Mixed Reality，会自动帮我们安装PolySpatial 包

然后 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。

设置开启手势和环境感知权限获取提示

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

导入 PolySpatial 样例场景

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

打开一个场景会提示，TMP Importer文本导入 ，进行导入

编辑器预览MR测试

开启 XR模拟器模拟XR环境测试

XR Plug-in Management 下的 PC平台 勾选XR Simulation

修复XRI

XR Grab Interactable 脚本引用丢失

导入XR Interaction Toolkit 包

Package Manage-> + ->Add package from git URL-> com.unity.xr.interaction.toolkit

导入案例资源

Starter Assets Hands Interaction Demo

Project Validation 修复

这里提示缺少 hand案例包 点击fix 自动导入

示例场景添加到发布列表

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

签名设置

Project Settings->Player ->Other Settings->Bundle Identifier

发布Xcode到电脑

Xcode 发布到Apple Vision Pro

找到发布的文件中 Unity-VisionOS.xcodeproj打开

发布