开发

Unity 示例框架（旧版）

更新时间: 2025年5月7日

Unity 示例框架能为开发者提供常见 VR 特定功能的示例场景，例如控制器的手部模拟、移动和自定义手势。你可以使用示例框架，在 Unity 编辑器中研究示例场景，查看功能的实现方法，而且有可能将框架集成到你自己的项目中。

为鼓励使用内容，该框架采用非常宽容的许可证。更多信息请参见 Assets\Oculus\SampleFramework 中的 license.txt。

下载 Oculus 集成⁠或在 Unity 编辑器的 Asset Store 选项卡中搜索 Oculus Unity 集成。

导入示例框架

示例框架是 Oculus Unity 集成的组成部分，可在 Unity 编辑器的 Asset Store 选项卡中搜索 Oculus 集成找到。Oculus Unity 集成包含脚本、prefab 及其他资源，能补充 Unity 对 VR 开发的内置支持能力。示例框架中使用的概念、游戏对象、prefab 和脚本可以搭配 Oculus 集成，用于开发你自己的应用程序。

要在 Unity 编辑器中导入 Oculus 集成：

确认你已安装建议的 Unity 版本（请参见兼容性和要求了解最新信息）。
启动 Unity 编辑器，创建一个新项目。
选择“Asset Store”选项卡，搜索 Oculus Integration⁠（Oculus 集成）。将集成导入你的项目中。
系统可能提示你更新 OVRPlugin。建议你使用最新版本。如果存在更新且你选择了安装，Unity 编辑器会重新启动。

探索示例场景

示例框架场景的设计使每个场景都能说明一个基本概念，这个概念对 Meta Quest 开发至关重要。为使操作尽可能简单，示例场景无需事先配置，而且可以在导入集成包并打开之后立即开始。

下面是运行示例框架场景的步骤：

在 Unity 项目窗口中，导航至 Oculus > SampleFramework（示例框架）> Usage（使用）。
在文件夹中打开一个 Unity 场景。
按下 Play（播放）按钮

示例场景此时应该会开始演示。有关场景的详情，请查看下表中的描述，也可以适时探索场景主题。运行示例场景之后，你可以随心所欲地对组成场景的对象、组件和脚本进行试验。

内容和示例场景

示例框架具有可重复使用的组件，供开发者在自己的现有项目中使用，此外还提供示例场景，用于演示这些组件的用法。

场景中使用的内容可在 \Assets\Oculus\SampleFramework\ 下的 \Usage\ 和 \Core\ 文件夹中找到。两个文件夹之间的内容划分如下：

\Core\ 文件夹包含各场景的子文件夹，其中包括场景核心功能的关键内容。该内容的设计是为了让开发者能够直接在自己现有的项目中轻松使用。
\Usage\ 文件夹包含开发者不太可能用到的内容。该内容通常与示例中有趣或突出的部分没有直接关系，而只是用来演示如何在工作场景中使用示例代码。

导入 Oculus 集成之后，示例场景可在 \Assets\Oculus\SampleFramework\Usage 中找到。下表中列出了这些示例。

场景	概念说明
CustomControllers	演示自定义控制器模型和可互动的动画。尽管并不鼓励在游戏玩法中使用控制器，但开发者可能希望能在某些特定情况下使用控制器，比如教程或试玩版中。
CustomHands	演示自定义手势模型的使用情况。开发者可以将它作为自有手势的起点，在现有的模型和动画基础上进行构建。
Hand Tracking	演示如何实现手势追踪，在使用火车示例的物理系统中，用手势与里面的物体进行互动。
Locomotion	演示各种移动方案的示例，让你了解如何在自己的应用中实现移动
OVROverlay	演示用 `OVROverlay` 合成图层制作的用户界面相比应用程序图层用户界面，如何实现图像质量和文本清晰度的改进。
Spatial Anchors	演示各种功能，包括处理和维护空间锚点。
Start Scene	展示一个简单的场景选择菜单，其中包含 Unity 示例框架中的其他场景。
Stereo180Video	演示如何播放 180 度立体视频。