Player 구성

이 문서는 Unity에서 EasyAR Sense Unity Plugin을 사용하여 애플리케이션을 빌드할 때 주의해야 할 Player 설정 옵션을 설명합니다.

다른 플랫폼 구성 설명

Unity에서 빌드할 때 다음 설정을 확인하고 수정해야 합니다.

Unity 메뉴 File -> Build Settings-> Player Settings를 차례로 선택한 후 안드로이드 아이콘을 클릭하여 Android 플랫폼 설정을 엽니다.

switchtoandroid

일반적으로 다음 옵션을 설정해야 합니다.

Package Name Android 애플리케이션의 Package Name을 설정합니다. Package Name은 라이선스 키 생성 시 입력한 값과 반드시 일치해야 합니다.
API Level EasyAR이 지원하는 API level은 사용하는 버전에 따라 다릅니다. Full 변종을 사용할 경우 Android API Level 24 이상이 필요합니다. 다른 변종을 사용할 경우 EasyAR Sense는 Android API Level 21 이상이 필요합니다.
Target Architecture Google ARCore를 사용하거나 ARM64 지원 컴파일이 필요한 경우 IL2CPP로 컴파일하고 ARM64 지원을 선택해야 합니다. ARM64 아키텍처 지원이 필요하지 않은 경우 구성할 필요 없습니다.
비디오 녹화 기능의 특별 구성

비디오 녹화 기능을 사용하려면 Graphics API를 OpenGLES3 또는 OpenGLES2로 설정하고 Multithreaded Rendering 선택을 해제해야 합니다. 또한 EasyAR 구성에서 Lib Variants > Android를 VideoRecording으로 설정해야 합니다.

Unity 메뉴 File -> Build Settings-> Player Settings를 차례로 선택한 후 iOS를 클릭하여 iOS 플랫폼 설정 패널을 엽니다.

switchtoios

일반적으로 다음 옵션을 설정해야 합니다.

Bundle ID

iOS 애플리케이션의 Bundle ID를 설정합니다. Bundle ID는 라이선스 키 생성 시 입력한 값과 반드시 일치해야 합니다.
Target Architecture

Player Settings에서 architecture를 ARM64로 수정합니다. Universal을 사용할 수 없습니다.
Usage Description 구성

EasyAR 구성의 Permissions에서 활성화한 항목에 따라 다른 Usage Description을 구성해야 합니다.
- Camera 권한이 활성화된 경우 Camera Usage Description을 추가해야 합니다. 그렇지 않으면 빌드가 실패합니다.
- Location 권한이 활성화된 경우 Location Usage Description을 추가해야 합니다. 그렇지 않으면 빌드가 실패합니다.
EIF 녹화를 위한 추가 구성 (필요 시, XCode 프로젝트)

EIF를 기본 디렉터리에 녹화하고 iOS의 파일 앱을 통해 컴퓨터나 다른 기기로 전송하려면 Info.plist에 UIFileSharingEnabled를 추가하고 값을 true로 설정해야 합니다.

다음은 Player 구성과 관련된 일반적인 오류 및 해결 방법입니다.

라이선스 키 예외 오류

라이선스 키가 유효하지 않거나 (예: Package Name 불일치) 빌드 시 is not a valid EasyAR Sense license key or it does not match package name과 같은 오류가 발생할 수 있습니다. 계속 빌드를 선택하면 애플리케이션이 정상적으로 작동하지 않습니다. 오류 메시지를 확인하고 문제를 해결한 후 다시 빌드하세요.
빌드 시 라이선스 확인 비활성화

특별한 경우, Settings 파일의 License Key를 사용하지 않고 EasyAR 인터페이스를 수동으로 초기화하는 경우 Continue and don't warn me again을 선택하거나 EasyAR 구성에서 EasyAR Sense License > Verify When Build 옵션을 비활성화할 수 있습니다. 이렇게 하면 빌드 시 확인이 비활성화됩니다.
비 ARM 아키텍처 Android 기기 지원

EasyAR Sense는 x86 및 x86-64 아키텍처 Android 시스템을 직접 지원하지 않습니다. 그러나 일반적으로 x86 아키텍처 칩은 ARM 프로그램과 호환됩니다. 따라서 x86 아키텍처 선택을 취소하도록 구성하면 일부 x86 기기에서 정상적으로 사용할 수 있습니다.