Unity 호환성
이 문서는 EasyAR Sense Unity 플러그인이 지원하는 Unity 버전 및 구성 요구사항을 설명합니다.
Unity 버전
EasyAR Sense Unity 플러그인은 Unity 2021.3 이상을 지원합니다.
Mega 기능 개발을 위한 EasyAR Mega Studio는 Unity 2021.3.30 이상을 지원합니다.
팁
일반적으로 EasyAR은 자주 변경되는 Unity API에 의존하지 않으므로, Unity가 새 버전을 출시해도 EasyAR Sense Unity 플러그인은 정상적으로 작동할 수 있습니다.
EasyAR Sense Unity 플러그인은 버전 4.6.4부터 Unity 6의 URP 17+ Render Graph를 지원합니다.
개발 플랫폼
| 운영 체제 | 운영 체제 버전 | CPU 아키텍처 | 추가 설명 |
|---|---|---|---|
| Windows | 7 이상 (7/8.1/10/11) | x86, x86_64 | Windows N/KN 버전은 사용하려면 Media Feature Pack 설치 필요 |
| macOS | 10.15 이상 | x86_64, arm64 |
또한, 해당 버전의 Unity 개발 시스템 요구사항을 충족해야 합니다.
배포 플랫폼
| 운영 체제 | 운영 체제 버전 | CPU 아키텍처 | 추가 설명 |
|---|---|---|---|
| Windows | 7 이상 (7/8.1/10/11) | x86, x86_64 | Windows N/KN 버전은 사용하려면 Media Feature Pack 설치 필요 |
| macOS | 10.15 이상 | x86_64, arm64 | |
| Android | 5.0 이상 | armv7a, arm64-v8a | arm64-v8a 지원은 IL2CPP 활성화 필요 |
| Hongmeng (핸드셋) | 1.0 – 4.x 네이티브 지원 5 이상은 Android 앱 호환성 레이어를 통해 지원 |
arm64-v8a | |
| iOS | 12.0 이상 | arm64 | 아키텍처는 ARM64로 구성해야 하며, Universal 구성 미지원 |
| visionOS | 2.0 이상 | arm64 |
또한, 해당 배포 플랫폼에 대한 Unity 요구사항을 충족해야 합니다:
특별 사항:
Mac Apple silicon 관련:
EasyAR Sense Unity 플러그인은 Apple silicon 장비에서 네이티브로 실행되며 Unity 편집기에서 정상 작동합니다.
Unity의 네이티브 플러그인 지원 버그로 인해 일부 Unity 버전에서는 "Apple silicon" 또는 *"Intel 64-bit + Apple silicon"*으로 빌드된 앱이 정상 작동하지 않을 수 있습니다. Mac에서 앱이 작동하지 않고 "Fail to load EasyAR library" 또는 "DllNotFoundException: EasyAR assembly"와 유사한 오류가 표시되면 최신 버전의 Unity를 사용하거나 Unity 및 Unity 커뮤니티에 도움을 요청하는 것이 좋습니다.
Android 16KB 메모리 페이지 크기 지원 관련:
EasyAR Sense Unity 플러그인은 버전 4000부터 16KB 메모리 페이지 크기를 지원하는 장비를 지원합니다.
이는 Android 15에서 도입된 기능입니다. 자세한 내용은 Android 문서의 16KB 페이지 크기 지원을 참조하십시오.
WebGL 관련:
EasyAR Sense Unity 플러그인은 Unity의 WebGL을 지원하지 않습니다.
EasyAR 클라우드 서비스 인터페이스(예: CRS 서비스 인터페이스)를 직접 사용하는 기능은 Web 플랫폼에 게시될 수 있습니다.
화면 녹화 기능 관련:
화면 녹화 기능은 Android 플랫폼에서만 지원되며 Graphics API를 OpenGLES2 또는 OpenGLES3으로 구성해야 합니다.
Graphics API
EasyAR Sense Unity 플러그인은 Unity의 렌더링 파이프라인을 직접 사용하므로 Unity에서 사용 가능한 모든 그래픽스 API를 지원합니다.
Scriptable Render Pipeline
EasyAR Sense Unity 플러그인은 Universal Render Pipeline (URP) 7.0.0 이상을 지원합니다.
EasyAR Sense Unity 플러그인은 High Definition Render Pipeline (HDRP)을 지원하지 않습니다.
참고
Unity 6 URP 17+ render graph 지원에 관한 공지
EasyAR은 Unity 6 URP 17+ render graph를 지원하지만, Unity 자체에 아직 해결되지 않은 문제가 있습니다. 예외 상황이 발생하면 Unity가 제공하는 URP 호환 모드를 사용해 볼 수 있습니다.
일부 문제는 최신 버전의 Unity에서 해결되었으므로 6.2 이상 버전 사용을 권장합니다.
비호환 모드에서의 알려진 문제는 다음과 같습니다:
[미해결] EasyAR에서 카메라 텍스처를 가져올 때(ImageTracking_Coloring3D 샘플 및 ARSession 워크플로(CameraDevice) 샘플의 사용법과 유사), iOS/Mac 장비에서 시각적 결함 및 아티팩트가 관찰될 수 있습니다. 순수 Unity 패키지에서 이 문제를 재현하고 Unity에 보고했습니다: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). 진행 상황은 Unity Issue UUM-87787 업데이트 및 향후 Unity 버전 릴리스 노트를 참조하십시오.
모든 Unity 6 버전에 대해 부분적인 완화 조치를 사용할 수 있으며 기본적으로 활성화되어 있습니다.
Unity 6.2 이상 버전의 경우 Universal Render Pipeline Asset에서 Render Scale을 0.96-1.05 이외의 값으로 설정하여 이 문제를 회피할 수 있습니다.
[Unity 6.2에서 수정됨] Windows DX11에서 카메라 피드가 장면의 오브젝트 렌더링 결과를 예측 불가능하게 만들었습니다. Unity 6.0 - 6.1 버전에서 EasyAR은 회피 옵션을 제공하며 기본적으로 활성화되어 있습니다.