기술 자료

Unity 엔진

Unity 엔진

Unity XR 입력

VR 및 AR용 장치 제어 및 기능에 액세스합니다.
읽는 시간 13분최근 업데이트: 9일 전

Unity 사용자 매뉴얼 섹션에서는 가상 현실, 증강 현실 및 Windows 혼합 현실 애플리케이션용 Unity 지원 입력 디바이스에 대한 정보를 제공합니다. 이 페이지에서는 다음 항목을 다룹니다.
XR 플랫폼에는 사용자 상호 작용을 디자인할 때 활용할 수 있는 다양한 입력 기능이 있습니다. 애플리케이션은 포지션, 회전, 터치, 버튼, 조이스틱, 손가락 센서를 참조하는 특정 데이터를 사용할 수 있습니다. 하지만 이러한 입력 기능에 대한 액세스는 플랫폼마다 매우 다를 수 있습니다. 예를 들어 데스크톱 VR 헤드셋 간에 작은 차이점이 있을 수 있지만, VR 지원 데스크톱 플랫폼과 독립형 모바일 헤드셋은 훨씬 더 다를 수 있습니다.
Unity는 InputFeatureUsage라는 C# 구조체를 제공합니다. 이 구조체는 모든 플랫폼에서 사용자 입력에 액세스하기 위한 표준 물리적 디바이스 컨트롤 세트(버튼 및 트리거 등)를 정의합니다. 이를 통해 이름을 기준으로 입력 유형을 식별할 수 있습니다. 각
InputFeatureUsage
의 정의는 XR.Input.CommonUsages를 참조하십시오.
각
InputFeatureUsage
는 공통 입력 액션 또는 유형에 해당합니다. 예를 들어, Unity는
trigger
라는
InputFeatureUsage
을 사용하는 XR 플랫폼에 관계없이 인덱스 손가락이 제어하는 단일 축 입력으로 정의합니다.
InputFeatureUsage
를 사용하여 이름을 사용하여
trigger
상태를 가져올 수 있으므로 기존 Unity Input System에 대해 축(또는 일부 XR 플랫폼의 버튼)을 설정할 필요가 없습니다.

XR 입력 매핑

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

InputFeatureUsage

기능 유형

레거시 입력 인덱스(왼쪽 컨트롤러/오른쪽 컨트롤러)

WMR

Oculus

GearVR

Daydream

OpenVR(전체)

Vive

Oculus via OpenVR

WMR via OpenVR

primary2DAxis2D 축[(1,2)/(4,5)]터치패드조이스틱터치패드터치패드Trackpad/Joystick트랙패드조이스틱조이스틱
trigger축[9/10]TriggerTriggerTriggerTriggerTriggerTriggerTriggerTrigger
grip축[11/12]그립(Grip)그립(Grip)범퍼그립(Grip)그립(Grip)그립(Grip)그립(Grip)
secondary2DAxis2D 축[(17,18)/(19,20)]조이스틱터치패드
secondary2DAxisClick버튼[18/19]조이스틱 - 클릭 수
primaryButton버튼[2/0][X/A] - 누르기앱기본기본(샌드위치 버튼)(1)기본(Y/B)메뉴
primaryTouch버튼[12/10][X/A] - Touch
secondaryButton버튼[3/1][Y/B] - 누르기대체대체(X/A)
secondaryTouch버튼[13/11][Y/B] - 터치
gripButton버튼[4/5]그립 - 누르기그립 - 누르기그립 - 누르기그립 - 누르기그립 - 누르기그립 - 누르기
triggerButton버튼[14/15]트리거 - 누르기트리거 - 누르기트리거 - 누르기트리거 - 누르기트리거 - 누르기트리거 - 누르기트리거 - 터치트리거 - 누르기
menuButton버튼[6/7]메뉴시작(왼쪽 컨트롤러만 해당)
primary2DAxisClick버튼[8/9]터치패드 - 클릭 수썸스틱 - 누르기터치패드 - 누르기터치패드 - 누르기트랙패드/조이스틱 - 누르기트랙패드 - 누르기조이스틱 - 누르기터치패드 - 누르기
primary2DAxisTouch버튼[16/17]터치패드 - 터치썸스틱 - 터치터치패드 - 터치터치패드 - 터치트랙패드/조이스틱 - 터치트랙패드 - 터치조이스틱 - 터치터치패드 - 터치
batteryLevel축battery.level
userPresence버튼사용자 상태사용자 상태
(1) 샌드위치 버튼은 Vive 메뉴 버튼을 나타냅니다. 이 버튼은 크로스 플랫폼 애플리케이션을 더 잘 처리하기 위해 menuButton이 아닌 primaryButton에 매핑됩니다.
각
InputFeatureUsage
의 정의는 XR.Input.CommonUsages를 참조하십시오.

