Android Emulator에서 AR 앱 실행

Android Emulator를 사용하여 실제 기기 없이 AR 시나리오를 테스트합니다. Android Emulator를 사용하면 개발자가 에뮬레이션된 기기를 사용하여 가상 환경에서 ARCore 앱을 실행할 수 있습니다.

개발 환경 설정

소프트웨어 요구사항:

ARCore용 Android 스튜디오 및 SDK 도구 다운로드

  1. Android 스튜디오 3.1 이상을 설치합니다.

  2. Android 스튜디오에서 Preferences > Appearance and Behavior > System Settings > Android SDK로 이동합니다.

  3. SDK Platforms 탭을 선택하고 Show Package Details를 선택합니다.

    해당하는 Android 버전에서 다음을 선택합니다.
    Google API Intel x86 Atom System Image API 수준 27 이상

  4. SDK Tools 탭을 선택하고 Android Emulator 27.2.9 이상을 추가합니다.

  5. OK를 클릭하여 선택한 패키지와 도구를 설치합니다.

  6. OK를 다시 클릭하여 변경사항을 확인합니다.

  7. Accept 구성요소 설치 프로그램의 라이선스 계약

  8. Finish를 클릭합니다.

AR 지원으로 가상 기기 만들기

자세한 내용은 Android 스튜디오의 가상 기기 만들기 안내를 참고하세요.

새 Android Virtual Device (AVD) 만들기

  1. Android 스튜디오에서 Tools > AVD Manager를 클릭하여 AVD Manager를 엽니다.

  2. AVD Manager 대화상자 하단에서 Create Virtual Device를 클릭합니다.

  3. 원하는 Phone 하드웨어 프로필을 선택하거나 만들고 Next를 선택합니다.

  4. API 수준 27 이상을 실행하는 x86 또는 x86_64 시스템 이미지를 선택하고 Next를 선택합니다.

    • 실제 ARCore 기기는 API 수준 24 이상에서 지원되지만 Android Emulator를 지원하려면 API 수준 27 이상이 필요합니다.

    • x86 기반 Android Emulator 아키텍처만 지원됩니다. arm64-v8a, armeabi-v7와 같은 다른 아키텍처는 현재 지원되지 않습니다.

  5. 가상 기기가 올바르게 구성되었는지 확인합니다.

    • Show Advanced Settings를 클릭합니다.

    • Camera BackVirtualScene로 설정되어 있는지 확인합니다.

  6. Finish를 클릭하여 AVD를 만듭니다.

앱 실행

에뮬레이터의 AR 지원 가상 기기에서 ARCore 앱을 테스트합니다. Android 스튜디오 안내에 따라 Android Emulator에서 앱 실행하면 됩니다.

Google Play AR 서비스 업데이트

에뮬레이터의 Google Play AR 서비스 버전이 오래된 것일 수 있습니다. 업데이트하려면 다음 안내를 따르세요.

  1. GitHub 출시 페이지에서 최신 Google_Play_Services_for_AR_1.35.0_x86_for_launcher.apk를 다운로드합니다.

  2. 사용하려는 각 AVD에 다운로드한 APK를 설치합니다.

    원하는 AVD를 시작한 후 다운로드한 APK를 시스템 폴더에서 드래그합니다(예: Downloads)를 실행 중인 에뮬레이터에 설치하거나 가상 기기가 실행되는 동안 adb를 사용하여 설치합니다.

    adb install -r Google_Play_Services_for_AR_1.35.0_x86_for_emulator.apk

사용하려는 추가 AVD에 이 단계를 반복합니다.

가상 장면 제어

앱이 ARCore에 연결되면 에뮬레이터 창 아래에 카메라와 상태 표시줄을 제어하는 방법을 설명하는 오버레이가 표시됩니다.

가상 카메라 이동

Option(macOS) 또는 Alt(Linux 또는 Windows)를 길게 눌러 카메라 이동 컨트롤에 액세스합니다. 카메라를 제어하려면 다음 컨트롤을 사용하세요.

플랫폼 작업 필요한 조치
macOS 왼쪽이나 오른쪽으로 이동 Option을 누른 상태에서 A 또는 D를 누름
위 또는 아래로 이동 Option을 누른 상태에서 Q 또는 E를 누름
앞으로 또는 뒤로 이동 Option을 누른 상태에서 W 또는 S를 누름
기기 방향 변경 Option + 마우스 이동
Linux 또는 Windows 왼쪽이나 오른쪽으로 이동 Alt를 누른 상태에서 A 또는 D를 누름
위 또는 아래로 이동 Alt를 누른 상태에서 Q 또는 E를 누름
앞으로 또는 뒤로 이동 Alt를 누른 상태에서 W 또는 S 누르기
기기 방향 변경 Alt + 마우스 이동

Option 또는 Alt를 해제하여 에뮬레이터의 대화형 모드로 돌아갑니다.

기기 위치를 더 정확하게 지정하려면 Extended controls에서 Virtual Sensors 탭을 사용하세요.

장면에 증강 이미지 추가

에뮬레이터의 시뮬레이션된 환경에 이미지를 로드하여 증강 이미지를 테스트합니다.

Extended controlsCamera 탭을 사용하여 Scene images을 추가하거나 수정합니다. 두 개의 이미지 위치가 있습니다. 하나는 벽면에, 다른 하나는 테이블에 있습니다.

장면에서 이러한 이미지 위치를 보려면 에뮬레이터를 실행한 다음 카메라 시작 위치 뒤의 도어를 통해 식당으로 카메라를 이동합니다.

문제 해결 도움말

  • ARCore 앱이 실행되고 '이 기기는 AR을 지원하지 않습니다'라는 메시지가 표시되면 시스템 이미지의 버전을 확인하세요. API 수준 27 버전 4 이상을 사용 중인지 확인합니다.

  • ARCore 앱이 실행될 때 카메라를 열지 않으면 위의 구성 단계에 설명된 대로 Camera BackVirtualScene로 설정되어 있는지 확인합니다.

  • 'AR 세션을 만들지 못했습니다'라는 오류 메시지와 함께 ARCore 앱이 열리지 않으면 앱 로그를 확인하세요. /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)가 포함된 메시지가 포함된 java.lang.UnsatisfiedLinkError를 발견하면 잘못된 버전의 Google Play AR 서비스 APK를 설치했을 수 있습니다. 새 가상 기기를 만들고 x86 버전을 설치합니다.