---
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/ko-kr/engine/6000.0/manual/input/xr_input
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/input/xr_input.md
last_updated: 2026-10-30
generated_at: 2026-11-19T16:43:42.753Z
locale: ko-kr
---

# Unity XR 입력

> VR 및 AR용 장치 제어 및 기능에 액세스합니다.

Unity 사용자 매뉴얼 섹션에서는 가상 현실, 증강 현실 및 Windows 혼합 현실 애플리케이션용 Unity 지원 입력 디바이스에 대한 정보를 제공합니다. 이 페이지에서는 다음 항목을 다룹니다.

* [XR 입력 매핑](#XRInputMappings)
* [입력 장치 액세스](#AccessingInputDevices)
* [입력 장치에서 입력 기능 액세스](#AccessingInputFeatures)
* [레거시 Input System을 통해 XR 입력 액세스](#XRInputLegacySystem)
* [맵틱](#Haptics)

XR 플랫폼에는 사용자 상호 작용을 디자인할 때 활용할 수 있는 다양한 입력 기능이 있습니다. 애플리케이션은 포지션, 회전, 터치, 버튼, 조이스틱, 손가락 센서를 참조하는 특정 데이터를 사용할 수 있습니다. 하지만 이러한 입력 기능에 대한 액세스는 플랫폼마다 매우 다를 수 있습니다. 예를 들어 데스크톱 VR 헤드셋 간에 작은 차이점이 있을 수 있지만, VR 지원 데스크톱 플랫폼과 독립형 모바일 헤드셋은 훨씬 더 다를 수 있습니다.

Unity는 [InputFeatureUsage](/engine/6000.0/script-reference/unityengine/xr/inputfeatureusage.md)라는 C# 구조체를 제공합니다. 이 구조체는 모든 플랫폼에서 사용자 입력에 액세스하기 위한 표준 물리적 디바이스 컨트롤 세트(버튼 및 트리거 등)를 정의합니다. 이를 통해 이름을 기준으로 입력 유형을 식별할 수 있습니다. 각 `InputFeatureUsage`의 정의는 [XR.Input.CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md)를 참조하십시오.

각 `InputFeatureUsage`는 공통 입력 액션 또는 유형에 해당합니다. 예를 들어, Unity는 `trigger`라는 `InputFeatureUsage`을 사용하는 XR 플랫폼에 관계없이 인덱스 손가락이 제어하는 단일 축 입력으로 정의합니다. `InputFeatureUsage`를 사용하여 이름을 사용하여 `trigger` 상태를 가져올 수 있으므로 기존 Unity Input System에 대해 축(또는 일부 XR 플랫폼의 버튼)을 설정할 필요가 없습니다.

## XR 입력 매핑##xr-input-mappings

다음 표에는 표준 컨트롤러 `InputFeatureUsage` 이름과 그들이 인기 XR 시스템의 컨트롤러에 매핑되는 방법이 나와 있습니다.

| **InputFeatureUsage**                                                                                   | **기능 유형** | **레거시 입력 인덱스**(왼쪽 컨트롤러/오른쪽 컨트롤러) | **WMR**       | **Oculus**      | **GearVR** | **Daydream** | **OpenVR(전체)**    | **Vive**       | **Oculus via OpenVR** | **WMR via OpenVR** |
| ------------------------------------------------------------------------------------------------------- | --------- | -------------------------------- | ------------- | --------------- | ---------- | ------------ | ----------------- | -------------- | --------------------- | ------------------ |
| [primary2DAxis](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxis.md)           | 2D 축      | \[(1,2)/(4,5)]                   | 터치패드          | 조이스틱            | 터치패드       | 터치패드         | Trackpad/Joystick | 트랙패드           | 조이스틱                  | 조이스틱               |
| [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]                         | 그립(Grip)      | 그립(Grip)        |            | 범퍼           | 그립(Grip)          | 그립(Grip)       | 그립(Grip)              | 그립(Grip)           |
| [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] - Touch  |            |              |                   |                |                       |                    |
| [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]                           | 그립 - 누르기      | 그립 - 누르기        |            |              | 그립 - 누르기          | 그립 - 누르기       | 그립 - 누르기              | 그립 - 누르기           |
| [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]                           | 메뉴            | 시작(왼쪽 컨트롤러만 해당) |            |              |                   |                |                       |                    |
| [primary2DAxisClick](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxisclick.md) | 버튼        | \[8/9]                           | 터치패드 - 클릭 수   | 썸스틱 - 누르기       | 터치패드 - 누르기 | 터치패드 - 누르기   | 트랙패드/조이스틱 - 누르기   | 트랙패드 - 누르기     | 조이스틱 - 누르기            | 터치패드 - 누르기         |
| [primary2DAxisTouch](/engine/6000.0/script-reference/unityengine/xr/commonusages/primary2daxistouch.md) | 버튼        | \[16/17]                         | 터치패드 - 터치     | 썸스틱 - 터치        | 터치패드 - 터치  | 터치패드 - 터치    | 트랙패드/조이스틱 - 터치    | 트랙패드 - 터치      | 조이스틱 - 터치             | 터치패드 - 터치          |
| [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) 샌드위치 버튼은 Vive 메뉴 버튼을 나타냅니다. 이 버튼은 크로스 플랫폼 애플리케이션을 더 잘 처리하기 위해 menuButton이 아닌 primaryButton에 매핑됩니다.

각 `InputFeatureUsage`의 정의는 [XR.Input.CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md)를 참조하십시오.

## 입력 기기 액세스##accessing-input-devices

[InputDevice는](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md) 컨트롤러, 휴대폰 또는 헤드셋과 같은 모든 물리적 장치를 나타냅니다. 기기 추적, 버튼, 조이스틱, 기타 입력 컨트롤에 대한 정보가 포함될 수 있습니다. `InputDevice` API에 대한 자세한 내용은 [InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md) 기술 자료를 참조하십시오.

현재 XR 시스템에 연결된 입력 디바이스에 액세스하려면 [XR.InputDevices](/engine/6000.0/script-reference/unityengine/xr/inputdevices.md) 클래스를 사용합니다. 연결된 모든 디바이스 목록을 가져오려면 다음과 같이 [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의 var 디바이스)
{
    Debug.Log(string.Format("Device found with name '{0}' and role '{1}'", device.name, device.role.ToString()));
}
```

입력 장치는 XR 시스템이 장치를 분리할 때까지 프레임 간에 유효합니다. [InputDevice.IsValid](/engine/6000.0/script-reference/unityengine/xr/inputdevice/isvalid.md) 프로퍼티를 사용하여 `InputDevice`가 여전히 활성 컨트롤러를 나타내는지 확인합니다.

다음을 통해 입력 기기에 액세스할 수 있습니다.

* 특성:
* 역할
* XR 노드

### 특성별로 입력 디바이스 액세스##accessing-input-devices-by-characteristics

기기 특성은 기기가 무엇을 할 수 있는지, 또는 기기가 무엇에 사용되는지(예: 헤드 마운트 여부)를 설명합니다. [InputDeviceCharacteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics.md)는 특정 사양에 맞는 디바이스를 검색하기 위해 코드에 추가할 수 있는 일련의 플래그입니다. 다음 특성에 따라 기기를 필터링할 수 있습니다.

| **Device**                                                                                                          | **특성**                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| [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 공간에서 추적할 수 있습니다. 디바이스 트래킹이 있습니다                                                                              |
| [관리자](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/controller.md)                      | 기기에는 버튼 및 축에 대한 입력 데이터가 있으며 컨트롤러로 사용할 수 있습니다.                                                                       |
| [TrackingReference](/engine/6000.0/script-reference/unityengine/xr/inputdevicecharacteristics/trackingreference.md) | 기기는 정적 추적 레퍼런스 오브젝트를 나타냅니다. 디바이스 트래킹이 있지만 트래킹 데이터는 변경되어선 안 됩니다.                                                     |
| [왼쪽](/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)         | 기기는 6DOF 데이터를 보고하지만 3DOF 센서만 있습니다. Unity 포지션 데이터를 시뮬레이션합니다.                                                         |

XR 공급자 플러그인은 이러한 특성을 보고합니다. [InputDevice.Characteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevice/characteristics.md)로 검색할 수 있습니다. 기기는 비트 플래그를 사용하여 필터링하고 액세스할 수 있는 여러 특성을 가질 수 있으며, 종종 있어야 합니다.

[InputDevices.GetDevicesWithCharacteristics](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdeviceswithcharacteristics.md)는 특정 특성을 가진 모든 기기를 검색하는 방법을 제공합니다. 예를 들어 다음 코드를 사용하여 시스템에서 사용 가능한 Left, HeldInHand, Controller InputDevices를 검색할 수 있습니다.

```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(leftHandedController의 var 장치)
{
    Debug.Log(string.Format("Device name '{0}' has characteristics '{1}'", device.name, device.characteristics.ToString()));
}
```

이 함수가 찾는 기기에는 지정된 특성이 포함되지만 추가 특성이 포함될 수 있습니다. 예를 들어 왼쪽 컨트롤러를 찾으려면 InputDeviceCharacteristic.Left만 찾고 InputDeviceCharacteristic.Controller만 찾을 수 있습니다.

### 역할별로 입력 디바이스 액세스##accessing-input-devices-by-role

기기 역할은 입력 기기의 일반적인 기능을 설명합니다. 디바이스 역할을 지정하려면 [InputDeviceRole](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole.md) 열거형을 사용합니다. 정의된 역할은 다음과 같습니다.

| **역할**                                                                                                   | **설명**                                       |
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [GameController](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/gamecontroller.md)       | 콘솔 스타일 게임 컨트롤러입니다.                           |
| [Generic](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/generic.md)                     | 코어 XR 장치를 나타내는 장치(예: 헤드 마운트 디스플레이 또는 모바일 장치) |
| [HardwareTracker](/engine/6000.0/script-reference/unityengine/xr/inputdevicerole/hardwaretracker.md)     | 트래킹 기기입니다.                                   |
| [왼손잡이](/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) | Oculus 추적 카메라와 같이 다른 장치를 추적하는 장치입니다.         |

XR 공급자 플러그인은 이러한 역할을 보고하지만, 다른 공급자는 기기 역할을 다르게 구성할 수 있습니다. 또한 사용자가 손을 전환할 수 있으므로 역할 할당이 사용자가 입력 기기를 잡는 손과 일치하지 않을 수 있습니다. 예를 들어 사용자는 컨트롤러를 오른손이나 왼손으로 설정할 수 있지만, 컨트롤러를 다른 손으로 잡습니다.

[GetDevicesWithRole](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdeviceswithrole.md)은 특정 `InputDeviceRole`가 있는 모든 장치 목록을 제공합니다. 예를 들어, `InputDeviceRole.GameController`를 사용하여 연결된 모든 `GameController` 장치를 가져올 수 있습니다.

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

Foreach(gameController의 var 장치)
{
    Debug.Log(string.Format("Device name '{0}' has role '{1}'", device.name, device.role.ToString()));
}
```

### XR 노드로 입력 장치 액세스##accessing-input-devices-by-xr-node

XR 노드는 XR 시스템의 물리적 레퍼런스 포인트(예: 사용자의 머리 포지션, 오른손과 왼손, Oculus 카메라와 같은 추적 레퍼런스)를 나타냅니다.

[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)       | 콘솔 스타일 게임 컨트롤러입니다. 앱에 여러 게임 컨트롤러 기기가 있을 수 있습니다.                         |
| [HardwareTracker](/engine/6000.0/script-reference/unityengine/xr/xrnode/hardwaretracker.md)     | 일반적으로 사용자 또는 물리적 아이템에 연결된 하드웨어 트래킹 디바이스입니다. 여러 하드웨어 트래커 노드가 존재할 수 있습니다. |
| --[head](/engine/6000.0/script-reference/unityengine/xr/xrnode/head.md)                         | XR 시스템으로 계산된 사용자의 머리의 중심 지점입니다.                                         |
| [왼쪽 눈](/engine/6000.0/script-reference/unityengine/xr/xrnode/lefteye.md)                        | 사용자의 왼쪽 눈                                                               |
| [LeftHand](/engine/6000.0/script-reference/unityengine/xr/xrnode/lefthand.md)                   | 사용자의 왼손                                                                 |
| [오른쪽 눈](/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 카메라) 여러 트래킹 레퍼런스 노드가 존재할 수 있습니다.                       |

특정 `XRNode`와 연결된 디바이스 목록을 가져오려면 [InputDevices.GetDevicesAtXRNode](/engine/6000.0/script-reference/unityengine/xr/inputdevices/getdevicesatxrnode.md)를 사용합니다. 다음 예시는 왼손잡이 컨트롤러를 가져오는 방법을 보여 줍니다.

```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

입력 디바이스는 프레임에서 프레임까지 일관되지만 언제든지 연결하거나 연결 해제할 수 있습니다. 기기가 플랫폼에 연결되었는지 반복적으로 확인하지 않으려면 [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)하십시오. 입력 디바이스에 액세스하는 스크립트는 해당 디바이스를 사용하기 전에 각 프레임의 시작 부분에서 이를 확인해야 합니다.

## 입력 기기의 입력 기능 액세스##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입니다.
* 현재 기기가 지정된 기능을 지원하지 않거나 기기가 유효하지 않거나(즉, 컨트롤러가 더 이상 활성화되지 않음) false입니다.

특정 버튼, 터치 입력 또는 조이스틱 축 값을 가져오려면 [CommonUsages](/engine/6000.0/script-reference/unityengine/xr/commonusages.md) 클래스를 사용합니다. `CommonUsages`에는 [XR 입력 매핑 표](#XRInputMappings)의 각 `InputFeatureUsage`와 포지션 및 회전과 같은 추적 기능이 포함됩니다. 다음 코드 예제는 [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) 항목 리스트를 반환합니다. 다음 예시는 특정 입력 기기가 제공하는 모든 부울 기능을 열거합니다.

```lang-cs
var inputFeatures = new List<UnityEngine.XR.InputFeatureUsage>();
if (device.TryGetFeatureUsages(inputFeatures))
{
    Foreach (inputFeatures의 var 기능)
    {
        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

컨트롤러 구성에 따라 다양한 기능에 액세스할 수 있습니다. 예를 들어 하나의 시스템에는 여러 개의 컨트롤러가 있고, 다른 시스템에는 여러 개의 컨트롤러가 있고, 다른 SDK를 사용하는 동일한 컨트롤러에는 여러 개의 버튼이 있을 수 있습니다. 이러한 다양성은 다양한 XR 시스템의 입력을 지원하기가 더 복잡해집니다. Unity `InputFeatureUsage` API를 사용하면 플랫폼에 의존하지 않는 입력을 얻을 수 있습니다.

다음 예제에서는 컨트롤러나 입력 장치에 관계없이 `primaryButton`라는 `InputFeatureUsage`에 액세스합니다. 예제에는 연결되는 `primaryButton`의 사용 가능한 디바이스를 검색하는 클래스가 포함되어 있습니다. 클래스는 연결된 기기에서 기능의 값을 모니터링하고 값이 변경되면 클래스가 [UnityEvent](/engine/6000.0/script-reference/unityengine/events/unityevent.md)를 디스패치합니다.

이 클래스를 사용하려면 씬의 모든 게임 오브젝트에 컴포넌트로 추가합니다. 예제는 아래와 같습니다.

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

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

public class PrimaryButtonWatcher : MonoBehaviour
{
    public PrimaryButtonEvent primaryButtonPress;

    private bool lastButtonState = false;
    private List 디바이스<InputDevice>withPrimaryButton;

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

        devicesWithPrimaryButton = new List<InputDevice>();
    }

    void OnEnable()
    {
        list<InputDevice> allDevices = new List<InputDevice>();
        InputDevices.GetDevices(allDevices);
        Foreach(allDevices의 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 device)
    {
        bool discardedValue;
        if (device.TryGetFeatureValue(CommonUsages.primaryButton, out discardedValue))
        {
            devicesWithPrimaryButton.Add(device); // 기본 버튼이 있는 모든 기기를 추가합니다.
        }
    }

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

    void Update()
    {
        bool tempState = false;
        Foreach(기기 장치의 var 장치WithPrimaryButton)
        {
            bool primaryButtonState = false;
            tempState = device.TryGetFeatureValue(CommonUsages.primaryButton, out primaryButtonState) // 값을 가져왔습니다.
                        && primaryButtonState // 얻은 값
                        || tempState; // 다른 컨트롤러의 누적 결과
        }

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

다음의 `PrimaryReactor` 클래스는 `PrimaryButtonWatcher`를 사용하여 기본 버튼을 누르고 누름에 대한 응답으로 해당 부모 게임 오브젝트를 회전할 때를 감지합니다. 이 클래스를 사용하려면 큐브와 같은 가시 게임 오브젝트에 추가하고 `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 Quaternion offRotation;
    private Quaternion onRotation;
    private 코루틴 로테이터;

    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(쿼터니언에서 회전, 쿼터니언에서 회전)
    {
        float t = 0;
        while (t < rotationDuration)
        {
            transform.rotation = Quaternion.Lerp(fromRotation, toRotation, t / rotationDuration);
            t += Time.deltaTime;
            출력 반환 null;
        }
    }
}
```

### 손 추적 데이터 액세스##accessing-hand-tracking-data

InputDevices는 손 추적 기기를 지원합니다. 핸드 트래킹 디바이스는 항상 다음을 수행합니다.

* [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) 사용을 포함합니다.

핸드 트래킹 데이터는 핸드 오브젝트와 최대 21개의 뼈대 입력 기능으로 구성됩니다. 각 [뼈대](/engine/6000.0/script-reference/unityengine/xr/bone.md)에는 위치와 방향이 있으며 계층 구조에서 부모 뼈대와 자식 뼈대에 대한 레퍼런스도 있습니다. 핸드 오브젝트는 루트 뼈대나 각 손가락의 뼈대 목록을 가져올 수 있습니다.

[Hand.TryGetRootBone이](/engine/6000.0/script-reference/unityengine/xr/hand/trygetrootbone.md) 루트 뼈대를 얻으면 손목 바로 위에 있는 뼈대를 나타내는 객체를 검색합니다. 각 손가락을 나타내는 뼈대 목록도 가져올 수 있습니다. 호출 [Hand.TryGetFingerBones](/engine/6000.0/script-reference/unityengine/xr/hand/trygetfingerbones.md)는 손가락에서 끝까지 해당 손가락을 나타내는 뼈대의 목록을 반환합니다.

### 눈 추적 데이터 액세스##accessing-eye-tracking-data

입력 기기는 눈 추적 기기와 손 추적 기기를 지원합니다. 눈 추적은 왼쪽 및 오른쪽 눈 포지션, 사용자가 바라보는 3D 공간의 위치, 각각의 눈이 깜박이는 정도로 구성됩니다. 데이터 유형은 [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는 두 가지 입력 시스템, 즉 레거시 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)과 연결됩니다. 이러한 보조 시스템 오브젝트는 특정 입력 디바이스와 관련이 없는 전역 입력 동작을 제어합니다(예: 트래킹 원점 관리, 트래킹된 디바이스 재중심).

각 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) 해당 기기를 가져올 수도 있습니다.

입력 하위 시스템을 사용하여 [UnityEngine.XR.XRInputSubsystem](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem.md)을 사용하여 기기를 다시 등록할 수 있습니다. Recenter는 HMD의 현재 포지션을 모든 기기의 새로운 원점으로 설정합니다. 재중심할 수 없는 기기나 플랫폼이 재중심을 지원하지 않는 경우에는 false를 반환합니다.

추적 경계를 검색하려면 [TryGetBoundaryPoints를 사용](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/trygetboundarypoints.md)합니다. 이것은 일련의 시계 방향으로 정렬된 3D 점으로 구성되며, y 값은 바닥 수준에 있으며, 사용자가 지정한 '안전한 영역'을 표시하여 콘텐츠와 상호 작용을 배치합니다. [XRInputSubsystem.boundaryChanged](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/boundarychanged.md)를 사용하여 이 경계의 변경 사항을 수신할 수 있습니다.

XRInputSubsystem은 트래킹 월드의 원점에 대한 컨텍스트를 제공하는 트래킹 원점 모드도 담당합니다. Unity 다음의 추적 원점 모드를 지원합니다.

* [Device](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/device.md) 원점 위치는 기본 디스플레이 디바이스의 첫 번째 알려진 위치에 있으며, 이는 HMD 또는 휴대폰의 경우가 많습니다.
* [층](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/floor.md): 원점 위치는 바닥에 있는 알려진 위치에 있습니다.
* [추적 참조](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/trackingreference.md): 원점 위치는 TrackingReference 특성이 설정된 InputDevice에 있습니다.
* [UNKNOWN](/engine/6000.0/script-reference/unityengine/xr/trackingoriginmodeflags/unknown.md) 트래킹 원점의 유형은 알 수 없습니다. 이는 시스템 오류 또는 추적 원점 모드 지원 부족으로 인해 발생할 수 있습니다.

다음 세 가지 API를 사용하여 추적 원점 모드를 관리할 수 있습니다.

* 추적 원점 모드를 설정하는 [XRInputSubsystem.TrySetTrackingOriginMode](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/trysettrackingoriginmode.md)
* 추적 원점 모드를 가져오는 [XRInputSubystem.GetTrackingOriginMode](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/gettrackingoriginmode.md)
* [XRInputSubsystem.GetSupportedTrackingOriginModes는](/engine/6000.0/script-reference/unityengine/xr/xrinputsubsystem/getsupportedtrackingoriginmodes.md) SDK가 지원하는 모든 추적 원점 모드를 가져옵니다.

## 레거시 Input System 통한 XR 입력##xr-input-through-the-legacy-input-system

[Input](/engine/6000.0/script-reference/unityengine/input.md) 및 [XR.InputTracking](/engine/6000.0/script-reference/unityengine/xr/inputtracking.md)으로 구성된 레거시 Input System을 사용하여 XR 입력 기능을 검색할 수 있습니다. 이렇게 하려면 이 페이지의 [XR 입력 매핑 표](#XRInputMappings)에서 적절한 레거시 입력 인덱스를 사용하십시오. Editor의 **입력** 섹션(메뉴: **편집** > Editor > **입력**), 플랫폼 장치의 기능에 대한 입력 이름에서 축 인덱스에 대한 적절한 매핑을 추가하는 축 매핑을 생성합니다. 버튼 또는 축 값을 가져오려면 [Input.GetAxis](/engine/6000.0/script-reference/unityengine/input/getaxis.md) 또는 [Input.GetButton](/engine/6000.0/script-reference/unityengine/input/getbutton.md)을 사용하고 현재 매핑된 축 또는 버튼 이름을 전달합니다.

버튼 및 조이스틱 축을 사용하는 방법에 대한 자세한 내용은 [InputManager](/engine/6000.0/manual/input/legacy/class-input-manager.md) 문서를 참조하십시오.

## 맵틱##haptics

입체 이벤트를 [InputDevice](/engine/6000.0/script-reference/unityengine/xr/inputdevice.md)로 전송할 수 있습니다. 감쇠는 진폭과 지속 시간을 가지는 임펄스 형태를 가집니다.

모든 플랫폼이 모든 유형을 지원하는 것은 아닙니다. 하지만 힙틱 성능을 기기에서 쿼리할 수 있습니다. 다음 예시에서는 오른손에 대한 입력 디바이스를 가져오고, 디바이스가 감마를 할 수 있는지 확인한 다음, 가능한 경우 임펄스를 재생합니다.

```lang-cs
목록<UnityEngine.XR.InputDevice> 장치 = 새 목록<UnityEngine.XR.InputDevice>(); 

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

Foreach(기기에서 var 장치)
{
    UnityEngine.XR.HapticCapabilities capabilities;
    if (device.TryGetHapticCapabilities(out capabilities))
    {
            if (capabilities.supportsImpulse)
            {
                uint channel = 0;
                float amplitude = 0.5f;
                float duration = 1.0f;
                device.SendHapticImpulse(channel, amplitude, duration);
            }
    }
}
```
