---
title: Unity XR 输入
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/input/xr_input
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/input/xr_input.md
last_updated: 2026-10-30
generated_at: 2026-11-18T12:11:21.894Z
locale: zh-cn
---

# Unity XR 输入

> 访问 VR AR 的设备控制和Features。

Unity 用户手册的本节提供有关 Unity 支持的All虚拟现实、增强现实和 Windows 混合现实Applications程序的输入Devices的信息。Page 涵盖以下主题：

* [XR 输入映射](#XRInputMappings)
* [访问输入 Devices](#AccessingInputDevices)
* [访问输入设备上的输入 Features](#AccessingInputFeatures)
* [通过 Legacy Input System 访问 XR 输入](#XRInputLegacySystem)
* [触觉](#Haptics)

XR 平台具有丰富的输入Features，在设计用户交互When可以利用这些功能。应用程序程序可以使用引用位置、旋转、触摸、按钮、游戏杆和手指传感器的指定的数据。但是，访问这些输入Features可能会因平台而异。实例表明，桌面端 VR 头盔之间可能存在微小差异，但已启用 VR 的桌面平台和独立平台移动端头盔可能差异更大。

Unity 提供了名为 [InputFeatureUsage](/engine/6000.0/script-reference/unityengine/xr/inputfeatureusage.md) 的 C# 结构，该结构定义了访问 Any Platform 用户输入的物理设备控制（例如按钮和触发器）的标准设置。这些有助于按 Name 识别输入类型。有关每个`InputFeatureUsage`的定义，请参阅 [XR.input.CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md)。

每个`InputFeatureUsage`对应于一个共同的输入 Action 或类型。例如，Unity 将称为 `trigger` 的`InputFeatureUsage`定义为由索引手指控制的单一轴输入，无论您使用哪个 XR 平台。您可以使用 `InputFeatureUsage` 使用其 Name 获取`trigger`状态，因此无需为常规 Unity 输入系统设置轴（或 ON 某些 XR 平台的按钮）。

## XR 输入射##xr-input-mappings

下表列出了标准控制器`InputFeatureUsage`名称以及它们如何映射到常用 XR 系统的控制器：

| **InputFeatureUsage**                                                                                   | **功能类型** | **Legacy 输入索引**（左控制器/右控制器） | **WMR**       | **Oculus**         | **GearVR**   | **白日夢**      | **OpenVR（完整）** | **萬岁**       | **Oculus via OpenVR** | **通过 OpenVR 实现 WMR** |
| ------------------------------------------------------------------------------------------------------- | -------- | -------------------------- | ------------- | ------------------ | ------------ | ------------ | -------------- | ------------ | --------------------- | -------------------- |
| [primary2DAxis](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxis.md)           | 2D 轴     | \[(1,2)/(4,5)]             | 触控板           | 游戏杆                | 触控板          | 触控板          | 触控板/游戏杆        | 触控板          | 游戏杆                   | 游戏杆                  |
| [trigger](/engine/6000.0/script-reference/unityengine/xr/commonusages/trigger.md)                       | 轴        | \[9/10]                    | Trigger（触发器）  | Trigger（触发器）       | Trigger（触发器） | Trigger（触发器） | Trigger（触发器）   | Trigger（触发器） | Trigger（触发器）          | Trigger（触发器）         |
| [grip](/engine/6000.0/script-reference/unityengine/xr/commonusages/grip.md)                             | 轴        | \[11/12]                   | 握把            | 握把                 |              | 保险杠          | 握把             | 握把           | 握把                    | 握把                   |
| [secondary2DAxis](/engine/6000.0/script-reference/unityengine/xr/commonusages/secondary2daxis.md)       | 2D 轴     | \[(17,18)/(19,20)]         | 游戏杆           |                    |              |              |                |              |                       | 触控板                  |
| secondary2DAxisClick                                                                                    | 按钮       | \[18/19]                   | 游戏杆 - 单击      |                    |              |              |                |              |                       |                      |
| [primaryButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/primarybutton.md)           | 按钮       | \[2/0]                     |               | \[X/A] - 按         |              | 应用           | 主要             | 主（三明治按钮）(1)  | 主要 (Y/B)              | 菜单                   |
| [primaryTouch](/engine/6000.0/script-reference/unityengine/xr/commonusages/primarytouch.md)             | 按钮       | \[12/10]                   |               | \[X/A] - 触摸        |              |              |                |              |                       |                      |
| [secondaryButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/secondarybutton.md)       | 按钮       | \[3/1]                     |               | \[Y/B] - 按         |              |              | 备用             |              | 备用 (X/A)              |                      |
| [secondaryTouch](/engine/6000.0/script-reference/unityengine/xr/commonusages/secondarytouch.md)         | 按钮       | \[13/11]                   |               | \[Y/B] - 触摸        |              |              |                |              |                       |                      |
| [gripButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/gripbutton.md)                 | 按钮       | \[4/5]                     | Grip - 按      | Grip - 按           |              |              | Grip - 按       | Grip - 按     | Grip - 按              | Grip - 按             |
| [triggerButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/triggerbutton.md)           | 按钮       | \[14/15]                   | 触发器 - 按       | 触发器 - 按            | 触发器 - 按      | 触发器 - 按      | 触发器 - 按        | 触发器 - 按      | 触发器 - 触摸              | 触发器 - 按              |
| [menuButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/menubutton.md)                 | 按钮       | \[6/7]                     | 菜单            | Start（仅限左控制器）      |              |              |                |              |                       |                      |
| [primary2DAxisClick](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxisclick.md) | 按钮       | \[8/9]                     | 触控板 - 单击      | Thumbstick - 按     | 触控板 - 按      | 触控板 - 按      | 触控板/游戏杆 - 按    | 触控板 - 按      | 游戏杆 - 按               | 触控板 - 按              |
| [primary2DAxisTouch](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxistouch.md) | 按钮       | \[16/17]                   | 触控板 - 触控      | Thumbstick - Touch | 触控板 - 触控     | 触控板 - 触控     | 触控板/游戏杆 - 触控   | 触控板 - Touch  | 游戏杆 - 触摸              | 触控板 - 触控             |
| [batteryLevel](/engine/6000.0/script-reference/unityengine/xr/commonusages/batterylevel.md)             | 轴        |                            | battery.level |                    |              |              |                |              |                       |                      |
| [userPresence](/engine/6000.0/script-reference/unityengine/xr/commonusages/userpresence.md)             | 按钮       |                            | 用户存在          | 用户存在               |              |              |                |              |                       |                      |

(1) Sandwich 按钮是指 Vive 菜单按钮。为了更好地手柄跨平台 Applications，此按钮映射到 primaryButton 而不是 menuButton。

请参阅 [XR.input.CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md) 以了解每个`InputFeatureUsage`的定义。

## 访问输入 Devices##accessing-input-devices

[InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md) 代表任何物理设备，例如控制器、移动端 Phone 或头盔。它可以包含有关设备跟踪、按钮、游戏杆和Other输入控制的信息。有关 ON `InputDevice` API 的更多信息，请参阅 ON [InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md) 文档。

使用 [XR.InputDevices](/engine/6000.0/script-reference/unityengine/xr/inputdevices.md) 类可以访问当前连接到 XR System 的输入 Devices。要获取 All connected Devices 的列表，请使用 [InputDevices.GetDevices](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdevices.md)：

```lang-cs
var inputDevices = new List<UnityEngine.XR.InputDevice>();
UnityEngine.XR.InputDevices.GetDevices(inputDevices);

Foreach（inputDevices 中的不同设备）
{
    Debug.Log(string.Format("Device found with name '{0}' and role '{1}'", device.name, device.role.ToString()));
}
```

输入设备在帧之间保持有效，直到 XR System断开连接。使用 [InputDevice.IsValid](/engine/6000.0/script-reference/unityengine/xr/inputdevice/isvalid.md) 属性可确定`InputDevice`是否仍代表活动控制器。

您可以通过以下方式访问输入 Devices：

* Characteristics（特征）：
* 角色
* XR 节点

### 按特征访问输入 Devices##accessing-input-devices-by-characteristics

设备特征描述了设备的功能或用途（例如，设备是否为头部安装）。[InputDeviceCharacteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics.md) 是一系列标志，可添加到代码中以搜索符合特定规格的 Devices。您可以按以下特征过滤器Devices：

| **设备**                                                                                                              | **特色**                                                                                                |
| ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| [HeadMounted](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/headmounted.md)             | 设备所挂的到用户的头部。它具有设备跟踪和中心眼睛跟踪。此标志最常用于标识头部安装显示器 (HMD)。                                                    |
| [Camera](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/camera.md)                       | 设备具有摄像机追迹。                                                                                            |
| [HeldInHand](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/heldinhand.md)               | 用户将设备握在手中。                                                                                            |
| [HandTracking](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/handtracking.md)           | 设备表示物理跟踪的手。它具有设备跟踪功能，可能包含手和骨骼数据。                                                                      |
| [EyeTracking](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/eyetracking.md)             | 该设备可进行眼睛跟踪并具有 [EyesData](/engine/6000.0/script-reference/unityengine/xr/commonusages/eyesdata.md) 功能。 |
| [TrackedDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/trackeddevice.md)         | 可在 3D Space间中跟踪设备。它具有设备跟踪。                                                                            |
| [Controller（数据控制者）](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/controller.md)        | 设备具有按钮和轴的输入数据，可用作控制器。                                                                                 |
| [TrackingReference](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/trackingreference.md) | 设备表示Static跟踪引用Object。它具有设备跟踪功能，但该跟踪数据不应Change。                                                        |
| [左](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/left.md)                              | 将此特征与 HeldInHand 或 HandTracking 特征结合使用，可将设备标识为与左关联。                                                   |
| [右](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/right.md)                             | 将此特征与 HeldInHand 或 HandTracking 特征结合使用，可将设备识别为与右手关联。                                                  |
| [Simulated6DOF](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/simulated6dof.md)         | 设备会Reports 6DOF 数据，但只有 3DOF 传感器。Unity 模拟位置数据。                                                         |

XR 提供程序插件会Reports这些特征。您可以使用 [InputDevice.Characteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevice/characteristics.md) 查找它们。设备可以并且通常应该具有多个个特征，您可以使用位标志进行过滤器和访问。

[InputDevices.GetDevicesWithCharacteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdeviceswithcharacteristics.md) 提供了一种搜索具有给定特征设置的 All Devices 的方法。例如，可使用以下代码searchSystem中可用的 左、HoldInHand、控制器 InputDevice：

```lang-cs
var leftHandedControllers = new List<UnityEngine.XR.InputDevice>();
var desiredCharacteristics = UnityEngine.XR.InputDeviceCharacteristics.HeldInHand | UnityEngine.XR.InputDeviceCharacteristics.Left | UnityEngine.XR.InputDeviceCharacteristics.Controller;
UnityEngine.XR.InputDevices.GetDevicesWithCharacteristics(desiredCharacteristics, leftHandedControllers);

Foreach（leftHandedControllers 中的不同设备）
{
    Debug.Log(string.Format("Device name '{0}' has characteristics '{1}'", device.name, device.characteristics.ToString()));
}
```

此函数找到的Devices至少包含指定的特征，但可能包含其他特征。例如，要查找左手控制器，只能查找 InputDeviceCharacteristic.left，而不能查找 InputDeviceCharacteristic.Controller。

### 按角色访问输入 Devices##accessing-input-devices-by-role

设备角色描述输入设备的 General 函数。使用 [InputDeviceRole](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole.md) 枚举可指定设备角色。定义的角色包括：

| **角色**                                                                                                   | **描述**                                  |
| -------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [GameController](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/gamecontroller.md)       | 控制台样式的游戏控制器。                            |
| [通用](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/generic.md)                          | 表示核心 XR 设备的设备，例如头部式显示器或移动端设备。           |
| [HardwareTracker](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/hardwaretracker.md)     | 跟踪设备。                                   |
| [LeftHanded](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/lefthanded.md)               | 与用户左关联的设备。                              |
| [RightHanded](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/righthanded.md)             | 与用户右手关联的设备。                             |
| [TrackingReference](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/trackingreference.md) | 跟踪OtherDevices的设备，例如 Oculus 跟踪摄像Camera。 |

XR 提供程序插件会Reports这些角色，但不同的提供程序可能会以不同方式组织其设备角色。此外，用户可以切换手，因此角色分配可能与用户握持输入设备的手不Match。例如，用户可以将控制器配置为右手或左手，但以 Other 手握住控制器。

[GetDevicesWithRole](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdeviceswithrole.md) 提供具有指定`InputDeviceRole`的任何 Devices 的列表。例如，您可以使用 `InputDeviceRole.GameController` 获取任何连接的 `GameController` Devices：

```lang-cs
var gameControllers = new List<UnityEngine.XR.InputDevice>();
UnityEngine.XR.InputDevices.GetDevicesWithRole(UnityEngine.XR.InputDeviceRole.GameController, gameControllers);

Foreach（GameControllers 中的不同设备）
{
    Debug.Log(string.Format("Device name '{0}' has role '{1}'", device.name, device.role.ToString()));
}
```

### 通过 XR 节点访问输入 Devices##accessing-input-devices-by-xr-node

XR 节点表示 XR System 中的物理参考点（例如，用户的头部位置、他们的左右手或跟踪参考，例如 Oculus Camera）。

[XRNode](/engine/6000.0/script-reference/unityengine/xr/xrnode.md) 枚举定义了以下节点：

| **XR 节点**                                                                                       | **描述**                                |
| ----------------------------------------------------------------------------------------------- | ------------------------------------- |
| [CenterEye](/engine/6000.0/script-reference/unityengine/xr/xrnode/centereye.md)                 | 用户眼睛瞳孔中间的一点。                          |
| [GameController](/engine/6000.0/script-reference/unityengine/xr/xrnode/gamecontroller.md)       | 控制台样式的游戏控制器。您的应用程序可以有多个游戏控制器 Devices。 |
| [HardwareTracker](/engine/6000.0/script-reference/unityengine/xr/xrnode/hardwaretracker.md)     | 硬件跟踪设备，通常所挂的到用户或物理Item。可以存在多个硬件跟踪器节点。 |
| [头部](/engine/6000.0/script-reference/unityengine/xr/xrnode/head.md)                             | 用户头部的中心点，由 XR System 计算。              |
| [LeftEye](/engine/6000.0/script-reference/unityengine/xr/xrnode/lefteye.md)                     | 用户的左。                                 |
| [LeftHand](/engine/6000.0/script-reference/unityengine/xr/xrnode/lefthand.md)                   | 用户的左。                                 |
| [RightEye](/engine/6000.0/script-reference/unityengine/xr/xrnode/righteye.md)                   | 用户的右眼。                                |
| [RightHand](/engine/6000.0/script-reference/unityengine/xr/xrnode/righthand.md)                 | 用户的右手。                                |
| [TrackingReference](/engine/6000.0/script-reference/unityengine/xr/xrnode/trackingreference.md) | 跟踪参考点，例如 Oculus Camera。可以存在多个跟踪参考节点。  |

使用 [InputDevices.GetDevicesAtXRNode](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdevicesatxrnode.md) 获取与指定`XRNode`关联的 Devices 列表。以下示例演示了如何获取左手控制器：

```lang-cs
var leftHandDevices = new List<UnityEngine.XR.InputDevice>();
UnityEngine.XR.InputDevices.GetDevicesAtXRNode(UnityEngine.XR.XRNode.LeftHand, leftHandDevices);

if(leftHandDevices.Count == 1)
{
    UnityEngine.XR.InputDevice device = leftHandDevices[0];
    Debug.Log(string.Format("Device name '{0}' with role '{1}'", device.name, device.role.ToString()));
}
else if(leftHandDevices.Count > 1)
{
    Debug.Log("Found more than one left hand!");
}
```

### 监听设备连接和断开连接##listening-for-device-connections-and-disconnections

输入 Devices 在帧与帧之间保持一致，但可以在 Any 时间连接或断开连接。要避免重复检查设备是否已连接到平台，请使用 [InputDevices.deviceConnected](/engine/6000.0/script-reference/unityengine/xr/inputdevices/deviceconnected.md) 和 [InputDevices.deviceDisconnected](/engine/6000.0/script-reference/unityengine/xr/inputdevices/devicedisconnected.md) 在设备连接或断开连接时通知应用程序。这些还为您提供了对新连接的输入设备的引用。

由于可以在多个个帧保留这些引用，因此设备可能会断开连接连接，或者不再可用。要检查设备的输入是否仍然可用，请使用 [InputDevice.isValid](/engine/6000.0/script-reference/unityengine/xr/inputdevice/isvalid.md)。访问输入 Devices 的脚本应在尝试使用该设备之前，在每个帧的 Start 进行检查。

## 访问输入设备ON的输入Features##accessing-input-features-on-an-input-device

可从指定的 [InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md) 读取输入功能，例如触发器按钮的状态。例如，要读取右触发器的状态，请执行以下步骤：

1. 使用 [InputDeviceRole.RightHanded](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/righthanded.md) 或 [XRNode.RightHand](/engine/6000.0/script-reference/unityengine/xr/xrnode/righthand.md) 获取右手设备的实例。
2. 拥有正确的设备后，使用 [InputDevice.TryGetFeatureValue](/engine/6000.0/script-reference/unityengine/xr/inputdevice/trygetfeaturevalue.md) 方法来访问当前状态。

`TryGetFeatureValue()` 尝试访问功能的当前值，并返回：

* 如果成功检索到指定的功能值，则为 true
* 如果当前设备不Support指定功能，或者设备无效（即控制器不再Active），则为 false

要获取特定按钮、触摸输入或 Joystick Axis 值，请使用 [CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md) 类。`CommonUsages` 包括 [XR 输入 Mapping 表](#XRInputMappings)中的每个`InputFeatureUsage`以及跟踪功能（如位置和 Rotation）。以下代码示例使用 [CommonUsages.triggerButton](/engine/6000.0/script-reference/unityengine/xr/commonusages/triggerbutton.md) 来检测用户当前是否正在按下特定`InputDevice`实例的触发器按钮：

```lang-cs
bool triggerValue;
if (device.TryGetFeatureValue(UnityEngine.XR.CommonUsages.triggerButton, out triggerValue) && triggerValue)
{
    Debug.Log("Trigger button is pressed.");
}
```

还可以使用 [InputDevice.TryGetFeatureUsages](/engine/6000.0/script-reference/unityengine/xr/inputdevice/trygetfeatureusages.md) 方法获取设备提供的每个`InputFeatureUsage`的列表。此函数返回 [InputFeatureUsage](/engine/6000.0/script-reference/unityengine/xr/inputfeatureusage.md) 项的列表，这些项具有描述该功能的类型和 Name 属性。以下示例枚举了给定输入设备提供的All布尔值Features：

```lang-cs
var inputFeatures = new List<UnityEngine.XR.InputFeatureUsage>();
if (device.TryGetFeatureUsages(inputFeatures))
{
    Foreach（inputFeatures 中的不同功能）
    {
        if (feature.type == typeof(bool))
        {
            bool featureValue;
            if (device.TryGetFeatureValue(feature.As<bool>(), out featureValue))
            {
                Debug.Log(string.Format("Bool feature {0}'s value is {1}", feature.name, featureValue.ToString()));
            }
        }
    }
}
```

### primaryButton 示例##example-for-primarybutton

不同的控制器配置提供对不同 Features 的访问。例如，一个系统上可能有多个控制器，不同系统上可能有不同的控制器，或者具有不同 SDK 的相同控制器上可能有不同的按钮。这种多样性使得Support来自一范围 XR 系统的输入变得更加复杂。Unity `InputFeatureUsage` API 可帮助您获取不依赖于平台的输入。

以下示例将访问 `InputFeatureUsage` 调用的 `primaryButton`，无论哪个控制器或输入设备提供该 。该示例包含一类，可在连接时扫描可用 Devices 以查找`primaryButton`。该类监控任何连接设备上的功能 ON 的值，如果该值发生更改，该类将分发 [UnityEvent](/engine/6000.0/script-reference/unityengine/events/unityevent.md)。

要使用类，请将其作为组件添加到Scene中的Any游戏对象对象。例如：

```lang-cs
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Events;
using UnityEngine.XR;

[Serializable
public class PrimaryButtonEvent :UnityEvent<bool> { }

public class PrimaryButtonWatcher :MonoBehaviour
{
    public PrimaryButtonEvent primaryButtonPress;

    private bool lastButtonState = false;
    private list<InputDevice> devicesWithPrimaryButton;

    private void 唤醒()
    {
        if (primaryButtonPress == null)
        {
            primaryButtonPress = new PrimaryButtonEvent();
        }

        devicesWithPrimaryButton = new List<InputDevice>();
    }

    void OnEnable()
    {
        列表<InputDevice> allDevices = 新建列表<InputDevice>();
        InputDevices.GetDevices(allDevices);
        Foreach（所有Device 中的 InputDevice 设备）
            InputDevices_deviceConnected(device);

        InputDevices.deviceConnected += InputDevices_deviceConnected;
        InputDevices.deviceDisconnected += InputDevices_deviceDisconnected;
    }

    private void OnDisable()
    {
        InputDevices.deviceConnected -= InputDevices_deviceConnected;
        InputDevices.deviceDisconnected -= InputDevices_deviceDisconnected;
        devicesWithPrimaryButton.Clear();
    }

    private void InputDevices_deviceConnected(InputDevice 设备)
    {
        bool discardedValue;
        if (device.TryGetFeatureValue(CommonUsages.primaryButton, out discardedValue))
        {
            devicesWithPrimaryButton.添加(设备); // 添加具有主按钮的任何 Devices。
        }
    }

    private void InputDevices_deviceDisconnected(InputDevice 设备)
    {
        if (devicesWithPrimaryButton.Contains(device))
            devicesWithPrimaryButton.Remove(device);
    }

    void Update()
    {
        bool tempState = false;
        Foreach（设备中的各种设备WithPrimaryButton）
        {
            bool primaryButtonState = false;
            tempState = 设备。TryGetFeatureValue(CommonUsages.primaryButton, out primaryButtonState) // 确实获得了值
                        && primaryButtonState // 我们获取的值
                        || tempState; // Other控制器的累积result
        }

        if (tempState != lastButtonState) // Button state changed since last frame
        {
            primaryButtonPress.Invoke(tempState);
            lastButtonState = tempState;
        }
    }
}
```

以下 `PrimaryReactor` 类使用该`PrimaryButtonWatcher`来检测 When you press a primary button and in response of a press, rotate its父游戏对象。要使用这类，请将其添加到可见游戏对象（例如 Cube），然后将`PrimaryButtonWatcher`引用拖动到 **Watcher** 属性。

```lang-cs
using System.Collections;
using UnityEngine;

public class PrimaryReactor :MonoBehaviour
{
    public PrimaryButtonWatcher watcher;
    public bool IsPressed = false; // used to display button state in the Unity Inspector window
    public Vector3 rotationAngle = new Vector3(45, 45, 45);
    public float rotationDuration = 0.25f; // seconds
    private 四元数 offRotation;
    private 四元数 onRotation;
    private Coroutine rotator;

    void Start()
    {
        watcher.primaryButtonPress.AddListener(onPrimaryButtonEvent);
        offRotation = this.transform.rotation;
        onRotation = Quaternion.Euler(rotationAngle) * offRotation;
    }

    public void onPrimaryButtonEvent(bool pressed)
    {
        IsPressed = pressed;
        if (rotator != null)
            StopCoroutine(rotator);
        if (pressed)
            rotator = StartCoroutine(AnimateRotation(this.transform.rotation, onRotation));
        else
            rotator = StartCoroutine(AnimateRotation(this.transform.rotation, offRotation));
    }

    private IEnumerator AnimateRotation（四元数 fromRotation、四元数 toRotation）
    {
        浮点 t = 0;float
        while (t < rotationDuration)
        {
            transform.rotation = Quaternion.Lerp(fromRotation, toRotation, t / rotationDuration);
            t += Time.deltaTime;
            返回 null
        }
    }
}
```

### 访问手跟踪数数据##accessing-hand-tracking-data

InputDevices Support手跟踪Devices。手动跟踪设备始终：

* 具有 [HandTracking](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/handtracking.md) 特性
* 包含 [Hand](/engine/6000.0/script-reference/unityengine/xr/hand.md) 类型的 [CommonUsages.HandData](/engine/6000.0/script-reference/unityengine/xr/commonusages/handdata.md) 用法

手部跟踪数据由一个 Hand Object和一系列最多 21 个骨骨骼输入Features组成。每个[骨骼](/engine/6000.0/script-reference/unityengine/xr/bone.md)都有位置和方向，以及对层级视图中的父和 Any 子骨骼的引用。Hand Object 可以获取 Root Bone 或每个手指的骨骼列表。

当 [Hand.TryGetRootBone](/engine/6000.0/script-reference/unityengine/xr/hand/trygetrootbone.md) 获取 Root Bone 时，它会检索表示位于手腕正上方的骨骼的对象。您还可以获取代表每个手指的骨骼列表。调用 [Hand.TryGetFingerBones](/engine/6000.0/script-reference/unityengine/xr/hand/trygetfingerbones.md) 会返回代表该手指的骨骼的列表（从关节到尖端）。

### 访问眼睛跟踪数据##accessing-eye-tracking-data

输入DevicesSupport眼睛跟踪Devices以及手部跟踪Devices。眼睛跟踪包括左和右眼位置、用户正在观察的 3D Space间中的位置以及每只眼睛的眨眼amount。其数据类型为 [Eyes](/engine/6000.0/script-reference/unityengine/xr/eyes.md)。要从设备检索，请使用 [CommonUsages.eyesData](/engine/6000.0/script-reference/unityengine/xr/commonusages/eyesdata.md)。

### XRInputSubsystem 和 InputDevice 关联##xrinputsubsystem-and-inputdevice-association

Unity 提供了两个输入系统：Legacy Input System 和 2019.2 中引入的 [XR 插件架构](https://discussions.unity.com/t/xr-plugins-and-subsystems/746800)。在新建设置中，每个 InputDevice 都与 [XRInputSubsystem](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem.md) 关联。这些子系统对象Control与Any指定的输入设备无关的全局输入行为（例如，管理跟踪Origin或重新显示跟踪Devices）。

每个 InputDevice 都包含对其关联子系统的引用。如果设备来自集成平台，则此引用为 null。您还可以使用 [SubsystemManager.GetInstances\<XRInputSubsystem>](/engine/6000.0/script-reference/unityengine/subsystemmanager/getinstances.md) 获取所有激活的 XRInputSubsystem 对象，每个 XRInputSubsystem 都可以使用 [XRInputSubsystem.TryGetInputDevices](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/trygetinputdevices.md) 获取其 Devices。

您可以使用输入子系统来更新具有 [UnityEngine.XR.XRInputSubsystem](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem.md) 的 Devices。Recenter 将 HMD 的当前位置设置为AllDevices的新建Origin。对于无法重新居中或平台不Support重新居中的Devices，它将返回 false。

要检索跟踪边界，请使用 [TryGetBoundaryPoints](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/trygetboundarypoints.md)。它由一系列顺时针排序的 3D 点组成，其中 y 值位于 Floor 关卡，它们标记出用户指定的“Safe Safe 区域”来放置内容和交互。您可以使用 [XRInputSubsystem.boundaryChanged](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/boundarychanged.md) 监听此边界的更改。

XRInputSubsystem 还负责跟踪 Origin 模式，该模式为跟踪世界的 Origin 位置提供上下文。Unity 支持以下跟踪 Origin 模式：

* [设备](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/device.md)Origin 的位置位于主显示设备的第一个已知位置；通常是 HMD 或 Phone。
* [Floor](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/floor.md)：原点的位置位于地板上的已知位置。
* [跟踪参考](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/trackingreference.md)：Origin的位置位ON设置了 TrackingReference 特性的 InputDevice 上。
* [UNKNOWN](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/unknown.md)跟踪 Origin 的类型未知。这可能是由于系统故障或缺少跟踪原点模式支持。

可以使用三个 API 来管理跟踪 Origin 模式：

* [XRInputSubsystem.TrySetTrackingOriginMode](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/trysettrackingoriginmode.md) 设置跟踪 Origin 模式
* [XRInputSubystem.GetTrackingOriginMode](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/gettrackingoriginmode.md) 检索跟踪 Origin 模式
* [XRInputSubsystem.GetSupportedTrackingOriginModes](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/getsupportedtrackingoriginmodes.md) 检索 SDK 支持的所有跟踪 Origin 模式

## 通过LegacyInput System的 XR 输入##xr-input-through-the-legacy-input-system

您仍然可以使用由[输入](/engine/6000.0/script-reference/unityengine/input.md)和 [XR.InputTracking](/engine/6000.0/script-reference/unityengine/xr/inputtracking.md) 组成的 Legacy Input System 来检索 XR 输入功能。为此，请使用本页面上的 [XR 输入映射表](#XRInputMappings)中的相应 Legacy 输入索引。在Editor的**输入**部分（菜单：**编辑** > Editor > **输入**），创建轴映射，为平台设备的功能添加从输入 Name 到轴索引的适当 Mapping。要检索按钮或轴值，请使用 [input.GetAxis](/engine/6000.0/script-reference/unityengine/input/getaxis.md) 或 [input.GetButton](/engine/6000.0/script-reference/unityengine/input/getbutton.md)，然后输入现在映射的轴或按钮 Name 中的通道。

有关如何使用按钮和操作杆轴的更多信息，请参阅 ON [InputManager](/engine/6000.0/manual/input/legacy/class-input-manager.md) 文档。

## 触觉##haptics

您可以将触觉事件发送到 [InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md)。触觉采用 ON 脉冲形式，具有幅度和 Duration。

并非All平台都SupportAll类型的触觉，但您可以查询设备的触觉功能。以下示例获取右手的输入设备，检查设备是否具有触觉功能，然后播放脉冲（如果能够）：

```lang-cs
列表<UnityEngine.XR.InputDevice> Devices = 新建列表<UnityEngine.XR.InputDevice>(); 

UnityEngine.XR.InputDevices.GetDevicesWithRole(UnityEngine.XR.InputDeviceRole.RightHanded, devices);

Foreach（Devices中的设备不同）
{
    UnityEngine.XR.HapticCapabilities capabilities;
    if (device.TryGetHapticCapabilities(out capabilities))
    {
            if (capabilities.supportsImpulse)
            {
                uint 通道 = 0;
                float amplitude = 0.5f;
                浮点 Duration = 1.0f;
                device.SendHapticImpulse(channel, amplitude, duration);
            }
    }
}
```