입력 기기 액세스

InputDevice는 컨트롤러, 휴대폰 또는 헤드셋과 같은 모든 물리적 장치를 나타냅니다. 기기 추적, 버튼, 조이스틱, 기타 입력 컨트롤에 대한 정보가 포함될 수 있습니다.
InputDevice
API에 대한 자세한 내용은 InputDevice 기술 자료를 참조하십시오.
현재 XR 시스템에 연결된 입력 디바이스에 액세스하려면 XR.InputDevices 클래스를 사용합니다. 연결된 모든 디바이스 목록을 가져오려면 다음과 같이 InputDevices.GetDevices를 사용합니다.
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 프로퍼티를 사용하여
InputDevice
가 여전히 활성 컨트롤러를 나타내는지 확인합니다.
다음을 통해 입력 기기에 액세스할 수 있습니다.
  • 특성:
  • 역할
  • XR 노드

특성별로 입력 디바이스 액세스

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

Device

특성

HeadMounted기기가 사용자의 머리에 연결됩니다. 기기 추적과 중앙 시각 추적이 있습니다 이 플래그는 HMD(헤드 마운트 디스플레이)를 식별하는 데 가장 자주 사용됩니다.
Camera기기에는 카메라 추적이 있습니다.
HeldInHand사용자가 기기를 손으로 잡습니다.
HandTracking기기는 물리적으로 추적된 손을 나타냅니다. 디바이스 트래킹이 있으며, 손과 뼈대 데이터가 포함될 수 있습니다.
EyeTracking이 장치는 눈 추적을 수행할 수 있으며 EyesData 기능이 있습니다.
TrackedDevice장치는 3D 공간에서 추적할 수 있습니다. 디바이스 트래킹이 있습니다
관리자기기에는 버튼 및 축에 대한 입력 데이터가 있으며 컨트롤러로 사용할 수 있습니다.
TrackingReference기기는 정적 추적 레퍼런스 오브젝트를 나타냅니다. 디바이스 트래킹이 있지만 트래킹 데이터는 변경되어선 안 됩니다.
왼쪽이 특성을 HeldInHand 또는 HandTracking 특성과 함께 사용하여 왼손과 연결된 디바이스를 식별합니다.
오른쪽이 특성을 HeldInHand 또는 HandTracking 특성과 함께 사용하여 오른손과 연결된 디바이스를 식별합니다.
Simulated6DOF기기는 6DOF 데이터를 보고하지만 3DOF 센서만 있습니다. Unity 포지션 데이터를 시뮬레이션합니다.
XR 공급자 플러그인은 이러한 특성을 보고합니다. InputDevice.Characteristics로 검색할 수 있습니다. 기기는 비트 플래그를 사용하여 필터링하고 액세스할 수 있는 여러 특성을 가질 수 있으며, 종종 있어야 합니다.
InputDevices.GetDevicesWithCharacteristics는 특정 특성을 가진 모든 기기를 검색하는 방법을 제공합니다. 예를 들어 다음 코드를 사용하여 시스템에서 사용 가능한 Left, HeldInHand, Controller InputDevices를 검색할 수 있습니다.
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만 찾을 수 있습니다.

역할별로 입력 디바이스 액세스

기기 역할은 입력 기기의 일반적인 기능을 설명합니다. 디바이스 역할을 지정하려면 InputDeviceRole 열거형을 사용합니다. 정의된 역할은 다음과 같습니다.

