Godot 场景设置

将 HEXR 装置（rig）放入你的 XR 场景，看到你的双手，并连接手套。

HEXR 场景需要什么

手套本身归属于 HexR 自动加载，因此切换场景时仍会保持连接。每个场景各自带有自己的装置。

搭建场景

1. 创建装置

   打开你的 3D 场景，选择 HexR → Create HexR Rig。如果场景中还没有，它会添加一个带相机的 XROrigin3D。

2. 添加菜单

   HexR → Add HexR Menu 会像 Unity 一样，把菜单放在你前方偏左的位置，并面向你。切换场景时它会一直跟随你；捏住其标题栏即可移动它。

3. 列出你的场景

   Project Settings → HexR → Scenes（Unity 中为 Build Settings）。菜单的 Scenes 部分、HexR Remote 和 SceneLoader.load_scene() 都在这些场景之间切换。

4. 检查项

   HexR → Troubleshoot → Validate Scene Setup。

XR 会自动启动：只要头显运行时可用，HexRRig 就会开启 OpenXR（由其 Start XR 选项控制），也可与 Godot XR Tools 的 StartXR 一起使用。若想一次得到包含以上全部内容的场景，请使用 HexR → Create Demo Scene。

看到你的双手

HEXR 直接读取 OpenXR 手部追踪器，因此无论有没有手部网格，触点都能正常工作。如需看到双手，请将手部模型放在追踪 /user/hand_tracker/left（或 right）的 XRNode3D 下，并为其骨架添加 XRHandModifier3D。教程中的 scripts/hand_visual.gd 正是这样做的，使用的是 Godot 演示项目中的手部模型。

连接手套

打开手套电源，然后戳按悬浮菜单上的 Connect Left Glove（右手同理）。不要在头显的蓝牙设置中配对手套。首次连接时，头显会请求 Nearby devices（Quest）或 Location（PICO）权限。通过代码连接：

# Anywhere in your game: the HexR autoload owns both gloves.
func _ready() -> void:
    HexR.glove_connected.connect(func(hand): print(HexRTypes.hand_name(hand), " connected"))
    HexR.glove_disconnected.connect(func(hand): print(HexRTypes.hand_name(hand), " disconnected"))
    # Asks for the Bluetooth permission first where the headset needs it.
    # Does nothing for a glove that is already connected or connecting.
    HexR.connect_hand(HaptGloveHandler.HandType.LEFT)    # Unity: HexRManager.Instance.Connect(...)
    HexR.connect_hand(HaptGloveHandler.HandType.RIGHT)

手套连接中断后会自动重连，分别在 1、2、4 和 8 秒后重试，最长持续一分钟。手套在断开连接之前，以及应用暂停或退出时，都会先被释放。

将应用安装到头显

将头显连接到电脑，然后点击 Godot 的 Remote Deploy 按钮，或导出 APK 并使用 adb install 安装。应用运行期间，将 HexR Tools 中的 Haptics Tester 设为 Running game，即可通过调试器从编辑器驱动该应用连接的手套。