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

Ringkasan Cloud Anchors untuk iOS

Gunakan Cloud Anchors untuk membuat pengalaman AR multipemain atau kolaboratif yang dapat dibagikan oleh pengguna Android dan iOS.

Buat dan skalakan pengalaman AR untuk semua orang

ARCore SDK untuk iOS berinteraksi dengan ARKit untuk menyediakan kemampuan Cloud Anchor, memungkinkan Anda berbagi jangkar antara perangkat iOS dan Android di lingkungan yang sama.

Mulai versi 1.12 dari ARCore SDK untuk iOS, Anda dapat membuat aplikasi ARKit yang bekerja dengan perangkat yang kompatibel dengan ARKit.

Apa itu Cloud Anchor?

Menggunakan Cloud Anchors, aplikasi Anda memungkinkan pengguna menambahkan objek virtual ke adegan AR. Beberapa pengguna kemudian dapat melihat dan berinteraksi dengan objek ini secara bersamaan dari posisi berbeda dalam ruang fisik bersama.

Cloud Anchors memiliki perilaku dan fungsi yang mirip dengan anchor , tetapi berbeda karena mereka dihosting di layanan ARCore Cloud Anchor. Hosting ini memungkinkan pengguna untuk berbagi pengalaman.

Bagaimana cara kerja Cloud Anchors?

Untuk mengaktifkan pengalaman bersama ini, ARCore terhubung ke layanan ARCore Cloud Anchor untuk menghosting dan menyelesaikan anchor. Ini membutuhkan koneksi Internet yang berfungsi.

Hosting dan penyelesaian melibatkan langkah-langkah ini pada tingkat tinggi:

  1. Pengguna membuat jangkar lokal di lingkungan mereka.

  2. Selama hosting , ARCore mengupload data untuk jangkar ke layanan ARCore Cloud Anchor, yang mengembalikan ID unik untuk jangkar tersebut.

  3. Aplikasi mendistribusikan ID unik ke pengguna lain.

  4. Selama penyelesaian , pengguna dengan ID unik dapat membuat ulang jangkar yang sama menggunakan layanan ARCore Cloud Anchor.

Untuk menciptakan pengalaman pengguna yang baik dengan Cloud Anchors, penting untuk memahami proses hosting secara mendetail, sehingga Anda dapat mengakomodasi desain aplikasi Anda untuk membantu pengguna menjadi sukses.

Membangun dan menampung jangkar