역할

설명

GameController콘솔 스타일 게임 컨트롤러입니다.
Generic코어 XR 장치를 나타내는 장치(예: 헤드 마운트 디스플레이 또는 모바일 장치)
HardwareTracker트래킹 기기입니다.
왼손잡이사용자의 왼손잡이와 연결된 기기입니다.
RightHanded사용자의 오른손과 연결된 기기입니다.
TrackingReferenceOculus 추적 카메라와 같이 다른 장치를 추적하는 장치입니다.
XR 공급자 플러그인은 이러한 역할을 보고하지만, 다른 공급자는 기기 역할을 다르게 구성할 수 있습니다. 또한 사용자가 손을 전환할 수 있으므로 역할 할당이 사용자가 입력 기기를 잡는 손과 일치하지 않을 수 있습니다. 예를 들어 사용자는 컨트롤러를 오른손이나 왼손으로 설정할 수 있지만, 컨트롤러를 다른 손으로 잡습니다.
GetDevicesWithRole은 특정
InputDeviceRole
가 있는 모든 장치 목록을 제공합니다. 예를 들어,
InputDeviceRole.GameController
를 사용하여 연결된 모든
GameController
장치를 가져올 수 있습니다.
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 노드로 입력 장치 액세스

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

XR 노드

설명

CenterEye사용자의 동공 사이의 중간 지점입니다.
GameController콘솔 스타일 게임 컨트롤러입니다. 앱에 여러 게임 컨트롤러 기기가 있을 수 있습니다.
HardwareTracker일반적으로 사용자 또는 물리적 아이템에 연결된 하드웨어 트래킹 디바이스입니다. 여러 하드웨어 트래커 노드가 존재할 수 있습니다.
--headXR 시스템으로 계산된 사용자의 머리의 중심 지점입니다.
왼쪽 눈사용자의 왼쪽 눈
LeftHand사용자의 왼손
오른쪽 눈사용자의 오른쪽 눈입니다.
RightHand사용자의 오른손입니다.
TrackingReference추적 참조점(예: Oculus 카메라) 여러 트래킹 레퍼런스 노드가 존재할 수 있습니다.
특정
XRNode
와 연결된 디바이스 목록을 가져오려면 InputDevices.GetDevicesAtXRNode를 사용합니다. 다음 예시는 왼손잡이 컨트롤러를 가져오는 방법을 보여 줍니다.
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!");}

디바이스 연결 및 연결 해제 수신

입력 디바이스는 프레임에서 프레임까지 일관되지만 언제든지 연결하거나 연결 해제할 수 있습니다. 기기가 플랫폼에 연결되었는지 반복적으로 확인하지 않으려면 InputDevices.deviceConnected 및 InputDevices.deviceDisconnected를 사용하여 기기가 연결되거나 연결 해제되면 애플리케이션에 알립니다. 또한 새로 연결된 입력 디바이스에 대한 레퍼런스도 제공합니다.
여러 프레임에 걸쳐 이러한 레퍼런스를 유지할 수 있으므로 기기가 연결이 끊어지거나 더 이상 사용할 수 없습니다. 기기의 입력을 계속 사용할 수 있는지 확인하려면 InputDevice.isValid를 사용하십시오. 입력 디바이스에 액세스하는 스크립트는 해당 디바이스를 사용하기 전에 각 프레임의 시작 부분에서 이를 확인해야 합니다.

입력 기기의 입력 기능 액세스

특정 InputDevice에서 트리거 버튼의 상태와 같은 입력 기능을 읽을 수 있습니다. 예를 들어 오른쪽 트리거의 상태를 읽으려면 다음 단계를 따르십시오.
  1. 오른손 장치의 인스턴스를 가져오려면 InputDeviceRole.RightHanded 또는 XRNode.RightHand를 사용합니다.
  2. 올바른 디바이스가 있으면 InputDevice.TryGetFeatureValue 메서드를 사용하여 현재 상태에 액세스합니다.
