Mengonfigurasi Azure Spatial Anchors dalam proyek Unity

  • Artikel

Panduan ini akan menunjukkan kepada Anda cara memulai dengan Azure Spatial Anchors SDK dalam proyek Unity Anda.

Persyaratan proyek

Saat memulai proyek Unity baru, Anda dapat memilih antara Unity XR Plug-in Framework dan Legacy Built-in XR.

XR Plug-in Framework hanya didukung pada ASA SDK versi 2.9.0 atau versi lebih baru. Untuk menargetkan XR Plug-in Framework, gunakan Unity 2020.3 (LTS), dan AR Foundation 4.1.7 dengan paket berikut, tergantung pada platform Anda:

  • Plugin OpenXR Mixed Reality: 1.1.2
  • Plugin Windows XR: 4.5.0
  • Plugin ARCore XR: 4.1.7
  • Plugin ARKit XR: 4.1.7

Mengonfigurasi proyek

Sebelum menyertakan Azure Spatial Anchors SDK dalam proyek Unity Anda, pastikan untuk memasang paket yang diperlukan melalui Unity Package Manager.

Pilih versi ASA

Untuk menentukan versi SDK ASA mana yang akan digunakan dalam proyek Unity Anda, silakan pilih versi Unity Anda di bawah ini.

Dukungan untuk Unity 2020 ditambahkan dengan ASA SDK 2.9.0. Sebaiknya gunakan ASA SDK terbaru untuk pengembangan Unity 2020.

Penting

Jika menggunakan plugin Mixed Reality OpenXR, ASA SDK 2.10.0 adalah versi minimum yang didukung. Jika menggunakan Windows XR 4.5.1 atau yang lebih baru, ASA SDK 2.11.0 adalah versi minimum yang didukung.

Unduh paket ASA

Langkah selanjutnya adalah pengunduhan paket Azure Spatial Anchors untuk Unity.

Untuk menggunakan Azure Spatial Anchors di Unity, Anda perlu mengunduh paket inti (com.microsoft.azure.spatial-anchors-sdk.core) dan paket khusus platform untuk setiap platform yang Anda rencanakan untuk didukung.

Platform Nama paket yang diperlukan
HoloLens com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

Catatan

Alat Fitur Mixed Reality saat ini hanya mendukung Windows.

Lanjutkan ke langkah berikutnya. Anda akan menggunakan Alat Fitur Mixed Reality pada langkah selanjutnya.

Impor paket ASA

Langkah ini mengharuskan Alat Fitur Mixed Reality diunduh dan tersedia.

  1. Ikuti dokumentasi Alat Fitur Mixed Reality untuk menyiapkan alat dan mempelajari cara menggunakannya.
  2. Menginstal
    1. Azure Spatial Anchors SDK Core
    2. Azure Spatial Anchors SDK untuk <platform Anda>
    3. Plugin OpenXR Mixed Reality jika menggunakan OpenXR - terletak di bawah Dukungan Platform

Konfigurasi Ekstra

Jika Anda mengembangkan untuk HoloLens atau Android, ikuti langkah-langkah penyiapan tambahan di bawah ini

Mengonfigurasi pengaturan XR proyek Unity Anda

Saat mengembangkan aplikasi MixedReality di HoloLens, Anda perlu mengatur konfigurasi XR di Unity. Untuk informasi selengkapnya, lihat Menyiapkan konfigurasi XR Anda - Mixed Reality | Microsoft Docs dan Memilih versi Unity dan plugin XR - Mixed Reality | Microsoft Docs.

Azure Spatial Anchors SDK versi 2.9.0 atau yang lebih lama hanya memberikan dukungan untuk plugin Windows XR (com.unity.xr.windowsmr), sehingga paket windows Azure Spatial Anchors memiliki dependensi eksplisit pada Plugin Windows XR.

Azure Spatial Anchors SDK versi 2.10.0 atau yang lebih baru memberikan dukungan untuk plugin Mixed Reality OpenXR (com.microsoft.mixedreality.openxr) dan plugin com.unity.xr.windowsmrWindows XR . Anda perlu menyertakan com.microsoft.mixedreality.openxr paket atau com.unity.xr.windowsmr paket dalam proyek Anda tergantung pada pilihan Anda.

Mengonfigurasi kemampuan proyek Unity

Pastikan Anda mengaktifkan kemampuan berikut dalam proyek Unity:

  • Persepsi Spasial
  • InternetClient
  • PrivateNetworkClientServer

Peringatan

Tidak mengaktifkan kemampuan PrivateNetworkClientServer dapat menyebabkan kegagalan untuk mengirim kueri ke jangkar ketika perangkat menggunakan jaringan yang dikonfigurasi agar menjadi privat.