Unity 호환성
이 문서는 EasyAR Sense Unity 플러그인이 지원하는 Unity 버전 및 구성 요구 사항을 설명합니다.
Unity 버전
EasyAR Sense Unity 플러그인은 Unity 2021.3 이상을 지원합니다.
Mega 기능 개발에 필요한 EasyAR Mega 지원 패키지는 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 활성화 필요 |
| HarmonyOS (모바일) | 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 16 KB 메모리 페이지 크기 지원 관련:
EasyAR Sense Unity 플러그인은 버전 4000부터 16 KB 메모리 페이지 크기를 가진 장치를 지원합니다.
이는 Android 15에서 도입된 기능입니다. 이 기능에 대한 자세한 내용은 Android 문서의 16 KB 페이지 크기 지원을 참조하십시오.
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은 회피 옵션]을 제공하며 기본적으로 활성화되어 있습니다.