Panduan Memulai untuk Cloud Anchors di iOS

ARCore Cloud Anchor API, atau layanan ARCore Cloud Anchor, menyediakan kemampuan anchor cloud untuk aplikasi iOS Anda, sehingga pengguna di perangkat iOS dan Android dapat berbagi pengalaman AR.

Panduan ini menunjukkan cara:

  • Menyiapkan lingkungan pengembangan Anda agar berfungsi dengan Cloud Anchors
  • Mencoba menghosting dan menyelesaikan anchor di aplikasi contoh

Prasyarat

  • Xcode versi 13.0 atau yang lebih baru
  • Cocoapods 1.4.0 atau yang lebih baru jika menggunakan Cocoapods
  • Perangkat Apple yang kompatibel dengan ARKit yang menjalankan iOS 12.0 atau yang lebih baru (target deployment iOS 12.0 atau yang lebih baru diperlukan)

Menggunakan Cloud Anchors

Langkah-langkah berikut menggunakan aplikasi contoh Cloud Anchors untuk menunjukkan tugas penting untuk mengonfigurasi dan membangun aplikasi yang mendukung ARCore Cloud Anchors.

Mendapatkan aplikasi contoh Cloud Anchors

  1. Lakukan clone atau download ARCore SDK untuk iOS dari GitHub guna mendapatkan kode aplikasi contoh.

  2. Buka jendela Terminal atau Finder, lalu buka folder tempat Anda meng-clone atau mendownload SDK.

  3. Anda dapat menemukan kode aplikasi contoh di
    /arcore-ios-sdk-master/Examples/CloudAnchorExample.

    Kode aplikasi contoh anchor cloud persisten ada di
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

Penyiapan sesi

Aplikasi contoh melakukan tugas penting berikut sebagai bagian dari penyiapan sesi:

Menyiapkan berbagi ID Cloud Anchor

Aplikasi contoh Cloud Anchors menggunakan Firebase untuk membagikan ID Cloud Anchor antarperangkat. Anda dapat menggunakan solusi berbeda di aplikasi Anda sendiri.

Untuk menyiapkan database Firebase di aplikasi contoh:

  1. Ikuti petunjuk Firebase untuk menambahkan Firebase ke aplikasi Anda.
  2. Download file GoogleService-Info.plist yang dihasilkan sebagai bagian dari penambahan Firebase ke aplikasi Anda.
  3. Aktifkan penyimpanan Firebase untuk contoh:
    • Buka Firebase console, lalu pilih project yang Anda siapkan untuk aplikasi contoh.
    • Pilih panel Database.
    • Pada opsi Realtime Database, klik Get Started.
    • Menu Security rules for Realtime Database akan terbuka.
      • Untuk menjalankan contoh, pilih Start in test mode.
      • Perlu diperhatikan bahwa jika Anda menggunakan Firebase untuk aplikasi yang ingin dipublikasikan, Anda harus menggunakan aturan keamanan yang lebih ketat.
  4. Di Xcode, tambahkan file GoogleService-Info.plist ke aplikasi Anda, di samping Info.plist.

Menyiapkan ARCore API

Untuk menggunakan Cloud Anchors, Anda harus menyiapkan ARCore API terlebih dahulu untuk aplikasi Anda.

Jalankan update pod

Aplikasi CloudAnchorExample dilengkapi dengan Podfile yang telah dikonfigurasi sebelumnya dengan ARCore SDK dan versi iOS yang akan Anda perlukan. Untuk menginstal dependensi ini:

  1. Buka jendela Terminal dan jalankan pod update dari folder tempat project Xcode berada.
    Tindakan ini akan menghasilkan file .xcworkspace yang nantinya akan Anda gunakan untuk membangun dan menjalankan aplikasi.

Lihat Menambahkan ARCore SDK ke aplikasi untuk mengetahui detail cara mengonfigurasi Podfile di aplikasi Anda sendiri.

  1. Buka file .xcworkspace untuk project di Xcode.

    Untuk menghindari error build, pastikan Anda mem-build dari file .xcworkspace, bukan file .xcodeproj.

Mengubah ID app bundle

Di Xcode, ubah ID paket aplikasi agar Anda dapat menandatangani aplikasi dengan tim.

Membuat dan menjalankan aplikasi

  1. Hubungkan perangkat Anda dan luncurkan aplikasi di Xcode.

  2. (Opsional) Jika Anda membangun dan menjalankan aplikasi contoh, lihat bagian berikut untuk mengetahui detail tentang penggunaan aplikasi untuk menghosting dan menyelesaikan Cloud Anchors.

Mencoba aplikasi contoh

  1. Build dan jalankan aplikasi contoh dari file .xcworkspace untuk meluncurkannya di perangkat Anda.

  2. Jika diminta, berikan izin kamera ke aplikasi. ARKit kemudian mulai mendeteksi bidang di depan kamera Anda.

  3. Ketuk HOST untuk masuk ke mode hosting. Kode kamar untuk berbagi anchor yang dihosting akan dibuat dan muncul di layar Anda.

  4. Ketuk pesawat untuk mulai menghosting cloud anchor di sana.

    • Aplikasi menempatkan objek Android Andy pada bidang dan memasang anchor ke objek tersebut.
    • Permintaan host dikirim ke endpoint cloud ARCore API. Permintaan host menyertakan data yang mewakili posisi anchor relatif terhadap fitur visual di dekatnya.
    • Setelah dihosting, anchor akan mendapatkan ID yang digunakan untuk me-resolve anchor cloud di ruang ini.
  5. Ketuk RESOLVE dan masukkan kode kamar untuk mengakses Cloud Anchors yang sebelumnya dihosting untuk ruangan ini, menggunakan perangkat yang sama atau berbeda.

    • Permintaan penyelesaian dikirim ke endpoint cloud ARCore API.
    • Permintaan penyelesaian menyertakan ID anchor cloud. Jika ID cocok dengan anchor yang dihosting dan pelokalan berhasil, server akan menampilkan transformasi anchor dalam koordinat lokal Anda.
    • Aplikasi contoh menggunakan transformasi untuk menambahkan anchor ke scene dan merender objek virtual yang terpasang padanya.

Menambahkan ARCore SDK ke aplikasi

Di aplikasi Anda sendiri, Anda harus mengupdate Podfile untuk menyertakan ARCore SDK dan pembuatan versi iOS yang didukung. Untuk melakukannya:

  1. Tambahkan platform dan pod berikut ke Podfile project Anda:

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.41.0'
    
  1. Buka jendela Terminal dan jalankan pod update dari folder tempat project Xcode Anda berada.
    Tindakan ini akan menghasilkan file .xcworkspace yang Anda gunakan untuk membangun dan menjalankan aplikasi.

Anchor cloud persisten

Seperti yang dijelaskan dalam artikel Menghosting Cloud Anchor dengan persistensi, Anda dapat memberikan masa aktif pada cloud anchor hingga 365 hari. Kode contoh untuk menggunakan anchor cloud persisten tersedia di direktori /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample di ARCore SDK untuk iOS dari GitHub.

Langkah berikutnya