Table of Contents

Unity 호환성

이 문서는 EasyAR Sense Unity Plugin이 지원하는 Unity 버전과 구성 요구 사항을 설명합니다.

Unity 버전

EasyAR Sense Unity Plugin은 Unity 2021.3 이상을 지원합니다.

Mega 기능 개발에 필요한 EasyAR Mega 지원 package는 Unity 2021.3.30 이상을 지원합니다.

팁

일반적으로 EasyAR는 자주 바뀌는 Unity API에 많이 의존하지 않기 때문에, Unity가 새 버전을 출시해도 EasyAR Sense Unity Plugin은 보통 정상적으로 사용할 수 있습니다.

EasyAR Sense Unity Plugin은 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 11.0 이상 x86_64, arm64

또한 해당 버전의 Unity 개발 시스템 요구 사항을 충족해야 합니다.

릴리스 플랫폼

운영 체제 운영 체제 버전 CPU 아키텍처 추가 설명
Windows 7 이상(7/8.1/10/11) x86, x86_64 Windows N/KN 버전은 Media Feature Pack 설치가 필요함.
EasyAR 화면 녹화 기능은 지원하지 않음.
macOS 11.0 이상 x86_64, arm64 EasyAR 화면 녹화 기능은 지원하지 않음.
Android 5.0 이상 armv7a, arm64-v8a arm64-v8a 지원에는 IL2CPP가 필요함.
EasyAR 화면 녹화 기능은 Graphics API가 OpenGLES2 또는 OpenGLES3일 때만 지원됨.
HarmonyOS(모바일) 1.0 – 4.x 기본 지원
5 이상은 Android 앱 호환 계층으로 지원1		 arm64-v8a
iOS 15.0 이상 arm64 Architecture는 ARM64로 설정해야 하며 Universal은 지원하지 않음.
EasyAR 화면 녹화 기능은 지원하지 않음.
visionOS 2.0 이상 arm64 EasyAR 화면 녹화 기능은 지원하지 않음.

또한 해당 버전의 Unity 릴리스 플랫폼 요구 사항도 충족해야 합니다.

macOS 추가 설명

Apple silicon

EasyAR Sense Unity Plugin은 4.6.0 버전부터 Apple silicon 장치에서 native 실행을 지원하며 Unity Editor에서도 정상적으로 사용할 수 있습니다.

참고

Unity의 native plugin 지원 버그로 인해 일부 Unity 버전에서는 "Apple silicon" 또는 *"Intel 64-bit + Apple silicon"*용으로 빌드한 앱이 정상 동작하지 않을 수 있습니다. Mac에서 앱을 사용할 수 없고 "Fail to load EasyAR library" 또는 "DllNotFoundException: EasyAR assembly" 같은 오류가 보이면 더 새로운 Unity 버전을 사용하거나 Unity 및 Unity 커뮤니티에 도움을 요청하는 것이 좋습니다.

Android 추가 설명

Android 16 KB 메모리 페이지 크기 지원

EasyAR Sense Unity Plugin은 4000 버전부터 16 KB 메모리 페이지 크기의 장치를 지원합니다.

팁

이 기능은 Android 15에서 도입되었습니다. 자세한 내용은 Android 문서의 16 KB 페이지 크기 지원을 참고하세요.

Google Play의 libhuawei_arengine_jni.so 경고가 16 KB 장치에서 앱 충돌을 유발할 수 있음

기본 설정에서 EasyAR Sense Unity Plugin은 Android에서 AR Engine SDK 3.7.0.3(libhuawei_arengine_jni.so 포함)을 사용해 Huawei AR Engine을 지원합니다. 이 라이브러리는 Huawei가 오래된 Android NDK로 빌드했기 때문에 Google Play가 경고를 표시할 수 있지만 실제 문제는 아닙니다.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

AR Engine SDK 관련:

  • 3.7.0.3 버전은 Huawei가 오래된 Android NDK로 빌드한 것이며, 이것이 Google Play 경고의 이유입니다. Google 문서의 Android NDK r27 이하로 앱 빌드를 참고하세요.
  • 3.7.0.3 버전은 Android 16 KB 메모리 페이지 크기 장치에서 로드를 지원하며, 이것이 Google Play가 앱 배포를 금지하지 않는 이유이기도 합니다.
  • 4.0.0.5 버전은 Android 16 KB 메모리 페이지 크기 장치에서 로드를 지원하지 않습니다. Android 생태계에서 공개적으로 사용 가능한 최신 버전이므로 EasyAR Sense Unity Plugin은 여전히 3.7.0.3 버전을 사용합니다.