TryGetFeatureValue()
는 기능의 현재 값에 액세스하려고 시도하고 다음을 반환합니다.
  • 지정된 기능 값을 검색해서 가져온 경우 true입니다.
  • 현재 기기가 지정된 기능을 지원하지 않거나 기기가 유효하지 않거나(즉, 컨트롤러가 더 이상 활성화되지 않음) false입니다.
특정 버튼, 터치 입력 또는 조이스틱 축 값을 가져오려면 CommonUsages 클래스를 사용합니다.
CommonUsages
에는 XR 입력 매핑 표의 각
InputFeatureUsage
와 포지션 및 회전과 같은 추적 기능이 포함됩니다. 다음 코드 예제는 CommonUsages.triggerButton을 사용하여 사용자가 특정
InputDevice
인스턴스에서 현재 트리거 버튼을 누르고 있는지 감지합니다.
bool triggerValue;if (device.TryGetFeatureValue(UnityEngine.XR.CommonUsages.triggerButton, out triggerValue) && triggerValue){ Debug.Log("Trigger button is pressed.");}
InputDevice.TryGetFeatureUsages 메서드를 사용하여 기기가 제공하는 모든
InputFeatureUsage
목록을 가져올 수도 있습니다. 이 함수는 기능을 설명하는 타입과 이름 프로퍼티가 있는 InputFeatureUsage 항목 리스트를 반환합니다. 다음 예시는 특정 입력 기기가 제공하는 모든 부울 기능을 열거합니다.
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 예시

컨트롤러 구성에 따라 다양한 기능에 액세스할 수 있습니다. 예를 들어 하나의 시스템에는 여러 개의 컨트롤러가 있고, 다른 시스템에는 여러 개의 컨트롤러가 있고, 다른 SDK를 사용하는 동일한 컨트롤러에는 여러 개의 버튼이 있을 수 있습니다. 이러한 다양성은 다양한 XR 시스템의 입력을 지원하기가 더 복잡해집니다. Unity
InputFeatureUsage
API를 사용하면 플랫폼에 의존하지 않는 입력을 얻을 수 있습니다.
다음 예제에서는 컨트롤러나 입력 장치에 관계없이
primaryButton
라는
InputFeatureUsage
에 액세스합니다. 예제에는 연결되는
primaryButton
의 사용 가능한 디바이스를 검색하는 클래스가 포함되어 있습니다. 클래스는 연결된 기기에서 기능의 값을 모니터링하고 값이 변경되면 클래스가 UnityEvent를 디스패치합니다.
이 클래스를 사용하려면 씬의 모든 게임 오브젝트에 컴포넌트로 추가합니다. 예제는 아래와 같습니다.
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 프로퍼티로 드래그합니다.
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; } }}

손 추적 데이터 액세스

InputDevices는 손 추적 기기를 지원합니다. 핸드 트래킹 디바이스는 항상 다음을 수행합니다.
핸드 트래킹 데이터는 핸드 오브젝트와 최대 21개의 뼈대 입력 기능으로 구성됩니다. 각 뼈대에는 위치와 방향이 있으며 계층 구조에서 부모 뼈대와 자식 뼈대에 대한 레퍼런스도 있습니다. 핸드 오브젝트는 루트 뼈대나 각 손가락의 뼈대 목록을 가져올 수 있습니다.
Hand.TryGetRootBone이 루트 뼈대를 얻으면 손목 바로 위에 있는 뼈대를 나타내는 객체를 검색합니다. 각 손가락을 나타내는 뼈대 목록도 가져올 수 있습니다. 호출 Hand.TryGetFingerBones는 손가락에서 끝까지 해당 손가락을 나타내는 뼈대의 목록을 반환합니다.

눈 추적 데이터 액세스

입력 기기는 눈 추적 기기와 손 추적 기기를 지원합니다. 눈 추적은 왼쪽 및 오른쪽 눈 포지션, 사용자가 바라보는 3D 공간의 위치, 각각의 눈이 깜박이는 정도로 구성됩니다. 데이터 유형은 Eyes입니다. 장치에서 가져오려면 CommonUsages.eyesData를 사용하십시오.

XRInputSubsystem 및 InputDevice 연결

