Menjalankan Aplikasi AR di Android Emulator

Gunakan Android Emulator untuk menguji skenario AR tanpa perangkat fisik. Android Emulator memungkinkan Anda menjalankan aplikasi ARCore di lingkungan virtual dengan perangkat emulasi yang Anda kontrol.

Menyiapkan lingkungan pengembangan

Persyaratan perangkat lunak:

Mendapatkan Android Studio dan alat SDK untuk ARCore

  1. Instal Android Studio 3.1 atau yang lebih baru.

  2. Di Android Studio, buka Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. Pilih tab SDK Platforms dan centang Show Package Details.

    Di bagian versi Android yang sesuai, pilih:
    Google APIs Intel x86 Atom System Image API Level 27 atau yang lebih baru.

  4. Pilih tab SDK Tools dan tambahkan Android Emulator 27.2.9 atau yang lebih baru.

  5. Klik OK untuk menginstal paket dan alat yang dipilih.

  6. Klik OK lagi untuk mengonfirmasi perubahan.

  7. Accept perjanjian lisensi untuk Penginstal Komponen.

  8. Klik Finish.

Membuat perangkat virtual dengan dukungan AR

Untuk informasi selengkapnya, lihat petunjuk Android Studio untuk Membuat Perangkat Virtual.

Membuat Perangkat Virtual Android (AVD) baru

  1. Di Android Studio, buka Pengelola Perangkat dengan mengklik Tools > Device Manager.

  2. Klik Create Device, di bagian atas panel Pengelola Perangkat.

  3. Pilih atau buat profil hardware Phone yang diinginkan, lalu pilih Next.

  4. Pilih image sistem x86 atau x86_64 yang menjalankan API Level 27 atau yang lebih baru, lalu pilih Next.

    • Meskipun perangkat ARCore fisik didukung di API Level 24 atau yang lebih baru, dukungan Android Emulator memerlukan API Level 27 atau yang lebih baru.

    • Hanya arsitektur Android Emulator berbasis x86 yang didukung. Arsitektur lain seperti arm64-v8a, armeabi-v7, saat ini tidak didukung.

  5. Pastikan perangkat virtual Anda dikonfigurasi dengan benar:

    • Klik Show Advanced Settings.

    • Pastikan Camera Back disetel ke VirtualScene.

  6. Klik Finish untuk membuat AVD.

Menjalankan aplikasi Anda

Menguji aplikasi ARCore pada perangkat virtual yang didukung AR di emulator. Untuk melakukannya, Anda dapat mengikuti petunjuk Android Studio untuk Menjalankan aplikasi di Android Emulator.

Mengupdate Layanan Google Play untuk AR

Versi Layanan Google Play untuk AR di emulator mungkin sudah usang. Ikuti petunjuk berikut untuk memperbaruinya:

  1. Download Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk terbaru dari halaman rilis GitHub.

  2. Instal APK yang didownload ke setiap AVD yang ingin Anda gunakan:

    Mulai AVD yang diinginkan, lalu tarik APK yang didownload dari folder sistem (yaitu, Downloads) ke emulator yang sedang berjalan, atau menginstalnya menggunakan adb saat perangkat virtual sedang berjalan: 

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

Ulangi proses langkah-langkah ini untuk AVD tambahan yang ingin Anda gunakan.

Mengontrol adegan virtual

Saat aplikasi terhubung ke ARCore, Anda akan melihat overlay yang menjelaskan cara mengontrol kamera dan status bar di bawah jendela emulator.

Gerakkan kamera virtual

Tekan dan tahan Shift untuk mengakses kontrol gerakan kamera. Gunakan kontrol berikut untuk memindahkan kamera:

Tindakan Yang harus dilakukan
Pindahkan ke kiri atau ke kanan Tahan Shift + tekan A atau D
Berpindah ke bawah atau ke atas Tahan Shift + tekan Q atau E
Bergerak ke depan atau belakang Tahan Shift + tekan W atau S
Ubah orientasi perangkat Tahan Shift + gerakkan mouse

Lepaskan Shift untuk kembali ke mode interaktif di emulator.

Gunakan tab Virtual Sensors di Kontrol yang diperluas untuk posisi perangkat yang lebih akurat.

Menambahkan Gambar Augmented ke adegan

Muat gambar ke dalam lingkungan simulasi emulator untuk menguji Gambar Augmented.

Gunakan tab Camera di Extended controls untuk menambahkan atau mengubah Scene images. Ada dua lokasi gambar, satu di dinding dan satu di atas meja.

Untuk melihat lokasi gambar ini dalam adegan, luncurkan emulator, lalu gerakkan kamera ke area ruang makan melalui pintu di belakang posisi awal kamera.

Tips pemecahan masalah

  • Jika aplikasi ARCore diluncurkan dan Anda melihat pesan "Perangkat ini tidak mendukung AR", periksa revisi pada image sistem Anda. Pastikan Anda menggunakan API Level 27 Revisi 4 atau yang lebih baru.

  • Jika aplikasi ARCore Anda gagal membuka kamera saat diluncurkan, pastikan bahwa Camera Back disetel ke VirtualScene, seperti yang dijelaskan dalam langkah-langkah konfigurasi di atas.

  • Jika aplikasi ARCore gagal dibuka dengan pesan error "Gagal membuat sesi AR", periksa log aplikasi. Jika Anda menemukan java.lang.UnsatisfiedLinkError dengan pesan yang berisi /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), mungkin Anda telah menginstal versi apk Layanan Google Play untuk AR yang salah. Buat perangkat virtual baru dan instal versi x86.