Menjalankan Aplikasi AR di Android Emulator

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

Menyiapkan lingkungan pengembangan

Persyaratan software:

Mendapatkan Android Studio dan SDK Tools 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 dan pilih Next.

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

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

  5. Pastikan perangkat virtual Anda dikonfigurasi dengan benar:

    • Klik Show Advanced Settings.

    • Pastikan Camera Back ditetapkan ke VirtualScene.

  6. Klik Finish untuk membuat AVD Anda.

Menjalankan aplikasi

Menguji aplikasi ARCore pada perangkat virtual yang didukung AR di emulator. Yang akan dilakukan Anda dapat mengikuti petunjuk Android Studio untuk Jalankan aplikasi di Android Emulator.

Mengupdate Layanan Google Play untuk AR

Versi Layanan Google Play untuk AR pada emulator kemungkinan keluar dari tanggal. Ikuti petunjuk berikut untuk memperbaruinya:

  1. Download Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk terbaru dari GitHub rilis.

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

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

    adb install -r Google_Play_Services_for_AR_1.45.0_x86_for_emulator.apk

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

Mengontrol suasana virtual

Saat aplikasi Anda 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 menggerakkan kamera:

Tindakan Yang harus dilakukan
Geser ke kiri atau kanan Tahan Shift + tekan A atau D
Geser 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 pemosisian perangkat yang lebih akurat.

Menambahkan Gambar Augmented ke adegan

Muat gambar ke 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 lagi di atas meja.

Untuk melihat lokasi image ini di adegan, luncurkan emulator, lalu pindahkan kamera ke area ruang makan melalui pintu di belakang layar mulai menyala posisi Anda.

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 Revisi 4 atau yang lebih baru API Level 27.

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

  • Jika aplikasi ARCore gagal dibuka dengan pesan error "Failed to create AR sesi" memeriksa 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), Anda mungkin telah menginstal versi yang salah apk Layanan Google Play untuk AR. Buat perangkat virtual baru dan instal yaitu versi x86.