Enabling AR Foundation in EasyAR projects
AR Foundation을 사용하기 위해 EasyAR의 AR Foundation 지원을 활성화하거나 AR Foundation의 다른 기능을 사용하려면 AR Foundation을 올바르게 설치 및 구성해야 합니다. 다음 내용은 이러한 작업을 수행하는 방법을 설명합니다.
시작하기 전에
- EasyAR의 Unity XR 프레임워크 지원을 읽어 EasyAR의 Unity XR 프레임워크 지원 현황과 AR Foundation 사용을 고려할 수 있는 상황을 파악하세요.
AR Foundation 버전 호환성
EasyAR은 AR Foundation 5 이상 버전을 지원합니다.
중요
AR Foundation 지원은 사용자 정의 카메라를 통해 구현됩니다.
사용자 정의 카메라 또는 헤드셋에서 평가판 제품(개인판 license, 평가판 XR license 또는 평가판 Mega 서비스 등)을 사용할 때, EasyAR Sense는 시작 후 100초(Mega 사용자는 EasyAR 비즈니스를 통해 승인 후 시간 조정 가능) 후에 응답을 중지합니다. 유료 버전의 EasyAR Sense와 유료 EasyAR Mega 서비스를 사용할 때는 이 제한이 없습니다.
AR Foundation 설치
AR Foundation 설치 시 AR Foundation 공식 문서를 참조하는 것이 좋습니다. 문서를 읽기 전 해당 버전에 맞는 문서를 선택했는지 확인하세요.
Unity 2022 이상 버전
프로젝트에 XR 관련 플러그인이 설치되지 않은 경우 Project Settings > XR Plug-in Management에서 Install XR Plugin Management 버튼을 클릭하여 XR Plug-in Management를 설치하고 설치가 완료될 때까지 기다리세요.
Android 플랫폼에서 AR Foundation을 사용하려면 Android 탭에서 Google ARCore를 체크하고 설치가 완료될 때까지 기다리세요.
iOS 플랫폼에서 AR Foundation을 사용하려면 iOS 탭에서 Apple ARKit를 체크하고 설치가 완료될 때까지 기다리세요.
visionOS 플랫폼에서 AR Foundation을 사용하려면 Vision Pro 프로젝트 설정을 참조하세요.
팁
AR Foundation이 기본 시작 시점에 초기화되도록 보장하기 위해 Initialize XR On Startup가 체크된 상태를 유지하는 것이 좋습니다.
설치가 완료되면 Package Manager 창을 열면 AR Foundation 및 해당 플랫폼 플러그인이 설치된 패키지 목록에 표시됩니다. 이 패키지들의 버전 번호가 완전히 일치해야 합니다.
중요
AR Foundation을 설치하거나 업데이트할 때 Google ARCore XR Plugin 및 Apple ARKit XR Plugin 버전이 AR Foundation 버전과 완전히 일치하는지 확인해야 합니다. 버전 불일치는 런타임 오류 또는 기능 이상을 초래할 수 있습니다.
Unity 2021
Unity 2021 버전에서는 버전을 지정하기 위해 Packages/manifest.json 파일을 수동으로 편집해야 합니다. 공식 문서를 참조하세요.
예를 들어, AR Foundation 5.2.0 버전을 설치하고 Android 및 iOS 플랫폼에서 사용하려면 Packages/manifest.json 파일에 다음 내용이 포함되어 있는지 확인하세요:
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
XR Plug-in 구성
EasyAR을 사용할 때 일반적으로 ARCore는 필수가 아닙니다. 따라서 ARCore를 지원하지 않는 기기에서 애플리케이션이 정상적으로 실행되지 않는 것을 방지하기 위해 ARCore를 선택 사항으로 구성해야 합니다.
Project Settings > XR Plug-in Management > ARCore에서 Requirement와 Depth를 모두 Optional로 설정하세요.
주의
Requirement를 Required로 설정하고 ARCore를 지원하지 않는 기기에 패키징된 애플리케이션을 설치하면 기기가 ARCore를 사용 가능하다고 잘못 보고하고 ARCore로 실행됩니다. 이는 ARCore를 지원하는 기기에서 실행 중인 것처럼 보이지만 실제로는 정상적으로 작동하지 않는(검은 화면 또는 기타 이상 현상) 오류를 유발합니다.
이 현상은 Google Play 스토어가 지원되지 않는 기기에 ARCore를 필수로 표시한 애플리케이션 설치를 차단하기 때문에 이러한 애플리케이션은 항상 지원되는 기기에서 실행된다고 가정하기 때문입니다.
정상적인 구성에서는 이러한 기기들이 session 조립 시 ARCore가 지원되지 않는다고 판단하고 EasyAR 기능을 사용합니다.
필요한 경우 ARCore 및 ARKit를 추가로 구성하기 위해 다음 공식 문서를 참조할 수 있습니다. 문서를 읽기 전 해당 버전에 맞는 문서를 선택했는지 확인하세요.
Universal Render Pipeline 구성
현재 프로젝트에서 URP를 사용 중인 경우 URP 에셋을 구성해야 합니다. 올바르게 구성되지 않으면 AR Foundation의 카메라 배경 이미지가 제대로 렌더링되지 않을 수 있습니다.
먼저 EasyAR의 URP Renderer Feature가 올바르게 구성되었는지 확인합니다. EasyAR의 Universal Render Pipeline 구성을 참조하세요.
그런 다음 Renderer Features 목록에 ARBackgroundRendererFeature를 추가하세요.
EasyAR의 URP Renderer Feature 구성과 마찬가지로 Project Settings > Quality에서 다양한 플랫폼에 대한 구성을 확인하고 AR Foundation을 사용해야 하는 모든 플랫폼에서 ARBackgroundRendererFeature가 올바르게 구성된 URP 에셋을 사용하도록 해야 합니다.
또한 AR Foundation 공식 URP 구성 문서를 참조하여 구성할 수도 있습니다. 문서를 읽기 전 해당 버전에 맞는 문서를 선택했는지 확인하세요.
참고
AR Foundation을 지원하지 않는 기기에서 EasyAR 인터페이스 관련 기능 렌더링이 정상적으로 작동하도록 보장하려면 EasyAR의 Universal Render Pipeline 구성이 여전히 필요합니다.
EasyAR AR Foundation 지원 활성화
Project Settings > EasyAR > Sense에서 Unity XR > AR Foundation Support 옵션이 활성화되었는지 확인하세요. 이 옵션은 기본적으로 활성화됩니다.
이 옵션을 변경하면 스크립트 재컴파일이 트리거되며, 스크립트 컴파일이 완료될 때까지 기다려야 변경 사항이 적용됩니다. 어떤 이유로든 Unity가 정상적으로 컴파일을 트리거하지 않으면 Unity를 종료하고 Library/ScriptAssemblies 폴더를 삭제하여 Unity가 스크립트를 강제로 재컴파일하도록 할 수 있습니다.
팁
EasyAR과 프로젝트의 AR Foundation이 호환되지 않고 EasyAR과 AR Foundation을 동시에 사용할 필요가 없는 경우 이 옵션을 끌 수 있습니다.
다음 단계
- EasyAR 프로젝트의 AR Foundation 씬 구성 및 사용법에 대해 알아보세요.
- 기기 지원 현황에 따라 AR Foundation을 자동으로 전환하는 방법을 알아보세요.