EasyAR configuration
EasyAR 구성 페이지는 Unity 메뉴 EasyAR > Sense > Configuration 또는 Edit > Project Settings > EasyAR에서 접근할 수 있습니다.
여기에는 EasyAR Sense Unity Plugin의 모든 전역 구성이 포함됩니다.
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 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 빌드 과정 이후에 패키지 이름을 수정해야 하는 경우 이 옵션을 끌 수 있습니다.
Permissions
앱 권한 구성. 일반적으로 기본값을 유지하는 것이 권장됩니다.
카메라 권한 외 다른 권한 구성은 변경할 수 없으며, 다른 기능 구성에 따라 결정됩니다.
| 권한 | 변경 가능 | 활성화 조건 | 권한 설명 |
|---|---|---|---|
Camera |
예 | 카메라 장치 사용에 필요한 권한 | |
AndroidMicrophone |
아니오 | Variant가 VideoRecording일 때 | 마이크 권한, 화면 녹화 기능 사용에 필요 |
Location |
아니오 | Mega 지원 패키지 임포트 시 | (정밀) 위치 권한, EasyAR Mega 사용에 필요 |
Unity XR
Unity XR 프레임워크(AR Foundation 등) 관련 구성.
AR foundation support
AR Foundation 지원 스위치, 켜두는 것이 권장됩니다.
매우 드문 경우(예: AR Foundation 4 사용 필요 또는 AR Foundation 업데이트로 인한 컴파일 오류)에 이 옵션을 끌 수 있지만, 플러그인 내 모든 AR Foundation 관련 기능이 동시에 비활성화됩니다.
참고
이 옵션 변경 후 스크립트가 자동으로 재컴파일됩니다.
Unity XR auto switch
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: 기능 비활성화 시, EasyAR에 의해 비활성화되었든 여부와 관계없이 모든 AR Foundation ARSession 복원(활성화). 이 옵션은 편집 중 비활성화된 컴포넌트 복원에 사용.
자세한 기능 설명은 Unity XR 자동 전환 참조.
Mega
EasyAR Mega 기능 구성.
InertialCameraDevice support
읽기 전용 옵션, 현재 구성에서 관성 내비게이션 기능 사용 가능 여부 및 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가 표시되며, 해당 유형의 target이 장면에 많을 경우 에디터 시작 성능에 영향을 줄 수 있습니다. 기기에서 실행 시 성능에는 영향 없음.
Enable Image File: ImageTargetController.Source 유형이 ImageTargetController.ImageFileSourceData인 target의 Gizmos 활성화.Enable Target Data File: ImageTargetController.Source 유형이 ImageTargetController.TargetDataFileSourceData인 target의 Gizmos 활성화.Enable Target: ImageTargetController.Source 유형이 ImageTargetController.TargetSourceData인 target의 Gizmos 활성화.Enable Texture 2D: ImageTargetController.Source 유형이 ImageTargetController.Texture2DSourceData인 target의 Gizmos 활성화.
Cloud recognition (CRS) > Service access [Global]
전역 클라우드 인식 서버 구성.
Object tracking
EasyAR 객체 추적 기능 구성.
Target gizmo
에디터에서 ObjectTarget의 Gizmos 구성.
Enable: Gizmos 활성화.
Third-party libraries
타사 라이브러리 구성.
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를 지원하고 Google Play Services for AR이 설치된 기기에서 사용 가능합니다.Required: 앱은 ARCore를 지원하고 Google Play Services for AR이 설치된 기기에서만 실행됩니다.External:AR Foundation또는 다른 ARCore SDK 배포를 사용하는 경우 이 옵션을 사용하세요. 이렇게 하면 EasyAR와 함께 배포되는 ARCore SDK가 사용되지 않습니다. 앱에서 ARCore SDK 사용을 완전히 배제하기 위해 이 옵션을 사용할 수도 있습니다.
주의
ARCore SDK를 Required로 설정하거나 AR Foundation의 ARCore 구성에서 Requirement를 Required로 설정하고 ARCore를 지원하지 않는 기기에 패키징된 앱을 설치하면, 기기가 ARCore를 사용 가능하다고 잘못 보고하고 ARCore로 실행합니다. 이는 해당 기기들이 ARCore를 실행 중인 것처럼 보이고 제대로 작동하지 않는(검은 화면 또는 기타 비정상적인 상황) 거짓 현상을 초래하지만, 이는 잘못된 것입니다.
이 현상은 Google Play 스토어가 ARCore를 필수로 표시한 앱이 지원되지 않는 기기에 설치되는 것을 차단하기 때문에 발생합니다. 따라서 이러한 앱은 항상 지원되는 기기에서 실행 중이라고 가정합니다.
정상적인 구성에서는 이러한 기기들이 세션 조립 시 ARCore가 지원되지 않는다고 판단하고 EasyAR의 기능을 사용합니다.
Optional 및 Required에 대한 자세한 설명과 Google Play Store 앱 출시 시 필요한 기타 구성은 Google 설명(중국 본토, 국제)을 참조하세요.
참고
EasyAR Sense Unity Plugin에서 ARCore 지원에 필요한 라이브러리 파일과 구성은 플러그인 패키지에 포함되어 있지만, 휴대폰에서 실행하려면 휴대폰에 Google Play Services for AR를 설치해야 합니다.
사용 가능한 세 가지 출처의 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 사용
다른 타사 플러그인이나 프로젝트 내에 ARCore SDK 배포가 있는 경우, 이러한 ARCore SDK를 사용할 수도 있습니다. 이때
ARCore SDK옵션을External로 선택하고, 해당 플러그인 또는 프로젝트의 요구 사항에 따라 구성하세요.
Warn 32-bit-only arcore-enabled 빌드
Google 설명에 따르면, arm64 기기에서 armv7 라이브러리 파일만 있는 프로그램을 실행하면 ARCore가 정상적으로 작동하지 않습니다. 패키징 시 ARM64를 선택하지 않으면 경고가 표시됩니다:
이때 프로젝트 구성을 수정하여 IL2CPP로 컴파일하고 ARM64 지원을 선택해야 합니다.
주의
반드시 필요한 경우 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 버전 릴리즈 노트를 참조하십시오.