EasyAR Sense 라이선스 키로 초기화하기

Unity에서 EasyAR을 사용하려면 기능이 활성화되도록 라이선스 키로 EasyAR Sense를 초기화해야 합니다. 초기화에는 자동 초기화와 수동 초기화 두 가지 방법이 있습니다.

초기화가 성공하면 Unity 콘솔이나 운영체제 로그에서 EasyAR Sense 버전 및 플랫폼 정보를 확인할 수 있습니다. 예를 들면:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

사용하기 전에

EasyAR Sense 라이선스는 EasyAR Sense 라이선스(라이선스 키)를 얻는 방법을 설명합니다. EasyAR Sense를 초기화하기 전에 실제 사용하는 기기와 개발 단계에 맞는 적절한 라이선스를 준비해야 합니다.

자동 초기화는 대부분의 사용 시나리오에 적합합니다.

EasyAR 글로벌 설정을 열고 Initialize On Startup 옵션을 선택한 다음 EasyAR Sense License > LicenseKey를 입력합니다.

alt text

자동 초기화는 Unity의 BeforeSceneLoad 시점에 자동으로 호출됩니다.

에디터에서 사용하는 라이선스는 애플리케이션 패키지 이름을 검증하지 않으므로, 에디터에서 정상 작동하는 라이선스라도 플랫폼 애플리케이션이나 앱으로 빌드 시 실패할 수 있습니다. 이 경우 다음 두 가지 사항을 주의해야 합니다:

입력한 라이선스의 패키지 이름이 Unity Player Settings에 입력된 bundle id/package name과 일치해야 합니다.
Unity 빌드 후 gradle이나 XCode 프로젝트에서 패키지 이름을 수정한 경우, Unity에서 gradle이나 XCode의 패키지 이름을 사용해야 합니다.

수동 초기화는 사용자 개인정보 보호정책 표시(자세한 내용은 규정 준수 가이드 참조) 등과 같은 맞춤형 초기화 프로세스에 주로 사용됩니다.

EasyAR 글로벌 설정을 열고 Initialize On Startup 옵션 선택을 해제합니다.

alt text

그런 다음 EasyARController.Initialize() 인터페이스를 사용하여 수동으로 초기화를 호출합니다.

매개변수로 라이선스를 전달할 수 있습니다.

EasyARController.Initialize("my-license");

또는 EasyAR 글로벌 설정에 입력된 라이선스를 사용할 수도 있습니다.

EasyARController.Initialize();

EasyARController.Initialize()은 반드시 ARSession 시작 전에 호출해야 합니다.

특수한 상황에서 EasyARController.Initialize()을 여러 번 호출해야 하는 경우, 매번 EasyARController.Initialize() 실행 후 EasyARController.Deinitialize()으로 초기화 해제를 수행해야 합니다.

ARSession이 포함된 씬을 실행한 후 로그에 다음과 유사한 정보가 포함되지 않으면 초기화가 실패한 것입니다.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Unity 에디터에서는 다음과 같은 팝업이 표시될 수 있습니다.

alt text

팝업에 표시된 텍스트 정보를 주의 깊게 읽어야 합니다. 모든 팝업이 초기화 실패를 의미하는 것은 아닙니다.

흔히 발생하는 오류 메시지와 원인은 다음과 같습니다:

EasyARSettings is not found
- EasyAR 글로벌 설정 리소스 파일이 생성되지 않음(라이선스 미입력 시 흔함)
License Key is empty
- EasyAR 글로벌 설정에 라이선스가 입력되지 않았거나 프로젝트에 여러 개의 EasyAR 글로벌 설정 리소스 파일이 존재함
EasyARController.Initialize is not called (InitializeOnStartup = false)
- 수동 초기화가 적절한 시점에 호출되지 않음
EasyAR stops after script change in play mode
- 에디터 실행 중 스크립트가 변경됨. 재실행하면 정상 작동