Sebelumnya

Berikutnya

Latihan - Mulai dengan Azure Spatial Anchors

Selesai

Di unit ini, Anda akan mempelajari langkah-langkah yang diperlukan untuk:

• Memulai dan menghentikan sesi Azure Spatial Anchors.
• Membuat, mengunggah, dan mengunduh spatial anchors di satu perangkat.

Sebagai hasil dari menyelesaikan prasyarat untuk modul pembelajaran ini, Anda harus sudah memiliki proyek Unity yang disiapkan dan dikonfigurasi untuk OpenXR dan MRTK3. Buka proyek tersebut, lalu periksa untuk memastikan bahwa Anda memiliki kemampuan yang tepat yang dipilih:

1. Navigasi ke Edit > Pengaturan Penerbitan Pemutar > Project Pengaturan>.
2. Gulir ke bawah ke bagian Kemampuan dan pilih yang berikut ini jika belum dipilih:

• Persepsi Spasial
• InternetClient
• PrivateNetworkClientServer

Setelah selesai, tutup jendela Project Pengaturan dan lanjutkan dengan langkah berikutnya.

Instal paket Unity bawaan dan impor aset tutorial

1. Pada bilah menu, pilih Manajer Paket Jendela>.

2. Verifikasi bahwa AR Foundation versi 5.0.3 atau versi terbaru diinstal.

   

Mengimpor aset tutorial

1. Tambahkan Azure Spatial Anchors SDK V2.12, atau versi terbaru, ke proyek Anda dengan mengikuti tutorial ini.

2. Unduh dan impor paket kustom Unity berikut dalam urutan ini:

   • MRTK. HoloLens2.Unity.Tutorials.Assets.GettingStarted.3.0.0.unitypackage
   • MRTK. HoloLens2.Unity.Tutorials.Assets.AzureSpatialAnchors.3.0.0.unitypackage

   Catatan

   Mengimpor MRTK3 dan ASA dapat menyebabkan kesalahan ketika versi paket ARFoundation tidak cocok dengan versi ARSubsystems yang diimpor. Hingga ini diperbaiki, Anda dapat menambahkan com.unity.xr.arsubsystems secara manual versi 5.0.2 ke Manajer Paket proyek sebagai solusinya.

   Anda akan mendapatkan peringatan bahwa ARSubsystems telah ditolak, tetapi Anda dapat mengabaikannya. Jika Anda melihat peringatan CS0618 yang mengatakan "WorldAnchor.SetNativeSpatialAnchorPtr(IntPtr)" sudah usang, Anda juga dapat mengabaikannya.

Menyiapkan scene

Pada bagian ini, Anda akan menyiapkan adegan dengan menambahkan beberapa prefab tutorial.

1. Pada panel Proyek, buka MRTK Aset>. Folder Prefabs Tutorials.AzureSpatialAnchors>, lalu seret prefab berikut ke panel Hierarki untuk menambahkannya ke adegan Anda:

   • Prefab ButtonParent
   • Prefab Instruksi
   • Prefab ParentAnchor
   • Ubah nilai Tranform/Posisi ButtonParent menjadi berikut: X = 0,0, Y = 1,6, Z = 0,6
   • Ubah nilai Tranform/Posisi Instruksi menjadi berikut: X = -0,8, Y = 2,0, Z = 2,0
   • Ubah nilai Tranform/Posisi ParentAnchor menjadi berikut: X = -0,3, Y = 1,5, Z = 0,6

   Tip

   Jika Anda menemukan ikon besar di adegan Anda (misalnya, ikon "T" berbingkai besar) yang mengganggu, Anda dapat menyembunyikannya dengan membuka drop-down Gizmos dan menonaktifkan tampilan ikon untuk objek individual.

2. Di jendela Hierarki, pilih MRTK XR Rig> Kamera Offset.

3. Di panel Pemeriksa , gunakan tombol Tambahkan Komponen untuk menambahkan komponen berikut:

   • Ar Anchor Manager (Skrip)
   • DisableDiagnosticsSystem (Skrip)

   Catatan

   Saat Anda menambahkan komponen AR Anchor Manager (Script), komponen XR Origin secara otomatis ditambahkan, karena komponen AR Anchor Manager (Script) memerlukannya.

   

Mengonfigurasi tombol untuk mengoperasikan adegan

Di bagian ini, Anda akan menambahkan skrip ke adegan untuk membuat serangkaian peristiwa tombol yang menunjukkan dasar-dasar bagaimana jangkar lokal dan jangkar spasial berperilaku dalam aplikasi.

1. Di panel Hierarki , perluas objek ButtonParent dan pilih objek turunan pertama, StartAzureSession.

2. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan. Ini memiliki peristiwa On Clicked ().

3. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) peristiwa On Clicked().

4. Pilih menu drop-down Tanpa Fungsi lalu pilih AnchorModuleScript>StartAzureSession (). Fungsi ini akan dijalankan ketika peristiwa dipicu.

   

5. Di panel Hierarki di daftar Turunan ButtonParent , pilih StopAzureSession

6. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan.

7. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) kejadian On Clicked().

8. Pilih menu drop-down Tanpa Fungsi lalu pilih AnchorModuleScript>StopAzureSession ().

   

9. Di panel Hierarki di daftar Anak buttonParent , pilih BuatAzureAnchor.

10. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan.

11. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) kejadian On Clicked().

12. Pilih menu drop-down Tanpa Fungsi dan pilih AnchorModuleScript>CreateAzureAnchor.

13. Pilih objek ParentAnchor lagi, lalu seret ke Pemeriksa dan letakkan di parameter AnchorModuleScript.CreateAzureAnchor.

    

14. Di panel Hierarki di daftar Turunan ButtonParent , pilih RemoveLocalAnchor.

15. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan.

16. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) kejadian On Clicked().

17. Pilih menu drop-down Tanpa Fungsi, lalu pilih AnchorModuleScript>RemoveLocalAnchor.

18. Pilih objek ParentAnchor lagi, lalu seret ke Pemeriksa dan letakkan di parameter AnchorModuleScript.RemoveLocalAnchor.

    

19. Di panel Hierarki di daftar Turunan ButtonParent , pilih TemukanAzureAnchor.

20. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan.

21. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) kejadian On Clicked().

22. Pilih menu drop-down Tanpa Fungsi, lalu pilih AnchorModuleScript>FindAzureAnchor.

    

23. Di panel Hierarki di daftar Anak buttonParent , pilih DeleteAzureAnchor.

24. Di panel Pemeriksa , navigasikan ke komponen Tombol Yang Dapat Ditekan.

25. Di Hierarki, pilih objek ParentAnchor, lalu seret ke Pemeriksa dan letakkan di bidang Tidak Ada (Objek) kejadian On Clicked().

26. Pilih menu drop-down Tanpa Fungsi, lalu pilih AnchorModuleScript>DeleteAzureAnchor.

    

Menyambungkan adegan ke sumber daya Azure

1. Di panel Hierarki , pilih objek ParentAnchor .

2. Di panel Pemeriksa , temukan komponen Spatial Anchor Manager (Script).

3. Konfigurasikan bagian Kredensial dengan kredensial dari akun Azure Spatial Anchors yang Anda buat sebagai bagian dari prasyarat untuk seri tutorial ini:

   • Di bidang ID Akun Spatial Anchors, tempel nilai ID Akun dari akun Azure Spatial Anchors Anda.
   • Di bidang Kunci Akun Spatial Anchors, tempel nilai Kunci Akses primer atau sekunder dari akun Azure Spatial Anchors Anda.
   • Di bidang Domain Akun Spatial Anchors, tempel nilai Domain Akun dari akun Azure Spatial Anchors Anda.

   

Cobalah perilaku dasar Azure Spatial Anchors

Azure Spatial Anchors tidak dapat berjalan di Unity. Untuk menguji fungsionalitas Azure Spatial Anchors, Anda perlu membangun proyek dan menyebarkan aplikasi ke perangkat Anda.

Tip

Untuk pengingat tentang cara membangun dan menyebarkan proyek Unity Anda ke HoloLens 2, lihat artikel Membangun aplikasi Anda ke HoloLens 2 mulai dari bagian (Opsional) Membangun dan menyebarkan aplikasi .

Saat aplikasi berjalan di perangkat Anda, ikuti instruksi di layar yang ditampilkan di panel Instruksi Tutorial Azure Spatial Anchor:

1. Pindahkan kubus ke lokasi yang berbeda.
2. Mulai sesi Azure.
3. Buat jangkar Azure di lokasi kubus.
4. Hentikan sesi Azure.
5. Lepaskan jangkar lokal untuk memungkinkan pengguna memindahkan kubus.
6. Pindahkan kubus ke tempat lain.
7. Mulai sesi Azure.
8. Temukan jangkar Azure untuk menempatkan kubus di lokasi dari langkah 3.
9. Hapus jangkar Azure.
10. Hentikan sesi Azure.

Perhatian

Azure Spatial Anchors menggunakan internet untuk menyimpan dan memuat data jangkar. Pastikan perangkat Anda terhubung ke internet.

Lanjutkan