Panduan Memulai untuk Android

Untuk mulai menggunakan ARCore dengan Android, Anda dapat menjalankan aplikasi contoh hello_ar_kotlin atau hello_ar_java yang disertakan dengan ARCore SDK. Aplikasi contoh ini menggunakan OpenGL, antarmuka pemrograman untuk merender grafik vektor 2D dan 3D. Aplikasi ini akan menampilkan bidang yang terdeteksi dan memungkinkan pengguna mengetuk bidang untuk menempatkan model 3D.

Menyiapkan lingkungan pengembangan

Membuka project contoh

  1. Di Android Studio, clone repositori GitHub ARCore SDK.

    Ada banyak cara untuk melakukannya:

    • Untuk penginstalan Android Studio yang telah ditetapkan:

      • Dari menu Git, pilih Clone.
      • Di menu drop-down Version control, pilih Git sebagai sistem kontrol versi.
      • Di kolom URL, masukkan URL berikut ke repositori GitHub ARCore:

        https://github.com/google-ar/arcore-android-sdk.git

    • Anda juga dapat membuka Terminal dan memberikan perintah git clone sebagai berikut:

      git clone https://github.com/google-ar/arcore-android-sdk.git
  2. Buka salah satu project contoh sebagai berikut (Anda harus membuka project secara eksplisit untuk mem-build dan menjalankannya).

    • Dari menu File, pilih Open.
    • Di folder arcore-android-sdk/samples, pilih folder hello_ar_kotlin atau hello_ar_java, lalu klik Open.

Menyiapkan perangkat atau emulator

Anda dapat menjalankan aplikasi AR di perangkat yang didukung atau di Android Emulator. Anda harus mengupdate Layanan Google Play untuk AR di emulator sebelum menjalankan aplikasi. Baca Menjalankan Aplikasi AR di Android Emulator untuk mengetahui informasi selengkapnya.

Menjalankan contoh

Pastikan perangkat Android Anda terhubung ke mesin pengembangan, lalu klik Run di Android Studio.

Android Studio membuat project Anda menjadi APK yang dapat di-debug, menginstal APK, lalu menjalankan aplikasi di perangkat. Untuk mengetahui informasi selengkapnya, lihat Mem-build dan Menjalankan Aplikasi.

Anda mungkin akan diminta untuk menginstal atau mengupdate Layanan Google Play untuk AR jika layanan tersebut tidak ada atau sudah tidak berlaku. Pilih CONTINUE untuk menginstalnya dari Google Play Store, atau mengupdatenya secara manual seperti yang dijelaskan dalam Mengupdate Layanan Google Play untuk AR.

Aplikasi hello_ar_java memungkinkan Anda menempatkan pion ARCore tiga dimensi pada platform bidang AR yang terdeteksi. Ini diimplementasikan dengan Android GL SurfaceView, yang digunakan untuk merender pratinjau kamera dan objek AR dasar seperti Pesawat dan Anchor. Contoh framework rendering hello_ar_java dapat ditemukan di com/google/ar/core/examples/java/common/samplerender.

Gunakan Penempatan Instan

Instant Placement API memungkinkan pengguna menempatkan objek AR di layar tanpa harus menunggu ARCore mendeteksi geometri permukaan. Penempatan objek disempurnakan secara real time saat pengguna bergerak lebih jauh di sekitar lingkungan.

Ketuk layar untuk menempatkan objek. Pastikan untuk terus menggerakkan perangkat setelah melihat objek holografis muncul di layar, sehingga ARCore bisa mendapatkan data yang memadai tentang lingkungan sekitar Anda untuk menambatkan objek virtual secara akurat.

Setelah ARCore mendeteksi geometri permukaan dan membuat pelacakan yang dapat dilacak di wilayah tempat objek ditempatkan, pose objek akan otomatis diperbarui untuk akurasi.

Penempatan Instan

Dalam Gambar 1, Penempatan Instan dinonaktifkan dan geometri permukaan tidak ditentukan. Objek yang ditempatkan di lantai di sebelah kanan meja biliar (empat titik biru kecil) muncul terjatuh, posenya tidak ditentukan.

Pada Gambar 2, Penempatan Instan diaktifkan dari menu di bawah ikon roda gigi.

Dalam Gambar 3, dengan mengaktifkan Penempatan Instan, objek baru akan ditempatkan di scene. Panel ini muncul dalam skala abu-abu, bukan berwarna, untuk menunjukkan bahwa elemen tersebut belum dikoreksi untuk pose yang akurat.

Di Gambar 4, objek baru akan berwarna, dan posenya akurat, saat geometri permukaan (dijelaskan oleh garis petak yang dapat dilacak) terdeteksi.

Gunakan Kedalaman

Jika Depth diaktifkan, ARCore akan memperhitungkan geometri dan lokasi objek dalam scene, serta menghitung lokasi objek yang ditempatkan dalam scene terkait dengan objek lain dalam scene. Hal ini memungkinkan objek yang ditempatkan untuk dihalangi oleh objek dalam scene, dan memberikan realisme ke aplikasi Anda.

Penempatan Instan

Di Gambar 1, Depth dinonaktifkan. Sebuah objek ditempatkan di bawah tabel biliar.

Pada Gambar 2, saat perangkat bergerak di sekitar tabel biliar, objek akan tampak mengikuti perangkat, terlepas dari objek dalam scene.

Di Gambar 3, Depth diaktifkan.

Pada Gambar 4, objek sekarang tampak terhalang oleh tabel biliar saat perangkat bergerak di sekitar scene.

Langkah berikutnya