Panduan memulai untuk Android NDK

Menyiapkan lingkungan pengembangan

  • Instal Android Studio versi 3.1 atau yang lebih tinggi dengan Android SDK Platform versi 7.0 (API level 24) atau yang lebih tinggi.

  • Siapkan Android Studio untuk pengembangan native dengan menginstal Android Native Development Kit (NDK) dan CMake dengan SDK Manager. Untuk informasi selengkapnya, lihat Mulai Menggunakan NDK.

  • Anda perlu mendapatkan ARCore SDK untuk Android. Anda dapat:

    • Download ARCore SDK untuk Android dan ekstrak file tersebut.

      -or-

    • Clone repositori dengan perintah berikut:

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

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.

Membuka project contoh

Di Android Studio, buka project contoh hello_ar_c di <ARCore SDK Folder>/samples/hello_ar_c.

Project contoh memiliki dependensi build pada versi software tertentu, seperti Gradle dan Android SDK. Jika dependensi yang diperlukan tidak diinstal, Android Studio akan meminta izin Anda untuk mendownload dan menginstalnya di komputer Anda.

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.

Saat Anda memindahkan perangkat, aplikasi akan otomatis mendeteksi permukaan yang rata dan menggambar petak berlian. Ketuk petak untuk menempatkan pion ARCore tiga dimensi di platform.

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. Setelah ARCore mendeteksi pose yang benar di region tempat objek AR ditempatkan, objek akan otomatis diupdate agar menjadi akurat pose.

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.

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