Google berkomitmen untuk memajukan kesetaraan rasial bagi komunitas Kulit Hitam. Lihat bagaimana.

Panduan Memulai untuk Cloud Anchor di iOS

ARCore SDK menyediakan kemampuan jangkar cloud untuk aplikasi iOS Anda, memungkinkan pengguna di perangkat iOS dan Android untuk berbagi pengalaman AR.

Panduan ini menunjukkan kepada Anda cara:

  • Siapkan lingkungan pengembangan Anda untuk bekerja dengan Cloud Anchors
  • Cobalah menghosting dan menyelesaikan jangkar di aplikasi sampel

Persyaratan

Untuk menggunakan Cloud Anchors, Anda memerlukan:

  • Xcode versi 10.1 atau yang lebih baru

  • Cocoapods 1.4.0 atau lambat

  • Perangkat Apple yang kompatibel dengan ARKit yang menjalankan iOS 11.0 atau lebih baru (diperlukan target penerapan iOS 10.0 atau lebih baru)

Menggunakan Jangkar Cloud

Langkah-langkah berikut menggunakan aplikasi sampel Cloud Anchors untuk menunjukkan kepada Anda tugas-tugas penting untuk mengonfigurasi dan membuat aplikasi yang mendukung ARCore Cloud Anchors.

Dapatkan aplikasi sampel Cloud Anchors

  1. Clone atau download Arcore SDK untuk iOS dari GitHub untuk mendapatkan kode aplikasi sampel.

  2. Buka jendela Terminal atau Finder dan arahkan ke folder tempat Anda mengkloning atau mengunduh SDK.

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

Pengaturan sesi

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

Siapkan berbagi ID Cloud Anchor

Aplikasi sampel Cloud Anchors menggunakan Firebase untuk berbagi ID Cloud Anchor antar perangkat. Anda dapat menggunakan solusi berbeda di aplikasi Anda sendiri.

Untuk menyiapkan database Firebase di aplikasi contoh:

  1. Ikuti petunjuk Firebase untuk menambahkan Firebase untuk aplikasi Anda .
  2. Download GoogleService-Info.plist file yang dihasilkan sebagai bagian dari menambahkan Firebase untuk aplikasi Anda.
  3. Aktifkan penyimpanan Firebase untuk sampel:
    • Pergi ke Firebase konsol dan pilih proyek Anda diatur untuk aplikasi sampel.
    • Pilih panel Database.
    • Pada pilihan database Realtime, klik Get Started.
    • Keamanan aturan untuk Realtime menu database terbuka.
      • Untuk tujuan menjalankan sampel, pilih Mulai dalam mode uji.
      • Perhatikan bahwa jika Anda menggunakan Firebase untuk aplikasi yang ingin Anda publikasikan, Anda harus menggunakan aturan keamanan yang lebih ketat.
  4. Dalam Xcode, tambahkan GoogleService-Info.plist file aplikasi Anda, di samping Info.plist .

Tambahkan Kunci API

Untuk menggunakan Cloud Anchors, Anda harus menambahkan kunci API ke aplikasi.

  1. Dapatkan kunci API. Lihat Menyiapkan kunci API di Pusat Google Cloud Platform Konsol Bantuan jika Anda baru untuk bekerja dengan kunci API.

  2. Aktifkan API Arcore Cloud Jangkar untuk proyek Google Cloud Platform Anda.

  3. Di Xcode, tambahkan kunci API Anda ke aplikasi. Untuk melakukan hal ini, tambahkan kunci untuk kode berikut di CloudAnchorManager.m :

    self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                 bundleIdentifier:nil
                                            error:nil];
    

Jalankan pembaruan pod

Kapal-kapal app CloudAnchorExample dengan Podfile dikonfigurasikan dengan versi Arcore SDK dan iOS yang Anda butuhkan. Untuk menginstal dependensi ini:

  1. Buka jendela Terminal dan menjalankan pod update dari folder di mana proyek Xcode ada.
    Ini menghasilkan .xcworkspace file yang akan anda gunakan nanti untuk membangun dan menjalankan aplikasi.

Lihat Tambahkan Arcore SDK untuk aplikasi Anda untuk rincian tentang mengkonfigurasi Podfile di aplikasi Anda sendiri.

  1. Buka .xcworkspace file untuk proyek di Xcode.

    Untuk menghindari membangun kesalahan, pastikan Anda sedang membangun dari .xcworkspace file dan bukan .xcodeproj berkas.

Ubah ID bundel aplikasi

Di Xcode, ubah ID bundel aplikasi sehingga Anda dapat menandatangani aplikasi dengan tim Anda.

Bangun dan jalankan aplikasi

  1. Hubungkan perangkat Anda dan luncurkan aplikasi di Xcode.

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

Coba aplikasi sampel

  1. Membangun dan menjalankan aplikasi sampel dari .xcworkspace berkas untuk memulai itu pada perangkat Anda.

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

  3. Tap HOST untuk masuk ke modus hosting. Kode ruang untuk berbagi jangkar yang dihosting dibuat dan muncul di layar Anda.

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

    • Aplikasi menempatkan objek Android Andy di pesawat dan menempelkan jangkar padanya.
    • Permintaan host dikirim ke layanan ARCore Cloud Anchor. Permintaan host menyertakan data yang mewakili posisi jangkar relatif terhadap fitur visual di dekatnya.
    • Setelah jangkar di-host, ia mendapat ID yang digunakan untuk menyelesaikan jangkar cloud di ruang ini.
  5. Tap RESOLVE dan memasukkan kode ruang untuk akses sebelumnya host Cloud Jangkar untuk ruangan ini, menggunakan yang sama atau perangkat yang berbeda.

    • Permintaan penyelesaian dikirim ke layanan ARCore Cloud Anchor.
    • Permintaan penyelesaian mencakup ID jangkar cloud. Jika ID cocok dengan jangkar yang dihosting dan pelokalan berhasil, server mengembalikan transformasi jangkar di koordinat lokal Anda.
    • Aplikasi contoh menggunakan transformasi untuk menambahkan jangkar ke adegan Anda dan merender objek virtual yang melekat padanya.

Tambahkan ARCore SDK ke aplikasi Anda

Dalam aplikasi Anda sendiri, Anda harus memperbarui Anda Podfile untuk menyertakan Arcore SDK dan iOS didukung versioning. Untuk melakukan ini:

  1. Tambahkan berikut platform dan pod untuk proyek Anda Podfile :

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.12.0'
    
  1. Buka jendela Terminal dan menjalankan pod update dari folder di mana proyek Xcode Anda ada.
    Ini menghasilkan .xcworkspace file yang Anda gunakan untuk membangun dan menjalankan aplikasi.

Langkah selanjutnya