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

Ikhtisar Cloud Anchors untuk Ekstensi ARCore untuk AR Foundation

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

Apa itu Jangkar Awan?

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

Cloud Jangkar serupa dalam perilaku jangkar , dan pedoman dasar untuk jangkar juga berlaku untuk Cloud Jangkar. Lihat Bekerja dengan jangkar untuk meninjau pedoman dasar.

Cloud Anchor berbeda dari anchor karena dihosting di layanan ARCore Cloud Anchor. Hosting ini memungkinkan pengguna untuk berbagi pengalaman di aplikasi yang sama.

Bagaimana cara kerja Cloud Anchor?

Untuk mengaktifkan ini berbagi pengalaman, Arcore menghubungkan ke layanan Arcore Cloud jangkar ke host dan tekad jangkar. 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 upload data untuk jangkar ke layanan Arcore Cloud jangkar, yang mengembalikan ID unik untuk jangkar itu.

  3. Aplikasi mendistribusikan ID unik ke pengguna lain.

  4. Selama menyelesaikan, pengguna dengan ID unik dapat menciptakan anchor yang sama menggunakan layanan Arcore Cloud jangkar.

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

Membangun dan menjadi tuan rumah jangkar

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

Mulai dari ARCore SDK 1.12.0, panggilan host ini menyebabkan ARCore mengunggah data visual terpilih 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 menyarankan agar 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 dimulai untuk memberi waktu pelacakan untuk menstabilkan sebelum mencoba untuk menjadi tuan rumah sebuah jangkar.

  2. Ketika memilih lokasi untuk menjadi tuan rumah jangkar, mencoba untuk menemukan suatu daerah dengan fitur visual yang mudah dibedakan dari satu sama lain - misalnya, sudut dengan fitur visual yang berbeda.

  3. Arahkan kamera perangkat belakang di tengah bunga, yaitu, daerah sekitarnya titik di mana Anda ingin menempatkan jangkar.

  4. Sambil menjaga kamera dilatih di tengah bunga, dan sementara kira-kira menjaga jarak fisik antara perangkat dan pusat perhatian, memindahkan perangkat di sekitar untuk memetakan lingkungan dari sudut pandang yang berbeda dan posisi selama 30 detik. Berjalan-jalan di ruang sambil menjaga kamera perangkat tetap terlatih di pusat perhatian akan memungkinkan menangkap fitur visual dari area yang diminati dari semua sudut, membuat resolusi lebih kuat.

  5. Panggil ARAnchorManager.HostCloudAnchor untuk memulai permintaan hosting.

  6. ARCore mengunggah 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 CloudAnchorState untuk memeriksa status jangkar host (termasuk penanganan error pesan).

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

Jangkar harus di-host.

CloudAnchorState memungkinkan Anda memeriksa status jangkar host (termasuk pesan penanganan error).

Menyelesaikan jangkar yang dihosting sebelumnya

Ketika pengguna lain dalam lingkungan yang sama menunjuk kamera perangkat mereka di daerah di mana Cloud jangkar diselenggarakan, permintaan tekad ( ARAnchorManager.ResolveCloudAnchorId ) menyebabkan layanan Arcore Cloud Jangkar untuk secara berkala membandingkan fitur visual dari adegan terhadap peta fitur 3D yang dibuat, yang digunakan ARCore untuk menunjukkan dengan tepat 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 Anchor secara berurutan. Hingga 20 Cloud Anchor dapat diselesaikan secara bersamaan.

Menggunakan perangkat yang sama atau berbeda dari perangkat hosting, ikuti langkah-langkah ini untuk menyelesaikan jangkar yang dihosting. Tuan rumah dapat mengambil dan berbagi ID dengan menggunakan ARCloudAnchor.cloudReferenceId properti.

  1. Tunggu beberapa detik setelah sesi dimulai untuk memberi waktu pelacakan untuk menstabilkan sebelum mencoba untuk menyelesaikan jangkar.

  2. Di lingkungan yang sama sebagai jangkar host, memindai daerah asli dari bunga, memastikan bahwa:

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

    • Kamera perangkat memiliki jarak yang sama dari jangkar yang dihosting sebagai perangkat yang awalnya menjadi tuan rumah jangkar.

  3. Panggilan ARAnchorManager.ResolveCloudAnchorId dan penggunaan CloudAnchorState untuk memeriksa status permintaan tekad berkala.

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

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

Perangkat harus polling CloudAnchorState Cloud Jangkar diselesaikan sampai melaporkan siap, atau melaporkan kesalahan.

Persyaratan privasi Cloud Anchor

Untuk mematuhi persyaratan privasi kami diperbarui untuk menggunakan Arcore SDK 1.12.0 atau lambat, Anda harus mengungkapkan penggunaan Cloud Jangkar mencolok. Untuk rincian, lihat persyaratan privasi pengguna .

Penyimpanan data dan keterbatasan 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 awal dari 1,20, Cloud Jangkar bisa diselesaikan hanya selama 24 jam setelah mereka menjadi tuan rumah.) Anda dapat memperpanjang masa hidup jangkar setelah itu sudah host menggunakan API Cloud jangkar Manajemen .

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

  • Jangkar 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.

  • Ingat bahwa memulai panggilan host menggunakan pemetaan 30 detik sebelumnya untuk membuat peta fitur 3D. Pastikan antarmuka pengguna aplikasi Anda mempertimbangkan 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 Anchor pada jenis permukaan tertentu.

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

Kebijakan penghentian

Aplikasi dibangun dengan Arcore SDK 1.12.0 atau lebih tinggi ditutupi oleh Cloud jangkar kebijakan penghentian API .

Aplikasi dibangun dengan Arcore SDK 1.11.0 atau lebih rendah tidak dapat host atau tekad Cloud Jangkar karena penggunaan SDK yang lebih tua, usang layanan Arcore Cloud jangkar.

Memulai

Jika Anda baru untuk bekerja dengan jangkar, lihat Bekerja dengan jangkar untuk pengenalan.