从零开始创建 visionOS 项目
本页介绍如何使用一种或多种可用模式从头开始项目。
需求
开始之前,请确保您满足Hardware and Software Requirements。
Windowed App
- 打开Build Settings窗口 (菜单:File > Build Settings)。
- 选择 visionOS 平台。
- 如有必要,请单击Switch Platform以更改为visionOS平台。
- 添加并选择您想要包含在构建中的任何场景。(例如,SampleScene。)
- 点击Build按钮。
默认情况下,Unity构建目标visionOS将被设置为在窗口模式下运行。如果您安装 XR 或 PolySpatial 支持(按照下面Fully Immersive Virtual Reality中的步骤1-8),您需要手动配置应用程序模式,以便构建和部署2D窗口应用程序:
- 打开项目设置。
- 将“XR Plug-in Management > Apple visionOS > App Mode”下的应用模式更改为“Windowed - 2D Window”。
窗口化应用程序使用Unity自己的渲染管线,例如内置渲染管线或通用渲染管线。有关详细信息,请参阅Windowed Apps。
Fully Immersive Virtual Reality
- 打开Project Settings窗口(菜单:Edit > Project Settings)。
- 选择XR Plug-in Management部分。
- 如果需要,单击Install XR Plug-in Management按钮。
- 选择visionOS目标构建平台的选项卡。
- 启用Apple visionOS插件提供程序。
- 选择XR Plug-in Management下的Apple visionOS设置部分。
- 将App Mode设置为Virtual Reality - Fully Immersive Space。
- 设置Target SDK以在设备或模拟器上运行。
- 打开Project Settings窗口(菜单:Edit > Project Settings),并选择Player部分。
- 在Other Settings > Configuration下,将Target SDK设置为Device SDK以在Apple Vision Pro设备上运行或将Simulator SDK设置为在模拟器上运行。
- 打开Build Settings窗口 (菜单:File > Build Settings)。
- 选择 visionOS 平台。
- 如有必要,请单击Switch Platform以更改为visionOS平台。
- 添加并选择您想要包含在构建中的任何场景。(例如,SampleScene。)
- 点击Build按钮。
您的应用程序将渲染一个完整的沉浸式空间,您应该可以看到 Unity 天幕箱(或您的应用程序)在Apple Vision Pro模拟器中运行。
有关更多信息,请参阅Fully Immersive VR文档
Mixed Reality and Shared Space
对于有界应用程序,您的应用程序可以与共享空间中的其他应用程序一起存在。对于无限制的应用程序,您的应用程序将是唯一可见的内容。
按照上面的步骤1-8进行操作,这次将App Mode设置为Mixed Reality - Volume or Immersive Space。
这应该会自动安装所需的软件包 com.unity.polyspatial、com.unity.polyspatial.visionos 和 com.unity.polyspatial.xr。
- 在场景中创建Volume Camera。
- 从GameObject > XR > Setup菜单或 XR Building Blocks叠加层,单击Volume Camera。
- 使用Create > PolySpatial > Volume Camera Window Configuration将VolumeCameraWindowConfiguration资源添加到您的项目中。您必须将此资源存储在项目的Resources文件夹之一中。(有关Resources文件夹的更多信息,请参阅Special Folders。)
- 将体积摄像机窗口配置分配给体积摄像机的Volume Window Configuration。
- 将体积摄像机配置为有界或无界模式,并调整尺寸(如果有界)。
- 尺寸调整内容的渲染比例。
- 对于有界应用程序,请确保某些内容在体积摄像机的尺寸内可见。
- 打开Build Settings窗口 (菜单:File > Build Settings)。
- 选择 visionOS 平台。
- 如有必要,请单击Switch Platform以更改为visionOS平台。
- 添加并选择您想要包含在构建中的任何场景。(例如,SampleScene。)
- 点击Build按钮。
Unbounded apps 对于使用ARKit功能的无界应用程序,请将com.unity.xr.arfoundation软件包添加到您的项目中。要使用骨骼手部跟踪数据,请将com.unity.xr.hands软件包添加到您的项目中。请参阅[XR packages](xref: XR -support-packages)获取有关Unity的XR包的更多信息。
Note
Apple Vision Pro模拟器不提供任何ARKit数据,因此平面、网格、轨迹手等在模拟器中不起作用。
有关更多信息,请参阅PolySpatial MR Apps。