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

  2. Device Manager 패널 상단의 Create 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 Back가 VirtualScene로 설정되어 있는지 확인합니다.

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

앱 실행

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

Google Play AR 서비스 업데이트

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

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

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

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

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

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

가상 장면 제어

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

가상 카메라 이동하기

카메라 움직임 제어에 액세스하려면 Shift 버튼을 길게 누르세요. 다음 컨트롤을 사용하여 카메라를 이동하세요.

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

에뮬레이터의 대화형 모드로 돌아가려면 Shift를 놓습니다.

Extended controls의 Virtual Sensors 탭을 사용하여 더 정확한 기기 배치를 확인하세요.

장면에 증강 이미지 추가

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

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

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

문제 해결 도움말

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

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

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