开发
Unity 启动器示例
更新时间: 2025年7月2日
Unity 启动器示例项目包括一些示例场景，用于展示 VR 特定功能，例如控制器的手部模拟、移动和自定义手势。在 Unity 编辑器中加载示例场景，以查看功能实现并将其集成到您的项目中。您可以从启动器示例 GitHub 存储库中下载此项目。
且可以根据许可证中的条款使用此项目。如需了解更多信息，请查看根目录中的许可证文件。
Oculus Integration SDK Release Deprecation
在 v59 及之上版本中，已将 Oculus 集成 SDK 替换为 Meta XR UPM 包。如需查看 Oculus 集成 SDK 中的示例框架场景说明，请参阅 Unity 示例框架。获取启动器示例项目
使用 GitHub 中的代码按钮克隆此存储库，或运行以下命令：
git clone https://github.com/oculus-samples/Unity-StarterSamples.git
如何在 Unity 中运行项目
- 请确保您使用的是 Unity 2022.3.15f1 或更新版本（推荐使用 Unity 6+）。
- 在 Unity Hub 中，选择项目选项卡。然后，从下拉菜单中依次选择添加 > 从磁盘添加项目。
- 点击以在 Unity 中打开项目。
- 在
Assets/StarterSamples/Usage中找到示例场景。 - 双击单个场景以将其打开。
- 点击播放按钮，探索 Unity 中的场景功能。
如何在设备上测试
- 前往 Meta > 示例 > 构建启动器场景，构建能启动启动器场景的 APK 文件。
- 在此 apk 中，您将能够循环浏览不同的示例场景以在设备上对其进行测试。
- 前往
Unity-StarterSamples文件夹，使用 Meta Quest 开发者中心将StartScene.apk复制到您的设备。
SDK 依赖项
您可以在 Unity 素材商店中找到所有 Meta SDK。此项目依赖于 Packages/manifest.json 中定义的 SDK：
URP 支持
启动器示例项目支持使用通用渲染管线。
为 URP 创建项目后，使用窗口 > 渲染 > 渲染管线转换器材质升级，自动将所有材质从使用标准着色器改为使用 URP 着色器。所有拥有自定义着色器的材质都经过修改，确保它们同时支持内置渲染管线和通用渲染管线。
将示例集成到您自己的项目
有两种方法来集成使用相同 Unity 版本的项目示例。
将示例移动到您的项目
将素材 > StarterSamples 目录复制到您自己的项目中
创建 UnityPackage 并导入
- 在 Unity 中打开
Unity-StarterSamples项目。 - 前往素材文件夹。
- 右键点击
StarterSamples，选择导出软件包…。 - 将软件包保存在容易检索的位置。
- 打开您自己的项目。
- 在菜单栏中点击素材 > 导入软件包 > 自定义软件包…。
- 找到我们在第 3 步中保存的软件包，点击打开。
内容和示例场景
启动器示例具有可重复使用的组件以供您在项目中使用，此外还提供了示例场景，用于演示这些组件的用法。
您可以在素材 > StarterSamples > 使用情况中找到场景中使用的内容。
Unity 启动器示例项目包括以下场景：
| 场景教程 | 概念说明 |
|---|---|
演示如何使用适合构建教程或演示的自定义控制器模型和可互动动画。 | |
演示如何创建和使用自定义手势模型和动画。 | |
演示如何测试启用和禁用透视功能和图层。 | |
Firebase | 演示如何在 Unity 应用中捕捉 Firebase Analytics 和 Crashlytics 指标。 |
演示如何实现手势追踪以在物理系统中与对象进行互动。 | |
演示各种运动控制方案。 | |
演示用 OVROverlay 合成图层创建的用户界面如何实现图像质量和文本清晰度的改进。 | |
演示如何创建用于将画布渲染成应用叠加效果的用户界面。 | |
OVROverlayCanvas_Text | 演示如何在应用叠加画布上显示文本。 |
演示环境透视。 | |
演示空间锚点的控制和管理。 | |
演示场景选择菜单，其中包含 Unity 启动器示例中的其他场景。 | |
TouchProSample | 演示食指触发器、手触发器、处于按下状态的拇指托以及用于控制触控笔的执行器的状态。 |
演示如何播放 180 度环绕立体声视频。 | |
演示如何在您的应用中集成 WidevineVideo，谷歌的数字版权管理 (DRM) 平台。 |
虚拟现实 / Meta Horizon
虚拟现实 / Meta Horizon
中文(简体)
© 2026 Meta