XR 씬 설정

XR 씬을 설정하려면 XR Origin을 추가합니다.

이러한 오브젝트는 씬 카메라 제어를 비롯하여 공간 추적 데이터를 씬으로 변환하기 위한 레퍼런스 프레임을 제공하는 게임 오브젝트 및 컴포넌트 컬렉션입니다. 씬에 XR Origin을 추가하면 연결된 카메라를 제어하여 사용자의 헤드 마운트(VR) 또는 핸드헬드(AR) 기기를 추적합니다. 또한 컨트롤러용 게임 오브젝트가 포함된__ XR__XR은 VR(가상 현실), AR(증강 현실)과 MR(혼합 현실) 애플리케이션을 모두 포함하는 포괄적인 용어입니다. 이러한 형태의 인터랙티브 애플리케이션을 지원하는 기기를 XR 기기라고 합니다. 자세한 정보
See in Glossary Origin 버전은 사용자의 컨트롤러를 추적하기 위해 이동합니다.

참고:

이전의 XR Rig이라는 이름은 Unity 씬에서 오브젝트의 역할을 더 잘 설명하기 위해 ‘rig’에서 ‘origin’으로 변경되었습니다. 또한, XR Origin 컴포넌트는 Camera Offset 컴포넌트를 대체하고 몇 가지 추가 설정을 제공합니다. 자세한 내용은 XR Origin 컴포넌트를 참조하십시오.
프로젝트에 XR Interaction Toolkit 패키지가 설치되어 있지 않은 경우에도 GameObject > XR 메뉴에 Convert Camera to XR Rig 옵션이 표시됩니다. 이 옵션은 여전히 작동하지만, 다른 XR 기능과의 호환성을 위해 XR Interaction Toolkit 또는 AR Foundation 패키지에서 적절한 XR Origin 옵션을 사용할 것을 권장합니다.
AR Foundation 패키지 버전 5에서는 AR Session Origin이 XR Origin (AR) 및 XR Origin (Mobile AR) 옵션으로 바뀌었습니다.
일부 XR Origin 오브젝트에 포함된 컨트롤러 게임 오브젝트에는 메시와 같은 시각적 컴포넌트가 없으며 추적 데이터 이외의 사용자 입력을 수신하도록 구성되지 않습니다. 원하는 경우 사용자 입력에 따라 작동하는 데 필요한 컴포넌트 또는 스크립트와 3D 모델을 추가해야 합니다. XR Interaction Toolkit 패키지는 사용자 입력을 처리하기 위한 컴포넌트를 제공합니다.

씬에서 사용할 수 있는 XR Origin 옵션에 대한 설명은 XR Origin을 참조하십시오.

선행 조건

XR의 씬을 설정하기 전에 먼저 다음을 수행해야 합니다.

XR 프로젝트를 설정합니다.
AR 앱을 개발 중인 경우 프로젝트에__ AR__증강 현실입니다. 자세한 정보
See in Glossary Foundation을 추가합니다.
XR Interaction Toolkit 패키지를 사용할 예정인 경우 이를 추가합니다(권장).
XR Interaction Toolkit을 사용하는 경우, 스타터 에셋을 임포트합니다. 이 에셋에는 XR 컨트롤러 입력을 구성하는 데 사용할 수 있는 입력 시스템 동작과 프리셋이 포함되어 있습니다.

XR의 씬 설정

XR의 씬을 설정하는 단계는 다음과 같습니다.

Unity 에디터에서 씬을 생성하거나 엽니다.
GameObject > XR 메뉴를 사용하여 씬에 XR Origin 옵션 중 하나를 추가합니다. 프로젝트에 추가한 XR 패키지에 따라 메뉴에 다양한 옵션이 표시됩니다. 사용할 수 있는 XR Origin 옵션에 대한 설명은 XR Origin을 참조하십시오.
XR 입력을 구성합니다. 자세한 내용은 XR 입력 옵션을 참조하십시오.

프로젝트에서 사용할 프로젝트 유형, 플랫폼, Unity 패키지에 따라 추가적인 설정 고려 사항이 있을 수 있습니다.

AR 프로젝트의 경우 추가 설정 단계와 자세한 지침은 AR Foundation 매뉴얼의 씬 설정을 참조하십시오.
XR Interaction Toolkit을 사용하는__ VR__가상 현실입니다. 자세한 정보
See in Glossary 프로젝트의 자세한 내용은 Interaction Toolkit 매뉴얼의 일반 설정을 참조하십시오.
Apple Vision Pro의 AR/MR 프로젝트의 경우 XR Origin대신 볼륨 카메라를 사용하십시오. PolySpatial visionOS: 새로운 visionOS 프로젝트 시작을 참조하십시오.
Apple Vision Pro의 VR 프로젝트의 경우 씬에 AR Foundation 패키지의 AR Session 오브젝트를 추가하여 머리 및 손 추적 데이터에 액세스해야 합니다. 또한 이 기기의 VR 앱은 평면 검출, 씬 재구성 메시, 이미지 추적과 같은 추가 ARKit 데이터에 액세스할 수 있습니다. visionOS의 완전 몰입형 VR을 참조하십시오.

XR 활성화 여부 감지

XR 컨텍스트와 XR이 아닌 컨텍스트 모두에서 사용할 수 있는 씬이 있는 경우 XRSettings.enabled 프로퍼티를 사용하여 XR 보조 시스템이 현재 로드되고 활성 상태인지 여부를 감지할 수 있습니다. 이 정보를 사용하면 적절한 게임 오브젝트 및 컴포넌트 세트를 활성화하거나 비활성화할 수 있습니다.

public void CheckXRStatus()
{
    if (UnityEngine.XR.XRSettings.enabled)
    {
        Debug.Log("XR is active.");
    }
    else
    {
        Debug.Log("XR is not available.");
    }
}

참고: XRSettings.enabled 프로퍼티의 값을 읽어 XR 상태를 확인할 수 있습니다. 하지만 값 설정은 더 이상 지원되지 않으며 아무런 영향도 미치지 않습니다. 런타임 시 XR을 동적으로 켜고 끄는 방법에 대한 자세한 내용은 XR 로더 라이프사이클 관리를 참고하십시오.

XR 프로젝트 생성

XR 입력 옵션

Unity 매뉴얼

XR 씬 설정

선행 조건

XR의 씬 설정

XR 활성화 여부 감지