Class EasyARSettings.UnityXROptions

네임스페이스

easyar

어셈블리

EasyAR.Sense.dll

Unity XR Framework와 관련된 구성 옵션입니다.

[Serializable]
public class EasyARSettings.UnityXROptions

상속

object

EasyARSettings.UnityXROptions

필드

ARFoundationSupport

EasyAR AR Foundation 지원입니다. 항상 켜 두는 것이 권장되며, 그렇지 않으면 ARFoundation 사용 시 EasyAR가 정상적으로 작동하지 않을 수 있습니다. 향후 AR Foundation 업데이트로 호환성 문제가 생겼고 EasyAR 업데이트가 아직 출시되지 않은 경우에만 끄는 것이 권장됩니다.

[Tooltip("EasyAR AR Foundation Support. It is recommended to keep this enabled; otherwise, EasyAR may not work properly with AR Foundation. Disable only if a future AR Foundation update causes incompatibility and EasyAR has not yet provided an update.")]
public bool ARFoundationSupport

UnityXRAutoSwitch

AR Foundation 객체와 같은 Unity XR 객체를 자동으로 전환합니다. 이 옵션은 주로 모바일 AR용으로 설계되었으며, 헤드셋에서는 기본 설정에서 기능이 비활성화됩니다.

이러한 컴포넌트의 전환을 직접 제어해야 하거나 EasyAR의 동작이 일부 컴포넌트의 정상 작동을 방해하는 경우, 이 옵션들을 비활성화해야 합니다.

런타임에 AR Foundation을 자동으로 전환해야 하는 경우 Unity의 오른쪽 클릭 메뉴를 통해 씬에 AR Foundation의 `ARSession` 및 `XR Origin`을 만들고 AR Foundation 카메라를 사용해야 합니다.

런타임에 ARSession은 awake에서 모든 Unity XR Core 컴포넌트 및 AR Foundation 컴포넌트를 비활성화합니다.

런타임에 선택된 frame source가 ARFoundationFrameSource에서 상속되었거나 XROrigin 원점을 구현한 ExternalDeviceFrameSource인 경우, 비활성화된 Unity XR Core 컴포넌트 및 AR Foundation 컴포넌트는 StartSession() 시 활성화됩니다(EasyAR가 비활성화하지 않은 것은 활성화되지 않습니다). 다른 frame source가 선택된 경우 StartSession() 시 모든 Unity XR Core 컴포넌트 및 AR Foundation 컴포넌트가 비활성화됩니다.

런타임에 모든 Unity XR Core 컴포넌트 및 AR Foundation 컴포넌트는 StopSession(bool) 시 비활성화됩니다.

XR Interaction Toolkit 컴포넌트는 이 옵션의 제어를 받지 않으며, EasyAR에서 사용할 수 있는지는 검증되지 않았다는 점에 유의하십시오. 이론적으로 XROrigin GameObject와 그 Camera만 사용하는 기능은 정상적으로 사용할 수 있어야 하지만, CenterMode를 SessionOrigin으로 설정해야 할 수 있습니다. 기능이 정상적으로 작동하지 않으면 XR Interaction Toolkit 컴포넌트를 직접 관리하고, frame source가 ARFoundationFrameSource에서 상속되지 않은 경우 관련 컴포넌트를 비활성화해야 합니다.

[Tooltip("Auto switch Unity XR (like AR Foundation) objects. This option is primarily designed for mobile AR. On head-mounted devices, the feature will be disabled by default. If you need to manually control the switching of these components, or if EasyAR's behavior interferes with the normal operation of certain components, make sure to disable these options. Please read API documents for more details.")]
public EasyARSettings.UnityXROptions.AutoSwitchOptions UnityXRAutoSwitch