互动 SDK 入门指南

• 设置 Unity 以用于 XR 开发，创建含有必要依赖项的项目
• 设置设备，在头戴设备上配置和测试项目
• 完成设置互动 SDK

1. 删除默认主相机（如果存在），因为互动 SDK 使用其自己的相机装置。
2. 右击 Hierarchy（层级结构），再依次选择 Interaction SDK（互动 SDK）> Add OVR Interaction Rig（添加 OVR 互动装置）快速操作。
   
3. 如果您的场景中已有 OVRCameraRig，它会在向导中显示为已引用，如果没有，请点击 Fix All（修复全部），这样向导将创建一个相机装置。
   
4. 如果场景中不需要平滑移动，请禁用 Smooth Locomotion（平滑移动）选项。否则，如果没有地面碰撞器，相机可能会在启动场景时无限掉落。
5. 在 Unity 中，不能直接将装置 Prefab 的修改保存到包文件夹中，但是 Unity 2022+ 可对您要覆盖的 Prefab 创建副本。选择 Generate as Editable Copy（生成可编辑的副本）并设置 Prefab Path（Prefab 路径）以存储装置 prefab 的中间副本，这样您就可以根据需要存储尽可能多的覆盖。
6. 如果想进一步自定义装置，请调整向导中的设置。有关可用选项的详细信息，请参阅 OVR 互动装置快速操作文档。
7. 单击 Create（创建）以将 OVR 互动装置添加到场景。
   
8. 在 Hierarchy（层级结构）中，选择 OVRCameraRig。
9. 在 Inspector（检查器）选项卡中，前往 OVR Manager（OVR 管理工具）> Quest Features（Quest 功能），然后找到 General（常规）选项卡，根据需要从 Hand Tracking Support（手势追踪支持）列表中选择 Controllers and Hands（控制器和手势）、Hands Only（仅限手势）或 Controllers only（仅限控制器）选项。“仅限手势”选项支持使用手势作为输入模态，无需借用任何控制器。

1. 在 Project（项目）窗口中，前往 Packages（包）> Meta XR Interaction SDK Essentials（Meta XR 互动 SDK 基本功能）> Runtime > Sample（示例）> Objects（对象）> UISet > Prefabs > Backplate（背板）文件夹，并将 EmptyUIBackplateWithCanvas prefab 拖动到 Hierachy（层级结构）窗口中来为用户界面添加背板。
   
   背板 prefab 包含画布、用户界面背景、一些基本布局组件以及光线和戳一下可互动组件，以便在用户界面中实现直接接触和光线投射互动。
   
2. 在 Hierarchy（层级结构）中，选择 CanvasRoot。在 Inspector（检查器）中的 Rect Transform（矩形变换）下，可以使用 Width（宽度）和 Height（高度）属性设置画布大小。在本示例中，我们使用以下设置将其缩放到适合几个组件的合理大小：
   • Rect Transform（矩形变换）> Width（宽度）：500
   • Rect Transform（矩形变换）> Height（高度）：250
3. 在 Hierarchy（层级结构）中，选择 UIBackplate。在 Inspector（检查器）中的 Rect Transform（矩形变换）下，设置 Width（宽度）和 Height（高度）属性，使其与先前步骤中设置的画布宽度和高度相匹配。在本示例中，我们使用以下设置以便与画布大小相匹配：
   • Rect Transform（矩形变换）> Width（宽度）：500
   • Rect Transform（矩形变换）> Height（高度）：250
4. 在要与之互动的窗口中添加一些用户界面元素，方法是：在 Packages（包）> Meta XR Interaction SDK Essentials（Meta XR 互动 SDK 基本功能）> Runtime（运行时）> Sample（示例）> Objects（对象）> UISet > Prefabs 文件夹中拖放 prefab。例如，在 Buttons（按钮）> UnityUIButtonBased 文件夹中，将 PrimaryButton_IconAndLabel_UnityUIButton prefab 拖动到 Hierarchy（层级结构）中的 UIBackplate 对象。按钮元素将出现在用户界面上。添加创建用户界面所需元素。
   

1. 右键点击用户界面的 Canvas（画布）对象，然后选择 Interaction SDK（互动 SDK）> Add Grab Interaction（添加拿取互动）。“拿取”向导随即出现。
   
2. 在“拿取”向导中，选择 Fix All（修复全部）来修复所有错误。这将添加缺失的组件或字段（如有需要）。
   
3. 如果您需要进一步自定义互动，可在向导中调整互动的设置。有关可用选项的详细信息，请参阅拿取快速操作文档。
4. 选择 Create（创建）。向导会自动将必要的互动组件添加到 GameObject。如果尚未配备这些组件，它还会在相机装备上添加组件。
   

1. 在您的电脑上打开 Link 桌面应用程序。
2. 戴上头戴设备，并在提示时启用 Link。
3. 在您的开发机器上，在 Unity 编辑器中选择 Play（播放）按钮。
4. 您可以在头戴设备中使用光线投射与用户界面直接互动或进行远距离互动。可通过拿取用户界面来移动它。

1. 确保头戴设备已连接到您的开发机器。
2. 在 Unity 编辑器中，选择 File（文件）> Build Profiles（构建配置文件）。
3. 点击 Open Scene List（打开场景列表），打开 Scene List（场景列表）窗口。
4. 通过从项目面板拖动或点击 Add Open Scenes（添加打开的场景），将您的场景添加到 Scene List（场景列表）。
5. 点击 Build and Run（构建并运行），以生成一个 .apk 文件，并在您的头戴设备上运行该文件。在打开的文件资源管理器中，选择一个位置保存该 .apk 文件并为其命名。构建过程可能需要几分钟时间。
6. 您可以在头戴设备中使用光线投射与用户界面直接互动或进行远距离互动。可通过拿取用户界面来移动它。

• 要了解互动 SDK 中的重要概念，请参阅架构概述。
• 如需了解其他设置方法，请参阅开始使用互动 SDK 和 Unity XR。