Unity는 두 가지 입력 시스템, 즉 레거시 Input System과 2019.2에 도입된 XR 플러그인 아키텍처를 제공합니다. 새 설정에서 각 InputDevice는 XRInputSubsystem과 연결됩니다. 이러한 보조 시스템 오브젝트는 특정 입력 디바이스와 관련이 없는 전역 입력 동작을 제어합니다(예: 트래킹 원점 관리, 트래킹된 디바이스 재중심).
각 InputDevice에는 연결된 보조 시스템에 대한 레퍼런스가 포함되어 있습니다. 기기가 연동된 플랫폼에서 가져온 경우 이 레퍼런스는 null. SubsystemManager.GetInstances<XRInputSubsystem>를 사용하여 모든 활성 XRInputSubsystem 객체를 가져올 수도 있으며, 각 XRInputSubsystem은 XRInputSubsystem.TryGetInputDevices를 사용하여 해당 기기를 가져올 수도 있습니다.
입력 하위 시스템을 사용하여 UnityEngine.XR.XRInputSubsystem을 사용하여 기기를 다시 등록할 수 있습니다. Recenter는 HMD의 현재 포지션을 모든 기기의 새로운 원점으로 설정합니다. 재중심할 수 없는 기기나 플랫폼이 재중심을 지원하지 않는 경우에는 false를 반환합니다.
추적 경계를 검색하려면 TryGetBoundaryPoints를 사용합니다. 이것은 일련의 시계 방향으로 정렬된 3D 점으로 구성되며, y 값은 바닥 수준에 있으며, 사용자가 지정한 '안전한 영역'을 표시하여 콘텐츠와 상호 작용을 배치합니다. XRInputSubsystem.boundaryChanged를 사용하여 이 경계의 변경 사항을 수신할 수 있습니다.
XRInputSubsystem은 트래킹 월드의 원점에 대한 컨텍스트를 제공하는 트래킹 원점 모드도 담당합니다. Unity 다음의 추적 원점 모드를 지원합니다.
  • Device 원점 위치는 기본 디스플레이 디바이스의 첫 번째 알려진 위치에 있으며, 이는 HMD 또는 휴대폰의 경우가 많습니다.
  • 층: 원점 위치는 바닥에 있는 알려진 위치에 있습니다.
  • 추적 참조: 원점 위치는 TrackingReference 특성이 설정된 InputDevice에 있습니다.
  • UNKNOWN 트래킹 원점의 유형은 알 수 없습니다. 이는 시스템 오류 또는 추적 원점 모드 지원 부족으로 인해 발생할 수 있습니다.
다음 세 가지 API를 사용하여 추적 원점 모드를 관리할 수 있습니다.

레거시 Input System 통한 XR 입력

Input 및 XR.InputTracking으로 구성된 레거시 Input System을 사용하여 XR 입력 기능을 검색할 수 있습니다. 이렇게 하려면 이 페이지의 XR 입력 매핑 표에서 적절한 레거시 입력 인덱스를 사용하십시오.
플레이어 설정

?

의 입력 섹션(메뉴: 편집 >
프로젝트 설정

?

> 입력), 플랫폼 장치의 기능에 대한 입력 이름에서 축 인덱스에 대한 적절한 매핑을 추가하는 축 매핑을 생성합니다. 버튼 또는 축 값을 가져오려면 Input.GetAxis 또는 Input.GetButton을 사용하고 현재 매핑된 축 또는 버튼 이름을 전달합니다.
버튼 및 조이스틱 축을 사용하는 방법에 대한 자세한 내용은 InputManager 문서를 참조하십시오.

맵틱

입체 이벤트를 InputDevice로 전송할 수 있습니다. 감쇠는 진폭과 지속 시간을 가지는 임펄스 형태를 가집니다.
모든 플랫폼이 모든 유형을 지원하는 것은 아닙니다. 하지만 힙틱 성능을 기기에서 쿼리할 수 있습니다. 다음 예시에서는 오른손에 대한 입력 디바이스를 가져오고, 디바이스가 감마를 할 수 있는지 확인한 다음, 가능한 경우 임펄스를 재생합니다.
목록<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); } }}