Microtube 文档
Ctrl K
EN中文
SDK 0.9.4开发者GitHub ↗
开发者 / Godot / 项目设置

Godot 项目设置

安装 HexR 插件，并为 Meta Quest 和 PICO 配置你的项目。

准备工作

要求说明
Godot 4.6 或更高版本使用标准版即可，无需 .NET 版。已在 4.7.2 上测试。
Android 导出Android SDK、JDK 17 和 Godot 导出模板，按照 Godot 的 Android 导出指南进行设置。
OpenXR Vendors 插件5.1.0 或更高版本，用于 Meta Quest 和 PICO。HexR Tools 会为你安装（见下文）。
头显Meta Quest 2、3、3S 或 Pro，或 PICO 4 / 4 Ultra，需开启开发者模式。

安装插件

Unity 开发者把插件包的 git URL 粘贴到 Package Manager 中；Godot 开发者则是把一个插件文件夹添加到项目中。

  1. 下载发布包

    从插件的最新版本 ↗下载 HexR-Godot.zip。其中包含脚本，以及适用于 Android 和 Windows 的原生蓝牙层。0.2.0 是预览版：在 1.0 之前，其 API 仍可能变化。

  2. 解压到你的项目中

    解压后应得到 res://addons/hexr/。

  3. 启用插件

    在 Project → Project Settings → Plugins 中勾选 HexR。这会添加 HexR 自动加载项（autoload），并命名物理层 20（hexr_touch）和 21（hexr_interactable）。与 Unity 中一样，编辑器菜单栏中会出现 HexR 菜单，Inspector 下方会出现 HexR Tools 停靠面板。

以后更新：HexR Tools → Project Setup → Check for updates（Unity 中为 Package Manager → Update）。从 0.1 升级？请先删除 addons/hexr，安装新版本，然后在打开场景之前运行 HexR → Migration → Upgrade 0.1 Scenes。

配置头显

HexR Tools → Project Setup 可以替你完成这些设置：勾选 Meta Quest 和 PICO，然后点击 Install 安装 OpenXR Vendors 插件，点击 Apply 应用 XR 设置，点击 Add 添加导出预设。如果你更想手动设置，它所做的设置如下：

  1. OpenXR 与手部追踪

    Project Settings → XR → OpenXR：开启 Enabled，并开启 Extensions → Hand Tracking 和 Hand Interaction Profile。开启 XR → Shaders → Enabled。

  2. Android 构建模板

    Project → Install Android Build Template。HEXR 的蓝牙插件和 OpenXR Vendors 插件都需要使用 Gradle 构建。

  3. 导出预设

    添加一个 Android 预设：开启 Use Gradle Build，仅选 ARM64，XR Mode 设为 OpenXR，勾选 Enable Meta Plugin，Hand Tracking 设为 optional 或 required，Hand Tracking Frequency 设为 high，并勾选你要支持的 Quest 机型。

  1. OpenXR 与手部追踪

    与 Quest 相同：启用 OpenXR，开启 Hand Tracking 和 Hand Interaction Profile，开启 XR 着色器。

  2. Android 构建模板

    Project → Install Android Build Template。

  3. 导出预设

    开启 Use Gradle Build，选择 ARM64，XR Mode 设为 OpenXR，勾选 Enable Pico Plugin，开启 PICO 的 Hand Tracking，最低 SDK 设为 29（PICO 4 运行 Android 10）。

PICO 上的位置信息

在 Android 10 上，只有系统 Location（位置信息）开关打开时才会列出蓝牙设备，并且会请求位置权限。开关关闭时，状态文本会给出提示。

在 Windows 10 或 11（64 位）上，编辑器本身就能通过 HexR Tools 中的 Haptics Tester 连接手套。无需任何设置：插件自带蓝牙扩展。Windows 构建版本也以同样方式连接。在 macOS 和 Linux 上插件可以正常加载，但使用的是模拟手套。

检查配置

HexR → Troubleshoot → Validate Scene Setup 会打开 HexR Tools 的 HexR Setup 标签页：点击 Fix all，或在任何标有 ! 的行上点击 Fix。

想从一个可运行的项目开始？请使用 Quest 与 PICO 分步教程。

下一步

在场景中添加手部和 HEXR 装置：场景设置。