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 APIs Intel x86 Atom System Image API Level 27 or 이후

  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 > Device Manager를 클릭하여 기기 관리도구를 엽니다.

  2. Device Manager 패널 상단에서 Create Device를 클릭합니다.

  3. 원하는 휴대전화 하드웨어 프로필을 선택하거나 생성하고 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 Back가 VirtualScene로 설정되어 있는지 확인합니다.

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

앱 실행

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

Google Play AR 서비스 업데이트

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.44.0_x86_for_emulator.apk

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

가상 장면 제어

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

가상 카메라 이동

카메라 이동 제어에 액세스하려면 Shift 키를 길게 누르세요. 다음 컨트롤을 사용하여 카메라를 이동합니다.

작업 필요한 조치
왼쪽 또는 오른쪽으로 이동 Shift를 누른 상태에서 A 또는 D를 누름
아래 또는 위로 이동 Shift를 누른 상태에서 Q 또는 E를 누름
앞으로 또는 뒤로 이동 Shift를 누른 상태에서 W 또는 S를 누름
기기 방향 변경 Shift 키를 누른 상태에서 마우스 이동

Shift를 해제하여 에뮬레이터에서 대화형 모드로 돌아갑니다.

더 정확한 기기 배치를 위해 확장 컨트롤의 Virtual Sensors 탭을 사용합니다.

장면에 증강 이미지 추가

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

Extended controls의 Camera 탭을 사용하여 Scene images를 추가하거나 수정합니다. 이미지는 두 곳(벽과 테이블 위에)으로 위치해 있습니다.

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

문제 해결 도움말

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

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

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