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 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 Ponsel 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.

Menjalankan aplikasi

Uji aplikasi ARCore di perangkat virtual yang mendukung 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 kemungkinan sudah tidak aktual. Ikuti petunjuk berikut untuk memperbaruinya:

  1. Download Google_Play_Services_for_AR_1.46.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 Anda (yaitu, Downloads) ke emulator yang sedang berjalan, atau instal menggunakan adb saat perangkat virtual sedang berjalan: 

    adb install -r Google_Play_Services_for_AR_1.46.0_x86_for_emulator.apk

Ulangi proses langkah-langkah ini untuk 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.

Memindahkan 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
Mengubah orientasi perangkat Tahan Shift + gerakkan mouse

Rilis Shift untuk kembali ke mode interaktif di emulator.

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

Menambahkan Gambar Augmented ke adegan

Muat gambar ke lingkungan simulasi emulator untuk menguji Gambar Augmentasi.

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 Anda 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 apk Layanan Google Play untuk AR yang salah. Buat perangkat virtual baru dan instal versi x86.