Untuk membangun dan menjadi tuan rumah sebuah jangkar, ARCore menggunakan peta fitur 3D dari ruang yang mengelilingi jangkar (pusat perhatian). Untuk mendapatkan peta fitur ini, kamera belakang perangkat harus memetakan lingkungan di dalam dan di sekitar pusat perhatian dari berbagai sudut pandang dan posisi dalam 30 detik sebelum panggilan host ( hostCloudAnchor:error: .

Dimulai pada ARCore SDK 1.12.0, panggilan host ini menyebabkan ARCore mengunggah data visual pilihan dari 30 detik terakhir dari kamera perangkat ke layanan ARCore Cloud Anchor, yang memproses data visual untuk membuat peta fitur 3D dan mengembalikan Cloud Anchor INDO.

Pembuatan peta fitur 3D yang tepat sangat penting untuk pengalaman pengguna yang luar biasa. Jika tidak, kualitas pemetaan mungkin terbatas, membuat penyelesaian lebih sulit. Untuk meningkatkan kualitas peta, kami merekomendasikan bahwa antarmuka pengguna secara eksplisit menginstruksikan pengguna untuk memetakan sebanyak mungkin lingkungan di sekitar pusat perhatian, dengan menggerakkan perangkat di sekitar jangkar lokal dari sudut pandang dan posisi yang berbeda.

Untuk menghosting Cloud Anchor:

  1. Tunggu beberapa detik setelah sesi mulai memberikan waktu pelacakan untuk stabil sebelum mencoba menjadi tuan rumah jangkar.

  2. Saat memilih lokasi untuk menampung jangkar, coba temukan area dengan fitur visual yang mudah dibedakan satu sama lain - misalnya, sudut dengan fitur visual yang berbeda.

  3. Arahkan kamera perangkat belakang ke pusat perhatian , yaitu area di sekitar titik tempat Anda ingin memasang jangkar.

  4. Sambil menjaga agar kamera tetap terlatih di pusat perhatian, dan sambil secara kasar menjaga jarak fisik antara perangkat dan pusat perhatian, gerakkan perangkat untuk memetakan lingkungan dari berbagai sudut pandang dan posisi hingga 30 detik . Berjalan-jalan di ruang sambil menjaga agar kamera perangkat tetap terlatih di pusat perhatian akan memungkinkan menangkap fitur visual area yang diminati dari semua sudut, membuat penyelesaian lebih kuat.

  5. Panggil hostCloudAnchor:error: untuk memulai permintaan hosting.

  6. ARCore mengupload data visual, pose perangkat, dan pose jangkar melalui ARCore Cloud Anchor API.

  7. Layanan ARCore Cloud Anchor membuat peta fitur 3D ruang, dan mengembalikan ID Cloud Anchor unik untuk jangkar ke perangkat.

  8. Gunakan anchor.cloudState untuk memeriksa status jangkar yang dihosting (termasuk pesan penanganan kesalahan).

Layanan ARCore Cloud Anchor membuat peta fitur 3D ruang, dan mengembalikan ID Cloud Anchor unik ke perangkat.

Jangkar harus dihosting.

anchor.cloudState memungkinkan Anda memeriksa status jangkar yang dihosting (termasuk pesan penanganan kesalahan).

Menyelesaikan jangkar yang dihosting sebelumnya

Ketika pengguna lain di lingkungan yang sama mengarahkan kamera perangkat mereka ke area tempat Cloud Anchor dihosting, permintaan penyelesaian ( resolveCloudAnchorWithIdentifier:error: :) menyebabkan layanan ARCore Cloud Anchor secara berkala membandingkan fitur visual dari tempat kejadian dengan peta fitur 3D yang dibuat, yang digunakan ARCore untuk menunjukkan posisi dan orientasi pengguna relatif terhadap Cloud Anchor. Inilah sebabnya mengapa penting untuk menggunakan 30 detik sebelum permintaan hosting untuk memetakan sebanyak mungkin lingkungan di sekitar pusat perhatian.

Anda dapat memulai penyelesaian untuk beberapa Cloud Anchors secara berurutan. Hingga 20 Cloud Anchors dapat diselesaikan secara bersamaan.

Menggunakan perangkat yang sama atau berbeda dari perangkat hosting, ikuti langkah-langkah berikut untuk menyelesaikan jangkar yang dihosting.

  1. Tunggu beberapa detik setelah sesi mulai memberikan waktu pelacakan untuk stabil sebelum mencoba untuk menyelesaikan jangkar.

  2. Di lingkungan yang sama dengan jangkar yang dihosting, pindai area minat asli , pastikan bahwa:

    • Kamera perangkat memiliki garis pandang yang jelas ke area yang dipetakan

    • Kamera perangkat memiliki jarak yang sama dari jangkar yang dihosting dengan perangkat yang awalnya menampung jangkar.

  3. Panggil resolveCloudAnchorWithIdentifier:error: dan gunakan anchor.cloudState untuk memeriksa status permintaan penyelesaian secara berkala .

    Jika Anda ingin membatalkan permintaan Anda, panggil removeAnchor .

  4. ARCore terus-menerus melakukan polling ARCore Cloud Anchor API, mengirimkan data visual ke layanan ARCore Cloud Anchor.

  5. Layanan ARCore Cloud Anchor membandingkan fitur visual dari tempat kejadian dengan peta fitur 3D yang telah dibuat. Ketika menemukan kecocokan, layanan mengembalikan pose Cloud Anchor .

Cloud Anchor harus diselesaikan.

anchor.cloudState memungkinkan Anda memeriksa status jangkar yang dihosting (termasuk pesan penanganan kesalahan). Setelah Anda selesai dengan Cloud Anchor, panggil removeAnchor .

Persyaratan privasi Cloud Anchor

Untuk mematuhi persyaratan privasi kami yang diperbarui untuk menggunakan ARCore SDK 1.12.0 atau yang lebih baru, Anda harus mengungkapkan penggunaan Cloud Anchors secara jelas. Untuk detailnya, lihat Persyaratan privasi pengguna .

Penyimpanan data dan batasan akses

Cloud Anchors memiliki penyimpanan data dan batasan akses berikut:

  • Di ARCore 1.20 dan yang lebih baru, Cloud Anchors dapat diselesaikan selama 365 hari setelah dihosting. (Dalam versi ARCore yang lebih awal dari 1.20, Cloud Anchors hanya dapat diselesaikan selama 24 jam setelah mereka dihosting.) Anda dapat memperpanjang masa pakai jangkar setelah itu dihosting menggunakan Cloud Anchor Management API .

  • Data visual yang diunggah ke cloud saat menghosting jangkar dibuang dalam waktu dua puluh empat jam.

  • Penanda diselesaikan di server terhadap peta fitur 3D.

  • Data visual yang diunggah sebelumnya tidak pernah dikirim ke perangkat pengguna.

Praktik terbaik untuk pengalaman pengguna yang baik

Praktik terbaik berikut membantu menciptakan pengalaman pengguna Cloud Anchors yang baik.

  • Ingatlah bahwa memulai panggilan host menggunakan pemetaan 30 detik sebelumnya untuk membuat peta fitur 3D. Pastikan antarmuka pengguna aplikasi Anda memperhitungkan hal ini.

  • Pertimbangkan untuk membuat tindakan atau fitur yang menyenangkan atau dapat berguna bagi pengguna (atau keduanya) saat pengguna bergerak di sekitar pusat minat, dan itu juga menyelesaikan tugas membuat peta fitur 3D yang tepat.

  • Hindari menghosting atau menyelesaikan Cloud Anchors pada jenis permukaan tertentu.

    • Untuk hasil terbaik, pengguna harus menghindari permukaan atau permukaan reflektif tanpa fitur visual, seperti dinding putih yang kosong dan halus.
  • Pastikan pencahayaan di dalam ruangan cukup.

  • Teruskan ARFrame ke GARSession Anda sebelum Anda mencoba menjadi host atau menyelesaikan jangkar.

Kebijakan penghentian

Aplikasi yang dibuat dengan ARCore SDK 1.12.0 atau lebih tinggi tercakup dalam kebijakan penghentian Cloud Anchor API .

Aplikasi yang dibuat dengan ARCore SDK 1.11.0 atau yang lebih rendah tidak dapat menghosting atau menyelesaikan Cloud Anchors karena penggunaan SDK atas layanan ARCore Cloud Anchor yang lebih lama dan tidak digunakan lagi.

Memulai

Untuk mulai bekerja dengan ARCore SDK untuk iOS, lihat: