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

Unity XR(예: AR Foundation) 오브젝트를 자동으로 전환합니다. 이 옵션은 주로 모바일 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