EasyAR Sense Unity Plugin에서 AR Engine SDK 3.7.0.3을 사용해도 Google Play 배포에는 영향이 없고 실제 충돌도 발생하지 않습니다.

  • Huawei 장치는 Android 16 KB 장치가 아닙니다.
  • EasyAR Sense는 화이트리스트 메커니즘을 사용해 Huawei가 아닌 장치에서 AR Engine SDK가 실행되지 않도록 합니다.

이 경고 처리 방법:

  • Huawei 장치에서 AR Engine 기능을 사용해야 한다면 이 경고를 무시하는 것이 좋습니다.

  • Huawei 장치를 지원할 필요가 없거나 AR Engine 기능이 필요 없다면 EasyAR 구성에서 AR Engine SDK를 끌 수 있습니다.

    참고

    Huawei 장치에서는 AR Engine을 꺼도 EasyAR의 다른 기능은 정상적으로 동작하지만, 모션 추적 결과는 AR Engine과 달라지며 모션 추적을 사용하는 다른 기능도 영향을 받습니다.

HarmonyOS 추가 설명

Android와 호환되는 Harmony 시스템

EasyAR Sense Unity Plugin은 HarmonyOS 1.0 – 4.x를 완전히 지원합니다.

native HarmonyOS / 순정 HarmonyOS / HarmonyOS NEXT

EasyAR Sense Unity Plugin은 곧 native HarmonyOS 5.0+를 지원할 예정이며, 현재 버전은 아직 지원하지 않고 Android 앱 호환 계층으로만 사용할 수 있습니다.

팁

Unity 국제판은 native HarmonyOS를 지원하지 않으므로 Tuanjie Engine을 사용해야 합니다.

WebGL

EasyAR Sense Unity Plugin은 Unity WebGL을 지원하지 않습니다.

팁

EasyAR 클라우드 서비스 인터페이스(예: CRS 서비스 인터페이스)를 직접 사용해 개발한 기능은 Web 플랫폼에 배포할 수 있습니다.

Graphics API

EasyAR Sense Unity Plugin은 Unity의 렌더링 파이프라인을 직접 사용하므로, Unity에서 사용할 수 있는 모든 그래픽 API를 지원합니다.

Scriptable Render Pipeline

EasyAR Sense Unity Plugin은 Universal Render Pipeline(URP) 7.0.0 이상을 지원합니다.

EasyAR Sense Unity Plugin은 High Definition Render Pipeline(HDRP)을 지원하지 않습니다.

참고

Unity 6 URP 17+ render graph 지원에 대한 선언

EasyAR는 Unity 6 URP 17+ render graph를 지원하지만 Unity 자체에는 아직 해결되지 않은 문제가 일부 있습니다. 비정상 상황이 발생하면 Unity가 제공하는 URP 호환 모드를 시도할 수 있습니다.

일부 문제는 최신 Unity 버전에서 이미 해결되었으므로 6.2 이상 사용을 권장합니다.

비호환 모드에서 알려진 문제는 다음과 같습니다.

  1. [미해결] EasyAR에서 카메라 텍스처를 가져올 때(ImageTracking_Coloring3D 예제 및 ARSession workflow (CameraDevice) 예제처럼 사용), iOS/Mac 장치에서 시각적 결함과 아티팩트가 보일 수 있습니다. 우리는 이 문제를 순수 Unity package에서 재현했고 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가 아닌 값으로 설정해 이 문제를 피할 수 있습니다.

  2. [Unity 6.2에서 수정됨] Windows DX11에서 카메라 화면이 장면 오브젝트 렌더링 결과를 예측 불가능하게 만들 수 있습니다. Unity 6.0 - 6.1에서는 EasyAR가 우회 옵션을 제공하며 기본적으로 켜져 있습니다.

  1. 현재 버전은 아직 native HarmonyOS / 순정 HarmonyOS 5.0을 지원하지 않음.↩