Table of Contents

EasyAR 구성

EasyAR 구성 페이지는 Unity 메뉴 EasyAR > Sense > Configuration 또는 Edit > Project Settings > EasyAR에서 접근할 수 있습니다.

alt text

여기에는 EasyAR Sense Unity Plugin에 대한 모든 전역 구성이 포함되어 있습니다.

alt text

Initialize On Startup

시작 시 EasyAR를 초기화합니다. 일반적으로 이 옵션을 켜 두는 것이 좋습니다.

이 옵션을 끄면 EasyAR Sense를 수동으로 초기화해야 합니다. 자세한 방법은 EasyAR Sense 초기화를 참조하세요.

EasyAR sense license

EasyAR Sense License 관련 구성입니다.

LicenseKey

EasyAR Sense License Key. EasyAR 기능을 사용하려면 유효한 라이선스를 입력해야 합니다.
인터페이스를 사용하여 EasyAR Sense를 수동으로 초기화할 때만 비워 둘 수 있습니다.

참고

헤드 마운트 디스플레이 장치(Vision Pro, XREAL, Pico, Rokid 등)에서 사용할 때는 EasyAR XR License가 필요합니다.

참고

사용자 정의 카메라 또는 헤드셋에서 평가판 제품(개인판 license, 평가판 XR license 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 100초(Mega 사용자는 EasyAR 비즈니스를 통해 승인 후 시간 조정 가능) 후에 응답을 중지합니다. 유료 버전의 EasyAR Sense와 유료 EasyAR Mega 서비스를 사용할 때는 이 제한이 없습니다.

Verify when build

Unity 프로젝트를 빌드할 때 라이선스 키를 검증합니다.
이 옵션이 켜져 있으면 Unity 프로젝트 빌드 과정에서 라이선스 키를 검증합니다. 라이선스가 빌드 플랫폼에서 유효하지 않거나 Unity Player Settings에서 설정된 패키지 이름을 포함하지 않으면 빌드 과정이 실패합니다. 다른 곳에서 구성된 라이선스 키를 사용하거나 Unity 빌드 과정 이후에 패키지 이름을 수정해야 하는 경우 이 옵션을 끌 수 있습니다.

Lib Variants

EasyAR Sense 라이브러리 변형 구성입니다.

EasyAR Sense는 일반적으로 다양한 변종이 있으며, 각 변종의 기능은 다릅니다. 여기에서는 플러그인에 통합된 라이브러리 변종을 비교하여 나열합니다.

Variant EasyAR Sense 변종 이름 기능 차이 기타 특수성
Normal Community/Enterprise 화면 녹화 및 관성 내비게이션 미포함
Full CommunityFull/EnterpriseFull 관성 내비게이션 및 일부 Mega 기능 포함 라이브러리 파일 크기가 큼
VideoRecording CommunityR 화면 녹화 기능 포함 (Android 전용)
팁

일부 Unity에서 사용할 수 없는 변종은 목록에 포함되어 있지 않습니다. 예를 들어 iOS의 CommunityR 변종입니다.

기본값:

  • EasyAR Mega 지원 패키지를 가져오지 않은 경우: Normal
  • EasyAR Mega 지원 패키지를 가져온 경우: Full

권장 구성:

  • Full : EasyAR Mega를 사용하거나 관성 내비게이션 기능을 사용하는 경우
  • Normal : 최소한의 패키지 크기를 원하고 EasyAR Mega나 관성 내비게이션 지원을 사용하지 않는 경우
  • VideoRecording : 화면 녹화 기능이 필요한 경우 (Android 전용)

Permissions

응용 프로그램 권한 구성입니다. 일반적으로 기본값을 유지하는 것이 좋습니다.

카메라 권한을 제외한 다른 권한 구성은 변경할 수 없으며, 다른 기능 구성에 따라 결정됩니다.

권한 변경 가능 여부 활성화 조건 권한 설명
Camera 예 카메라 권한, 카메라 장치를 사용하는 데 필요한 권한
AndroidMicrophone 아니요 Variant가 VideoRecording일 때 마이크 권한, 녹화 기능을 사용하는 데 필요한 권한
Location 아니요 Mega 지원 패키지를 가져올 때 (fine) 위치 권한, EasyAR Mega를 사용하는 데 필요한 권한

Unity XR

Unity XR 프레임워크(AR Foundation 등)와 관련된 구성입니다.

AR Foundation 지원

AR Foundation 지원 스위치입니다. 켜 둘 것을 권장합니다.

AR Foundation 4를 사용하거나 AR Foundation 업데이트로 인해 컴파일 오류가 발생하는 등의 극히 드문 경우 이 옵션을 끌 수 있지만, 플러그인 내에서 AR Foundation과 관련된 모든 기능이 동시에 비활성화됩니다.

참고

이 옵션을 변경하면 스크립트가 자동으로 다시 컴파일됩니다.

Unity XR 자동 전환

Unity XR(예: AR Foundation) 개체를 자동으로 전환하는 기능 구성입니다.

  • Editor ：에디터 모드 옵션
    • Disable AR Session ：ARSession이 존재할 때, 편집 시 AR Foundation의 ARSession을 비활성화합니다.
  • Player ：실행 모드 옵션
    • Enable ：실행 시 제어를 활성화합니다. 참고: 이 옵션을 끄면, 편집 모드에서 비활성화된 구성 요소가 실행 시 복원되지 않습니다.
    • Enable If Desktop ：Windows/Mac에서 활성화합니다.
    • Enable If Mobile AR On Startup ：전환기가 시작될 때, 모바일 AR(ARKit/ARCore)의 로더가 활성화된 경우 활성화합니다. 일반적으로 이 옵션은 XR Plug-in Management의 Initialize XR on Startup이 선택된 경우에 필요합니다.
    • Disable If Non Mobile AR Post Startup ：전환기가 시작될 때, 모바일 AR(ARKit/ARCore) 이외의 다른 로더가 존재하지만 어떤 로더도 활성화되지 않은 경우 비활성화합니다. 일반적으로 이 옵션은 XR Plug-in Management의 Initialize XR on Startup이 선택되지 않은 경우에 사용됩니다.
    • Restore AR Session When Disabled ：기능이 비활성화될 때, 비활성화된 모든 AR Foundation의 ARSession을 복원(활성화)합니다(이것이 EasyAR에 의해 비활성화되었는지 여부와 관계없이). 이 옵션은 일반적으로 편집 시 비활성화된 구성 요소를 복원하는 데 사용됩니다.

자세한 기능 설명은 Unity XR 자동 전환을 참조하세요.

Mega

EasyAR Mega 기능 구성입니다.

Mega Block/Landmark 지원

Mega Block/Landmark 지원을 사용할지 여부입니다.

com.easyar.mega를 가져온 후 이 옵션은 기본적으로 켜지며, 가져오지 않은 경우 기본적으로 꺼집니다.

InertialCameraDevice 지원

읽기 전용 옵션으로, 현재 구성에서 관성 카메라 장치 기능이 사용 가능한지 여부를 표시합니다.

표시된 정보가 요구 사항과 일치하지 않는 경우, Lib Variants 옵션을 적절히 수정해야 합니다.

ONNX 지원

읽기 전용 옵션으로, 현재 구성에서 ONNX 런타임 정보를 표시합니다.

표시된 정보가 요구 사항과 일치하지 않는 경우, Lib Variants 및 ONNX Runtime (Bundled) 옵션을 적절히 수정해야 합니다.

Mega Block > Localization Service Access [Global]

전역 Mega Block 위치 서비스 액세스 구성입니다.

Mega Landmark > Localization Service Access [Global]

전역 Mega Landmark 위치 서비스 액세스 구성입니다.

Spatial Map

EasyAR 공간 맵 기능 구성입니다.

Service Access [Global]

전역 희소 맵 서비스 액세스 구성입니다.

Image Tracking

EasyAR 이미지 추적 기능 구성입니다.

Target Gizmo

에디터에서 ImageTarget의 Gizmos 구성입니다.

이러한 옵션을 켜면 Unity Editor에서 해당 Gizmo가 표시됩니다. 만약 시나리오에 해당 유형의 타겟이 너무 많으면 에디터의 시작 성능에 영향을 줄 수 있습니다. 기기에서 실행할 때의 성능은 영향을 받지 않습니다.

Cloud Recognition (CRS) > Service Access [Global]

전역 클라우드 인식 서비스 액세스 구성입니다.

Object Tracking

EasyAR 객체 추적 기능 구성입니다.

Target Gizmo

에디터에서 ObjectTarget의 Gizmos 구성입니다.

  • Enable：Gizmos를 활성화합니다.

Third-Party Libraries

제 3자 라이브러리 구성

ARCore SDK

ARCore SDK 구성

ARCore는 일부 Android 디바이스에서 운동 추적 기능을 제공합니다. 운동 추적 및 EasyAR 기능을 읽어서 EasyAR 기능과 운동 추적의 관계, 및 ARCore를 사용해야 하는지와 언제 사용해야 하는지를 알 수 있습니다.

  • AR Foundation Or Optional: EasyAR 또는 AR Foundation과 함께 배포되는 ARCore SDK는 ARCore XR Plugin 설정에 따라 앱에 포함됩니다. 일반적으로 이 옵션을 사용하는 것이 좋으며, 이는 AR Foundation의 경우를 자동으로 처리합니다.
  • Optional: ARCore 기능은 ARCore를 지원하고 AR에 대한 Google Play 서비스가 설치된 디바이스에서 사용할 수 있습니다.
  • Required: 앱은 ARCore를 지원하고 AR에 대한 Google Play 서비스가 설치된 디바이스에서만 실행됩니다.
  • External: AR Foundation 또는 다른 ARCore SDK 배포를 사용하는 경우 이 옵션을 사용할 수 있습니다. 이렇게 하면 EasyAR와 함께 배포되는 ARCore SDK가 사용되지 않습니다. 또한 이 옵션을 사용하여 앱에서 ARCore SDK를 완전히 제외할 수도 있습니다.

[!경고] ARCore SDK를 Required로 설정하거나 AR Foundation의 ARCore 구성에서 요구 사항을 Required로 설정하고 ARCore를 지원하지 않는 디바이스에 패키징된 앱을 설치하면, 디바이스에서 ARCore가 사용 가능하다고 잘못 보고하고 ARCore로 실행됩니다. 이는 이러한 디바이스가 ARCore를 실행하고 있으며 정상적으로 작동하지 않는 것처럼 보일 수 있지만(검정 화면 또는 다른 예외 상황), 이는 잘못된 것입니다.

이러한 현상이 발생하는 원인은 Google Play 스토어가 ARCore를 필수로 표시하는 앱을 지원하지 않는 디바이스에 설치를 차단하기 때문입니다. 따라서 이러한 앱은 항상 지원되는 디바이스에서 실행되는 것으로 가정합니다.

일반 구성에서는 이러한 디바이스가 세션 조립 시 ARCore가 지원되지 않는다고 판단하고 EasyAR의 기능을 사용합니다.

Optional 및 Required에 대한 자세한 설명과 Google Play Store 앱을上线하기 위해 필요한 다른 구성은 Google의 설명( 중국 대륙, 국제)을 참조하세요.

[!참고] EasyAR Sense Unity Plugin에서 ARCore 지원에 필요한 라이브러리 파일과 구성은 플러그인 패키지에 이미 있지만, 모바일에서 실행하려면 모바일에 AR에 대한 Google Play 서비스를 설치해야 합니다.

세 가지 다른 소스에서 ARCore SDK를 사용할 수 있습니다.

  • 플러그인과 함께 배포되는 ARCore SDK 사용

    플러그인 내에 ARCore SDK 버전이 통합되어 있으며, 자세한 내용은 ARCore, AR Engine 버전 호환성을 참조하세요. EasyAR의 ARCore 포장을 사용할 때 AR Foundation를 별도로 가져올 필요가 없습니다.

  • AR Foundation의 ARCore SDK 사용

    AR Foundation의 ARCore SDK를 사용하려는 경우 Google의 설명( 중국 대륙, 국제)을 참조하여 구성할 수 있습니다. 이 경우 ARCore SDK 옵션을 AR Foundation Or Optional 또는 External로 선택해야 합니다.

  • 다른 ARCore SDK 사용

    다른 제 3자 플러그인 또는 프로젝트 내에 ARCore SDK가 배포되어 있는 경우 이러한 ARCore SDK도 사용할 수 있습니다. 이 경우 ARCore SDK 옵션을 External로 선택하고, 특정 플러그인 또는 프로젝트의 요구 사항에 따라 구성해야 합니다.

경고 32비트 만 ARCore 활성화 빌드

Google의 설명에 따르면, arm64 디바이스에서 armv7 라이브러리 파일만 있는 프로그램을 실행하면 ARCore가 제대로 작동하지 않습니다. 패키징 시 ARM64를 선택하지 않으면 경고가 표시됩니다.

alt text

이 경우 프로젝트 구성을 수정하여 IL2CPP를 사용하여 컴파일하고 ARM64 지원을 선택해야 합니다.

alt text

[!경고] 필요한 경우 Continue and don't warn me again을 선택하거나 이 옵션을 끄면 패키징 시 검사가 비활성화됩니다. 검사를 끄면 패키징 시 경고가 표시되지 않지만 실행 시 일부 디바이스에서 예외가 발생할 수 있으며 이에는 충돌 또는 검정 화면 등이 포함될 수 있습니다.

AR Engine SDK

AR Engine SDK 구성

AR Engine은 일부 Android 디바이스에서 운동 추적 기능을 제공합니다. 운동 추적 및 EasyAR 기능을 읽어서 EasyAR 기능과 운동 추적의 관계, 및 AR Engine를 사용해야 하는지와 언제 사용해야 하는지를 알 수 있습니다.

  • AREngineInterop: AREngineInterop 사용 가능. EasyAR와 함께 배포되는 AR Engine SDK가 앱에 포함됩니다.
  • External: AREngineInterop 사용 가능. EasyAR와 함께 배포되는 AR Engine SDK가 사용되지 않습니다.
  • Disabled: AREngineInterop 사용 불가. EasyAR와 함께 배포되는 AR Engine SDK가 사용되지 않습니다. 모든 AR Engine 관련 기능이 비활성화됩니다.

ONNX Runtime (Bundled)

번들된 ONNX 런타임을 사용할지 여부. Lib Variant가 Full일 때만 유효합니다.

다른 버전의 ONNX를 사용하려는 경우 ONNX官方에서 업데이트된 버전을 가져와 이 옵션을 끄세요. 자체로 컴파일한 이진 호환되지 않는 ONNX를 사용하면 알 수 없는 오류가 발생합니다.

Workaround For Unity

Unity 버그 또는 부적절한 동작에 대한 해결책입니다.

GenerateXMLDoc

스크립트 재로드 시 API 문서의 인텔리센스가 작동할 수 있도록 XML 문서를 생성합니다.

URP17RG_DX11_RuinedScene

URP 17 렌더 그래프 DX11 장면 렌더링 손상 문제에 대한 해결 방안. Unity 6.2 이상 버전에서는 비활성화됩니다.

URP17RG_IOS_Glitches_Partial

Unity Issue UUM-87787에 대한 부분적 해결 방안.

문제 요약: EasyAR에서 카메라 텍스처를 획득할 때(ImageTracking_Coloring3D 샘플 및 ARSession 워크플로우(CameraDevice) 샘플과 유사한 사용 사례), iOS/Mac 기기에서 시각적 결함 및 아티팩트가 관찰됩니다. 순수 Unity 패키지에서 이 문제를 재현하여 Unity에 보고했습니다: AR 카메라 이미지 렌더링 시 iOS에서 발생하는 그래픽 결함 (URP 17 render graph). 문제 진행 상황은 Unity Issue UUM-87787 업데이트 및 향후 Unity 버전 릴리즈 노트를 참조하십시오.