OpenVR 컨트롤러 입력(Input for OpenVR controllers)
OpenVR에 의해 지원되는 추적 컨트롤러에 대한 Unity 에디터의 네이티브 지원을 돕기 위해, Unity VR 서브시스템은 VR 컨트롤러 입력을 별도의 조이스틱으로 제공합니다. 해당 축 및 버튼 값에는 UnityEngine.Input 클래스를 통해 액세스할 수 있습니다.
Unity 에디터는 OpenVR의 컨트롤러 추상화를 사용하여 하드웨어에 관계없는 방식으로(즉, 특정 하드웨어를 지칭하지는 않지만 일반적인 용어를 사용하여) 축 및 버튼 상태를 제공합니다. 하지만 분명한 것은 아래 제시된 축 및 버튼 매핑은 지원되는 두 가지 컨트롤러 타입은 HTC Vive 컨트롤러와 오큘러스 터치 컨트롤러를 가르킵니다.
명명 규칙 및 감지
올바르게 설정되고 연결된 경우, 오큘러스 터치 컨트롤러 한 페어와 HTC Vive 컨트롤러 한 페어는 UnityEngine.Input.GetJoystickNames()에 의해 반환되는 리스트에 OpenVR Controller - Left 및 OpenVR Controller - Right 로 표시됩니다. 사용 가능한 컨트롤러는 SteamVR 상태 창에 초록색으로 강조 표시됩니다.
Unity 스크립트 코드를 사용하여 조이스틱 이름 리스트에 컨트롤러의 이름이 있는지 주기적으로 확인하여 해당 컨트롤러의 유효성을 테스트할 수 있습니다. 컨트롤러가 꺼져 있거나 배터리가 분리된 경우 UnityEngine.Input.GetJoystickNames()에 의해 반환되는 리스트에서 컨트롤러 이름이 빈 문자열로 대체됩니다. 컨트롤러를 다시 켜면 해당 컨트롤러의 이름이 반환된 조이스틱 리스트에 표시됩니다.
Unity 입력 시스템 매핑
Vive 컨트롤러 다이어그램
오큘러스(Oculus) 터치 컨트롤러 다이어그램
| Vive Controller Hardware Feature | Touch Controller Hardware Feature | 인터랙션 타입 | Unity 버튼 ID | Unity 축 ID | Unity 축 값 범위 |
|---|---|---|---|---|---|
| 왼쪽 컨트롤러 메뉴 버튼(1) | Button.Three | 누름 | 2 | ||
| 오른쪽 컨트롤러 메뉴 버튼(1) | Button.One | 누름 | 0 | ||
| 왼쪽 컨트롤러 트랙패드(2) | Button.PrimaryThumbstick | 누름 | 8 | ||
| 오른쪽 컨트롤러 트랙패드(2) | Button.SecondaryThumbstick | 누름 | 9 | ||
| 왼쪽 컨트롤러 트랙패드(2) | Button.PrimaryThumbstick | 터치 | 16 | ||
| 오른쪽 컨트롤러 트랙패드(2) | Button.SecondaryThumbstick | 터치 | 17 | ||
| 왼쪽 컨트롤러 트랙패드(2) | Axis2D.PrimaryThumbstick | 가로 이동 | 1 | –1.0–1.0 | |
| 왼쪽 컨트롤러 트랙패드(2) | Axis2D.PrimaryThumbstick | 세로 이동 | 2 | –1.0–1.0 | |
| 오른쪽 컨트롤러 트랙패드(2) | Axis2D.SecondaryThumbstick | 가로 이동 | 4 | –1.0–1.0 | |
| 오른쪽 컨트롤러 트랙패드(2) | Axis2D.SecondaryThumbstick | 세로 이동 | 5 | –1.0–1.0 | |
| 왼쪽 컨트롤러 트리거(7) | Axis1D.PrimaryIndexTrigger | 터치 | 14 | ||
| 오른쪽 컨트롤러 트리거(7) | Axis1D.SecondaryIndexTrigger | 터치 | 15 | ||
| 왼쪽 컨트롤러 트리거(7) | Axis1D.PrimaryIndexTrigger | 압착 | 9 | 0.01.0 | |
| 오른쪽 컨트롤러 트리거(7) | Axis1D.SecondaryIndexTrigger | 압착 | 10 | 0.01.0 | |
| 왼쪽 컨트롤러 그립 버튼(8) | Axis1D.PrimaryHandTrigger | 압착 | 11 | 0.01.0 | |
| 오른쪽 컨트롤러 그립 버튼(8) | Axis1D.SecondaryHandTrigger | 압착 | 12 | 0.01.0 |
참고:
- 터치 이벤트는 플랫폼마다 다릅니다.
- HTC Vive 컨트롤러의 트리거와 관련된 터치 이벤트는 사용자가 트리커를 압착하기 시작한 후에만 생성됩니다.
- 오큘러스 터치 트리거의 터치 이벤트는 터치가 감지될 때 발생하고, 압착할 필요가 없습니다.
- 그립 트리거는 플랫폼마다 다릅니다.
- HTC Vive 컨트롤러에는 양쪽에 그립 버튼이 있지만 모두 동일한 축에 매핑됩니다. 값은 누르지 않은 경우 0.0이고 누른 경우 1.0이며, 가능한 중간 값은 없습니다.
- 오큘러스 터치 컨트롤러의 그립은 범위가 0.01.0인 아날로그 트리거입니다.
- 위 표에 나열되어 있지 않은 하드웨어 기능은 OpenVR API를 통해 노출되지 않으므로 Unity의 입력 시스템을 통해 노출되지 않습니다.