Tutorial: Berbagi {i>anchor

Azure Spatial Anchors adalah layanan pengembang lintas platform yang memungkinkan Anda membuat pengalaman realitas campuran menggunakan objek yang mempertahankan lokasinya di seluruh perangkat dari waktu ke waktu.

Dalam tutorial ini, Anda menggunakan Azure Spatial Anchors untuk membuat jangkar selama satu sesi dan kemudian menemukannya di perangkat yang sama atau yang berbeda. {i>Anchor

Dalam tutorial ini, Anda akan mempelajari cara:

• Menerapkan aplikasi web ASP.NET Core di Azure yang dapat Anda gunakan untuk berbagi {i>anchoranchor
• Mengonfigurasikan {i>scene
• Menyebarkan dan menjalankan {i>anchor

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

Sebelum memulai tutorial ini, pastikan Anda telah memenuhi prasyarat berikut:

• Baca gambaran umum Azure Spatial Anchors.
• Lengkapi salah satu dari 5 menit mulai cepat.

  Catatan

  Mulai cepat Android/NDK dan iOS/Swift saat ini tidak menampilkan kemampuan yang dijelaskan dalam tutorial ini.

• Pengetahuan dasar tentang:
  • ARCore jika Anda menggunakan Android.
  • ARKit jika Anda menggunakan iOS.
• Komputer Windows dengan Visual Studio 2019 atau yang lebih baru, serta beban kerja ASP.NET dan pengembangan web.
• .NET Core 3.1 SDK.
• Satu atau beberapa perangkat berikut yang digunakan untuk menyebarkan dan menjalankan aplikasi: HoloLens, HoloLens 2, iOS, atau Android.

Catatan

Anda akan menggunakan Unity dan aplikasi web ASP.NET Core dalam tutorial ini, tetapi pendekatan di sini hanya untuk memberikan contoh tentang cara berbagi pengidentifikasi Azure Spatial Anchors di perangkat lain. Anda dapat menggunakan bahasa lain dan teknologi ujung belakang untuk mencapai tujuan yang sama.

Buat sumber daya Spatial Anchors

Portal

Buka portal Microsoft Azure.

Di panel kiri, pilih Buat sumber daya.

Gunakan kotak pencarian untuk mencari Spatial Anchors.

Pilih Spatial Anchors, lalu pilih Buat.

Pada panel Akun Spatial Anchors, lakukan hal berikut ini:

• Masukkan nama sumber daya unik dengan menggunakan karakter alfanumerik biasa.

• Pilih langganan yang ingin Anda lampirkan sumber dayanya.

• Buat grup sumber daya dengan memilih Buat baru. Beri nama myResourceGroup, lalu pilih OK.

  Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

• Pilih lokasi (kawasan) tempat menempatkan sumber daya.

• Pilih Buat untuk memulai pembuatan sumber daya.

Setelah sumber daya dibuat, portal Azure menunjukkan bahwa penyebaran Anda selesai.

Pilih Buka sumber daya. Anda sekarang dapat melihat properti sumber daya.

Salin nilai ID Akun sumber daya ke editor teks untuk digunakan nanti.

Salin nilai Domain Akun sumber daya juga ke editor teks untuk digunakan nanti.

Di Pengaturan, pilih Kunci akses. Salin nilai Kunci utama, Kunci Akun, ke editor teks untuk digunakan nanti.

Azure CLI

Mulailah dengan mempersiapkan lingkungan Anda untuk Azure CLI:

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

1. Setelah Anda masuk, gunakan perintah az account set untuk memilih langganan mana untuk menyiapkan akun spatial anchors:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Jalankan perintah az group create untuk membuat grup sumber daya, atau gunakan grup sumber daya yang sudah ada:

   az group create --name myResourceGroup --location eastus2
   

   Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

   Anda dapat melihat akun spatial anchors Anda saat ini untuk grup sumber daya dengan menggunakan perintah az spatial-anchors-account list

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Anda juga dapat melihat akun spatial anchors untuk langganan Anda:

   az spatial-anchors-account list
   

3. Jalankan az spatial-anchors-account create untuk membuat akun spatial anchors Anda:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Lihat properti sumber daya dengan menggunakan perintah az spatial-anchors-account show:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Salin nilai ID Akun sumber daya dan nilai Domain Akun sumber daya ke editor teks untuk digunakan nanti.

5. Jalankan perintah az spatial-anchors-account key show untuk mendapatkan kunci utama dan sekunder Anda:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Salin nilai kunci ke editor teks untuk digunakan nanti.

   Jika Anda perlu meregenerasi kunci, gunakan perintah az spatial-anchors-account key renew:

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

Anda dapat menghapus akun dengan menggunakan perintah az spatial-anchors-account delete:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Mulai dengan menyiapkan lingkungan Anda untuk Azure PowerShell:

• Jika Anda memilih untuk menggunakan Azure PowerShell secara lokal:
  • Instal versi terbaru modul Az PowerShell.
  • Sambungkan ke akun Azure Anda menggunakan cmdlet Connect-AzAccount.
• Jika Anda memilih untuk menggunakan Azure Cloud Shell:
  • Lihat Gambaran Umum Azure Cloud Shell untuk informasi selengkapnya.

Penting

Saat modul PowerShell Az.MixedReality dalam pratinjau, Anda harus menginstalnya secara terpisah menggunakan cmdlet Install-Module. Setelah modul PowerShell ini tersedia secara umum, modul ini akan menjadi bagian dari rilis modul Az PowerShell mendatang dan tersedia secara default dari dalam Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Setelah Anda masuk, gunakan perintah cmdlet Set-AzContext untuk memilih langganan mana untuk menyiapkan akun spatial anchors:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Jalankan cmdlet New-AzResourceGroup untuk membuat grup sumber daya, atau gunakan grup sumber daya yang sudah ada:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

   Anda dapat melihat akun spatial anchors Anda saat ini untuk grup sumber daya dengan menggunakan cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Anda juga dapat melihat akun spatial anchors untuk langganan Anda:

   Get-AzSpatialAnchorsAccount
   

3. Jalankan cmdlet New-AzSpatialAnchorsAccount untuk membuat akun spatial anchors Anda:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Lihat properti sumber daya dengan menggunakan cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Salin nilai accountId properti dan nilai accountDomain properti ke editor teks untuk digunakan nanti.

5. Jalankan cmdlet Get-AzSpatialAnchorsAccountKey untuk mendapatkan kunci utama dan sekunder Anda:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Salin nilai kunci ke editor teks untuk digunakan nanti.

   Jika Anda perlu meregenerasi kunci, gunakan cmdlet New-AzSpatialAnchorsAccountKey:

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Anda dapat menghapus akun dengan menggunakan cmdlet Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Unduh proyek sampel + impor SDK

Repositori Sampel Kloning

Kloning repositori sampel dengan menjalankan perintah berikut:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Mengimpor ASA SDK

Ikuti petunjuk di sini untuk mengunduh dan mengimpor paket ASA SDK yang diperlukan untuk platform HoloLens.

Menyebarkan layanan Sharing Anchors

Catatan

Dalam tutorial ini kita akan menggunakan tingkat gratis Azure App Service. Tingkat gratis akan kehabisan waktu setelah 20 menit tidak aktif dan mengatur ulang cache memori.

Visual Studio

Buka Visual Studio, lalu buka proyek di folder Sharing\SharingServiceSample.

Membuka wizard terbitkan

Di Penjelajah Solusi, klik kanan proyek SharingService, lalu pilih Terbitkan....

Panduan Terbitkan dimulai.

1. Pilih Target Azure>Next.
2. Pilih Target Tertentu Azure App Service (Windows)>Berikutnya
3. Masuk ke portal Azure.
4. Pilih "+" hijau untuk Membuat Azure App Service

Pengaturan App Service

Pengaturan	Nilai yang disarankan	Deskripsi
Nama	myASASharingService	Beri nama unik untuk layanan Anda
Nama langganan		Pilih langganan Azure pilihan Anda
Grup Sumber Daya	myResourceGroup atau pilih yang sudah ada	Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.
Paket Hosting	Pilih Baru... dan lihat tabel di bawah ini	Rencana App Service menentukan lokasi, ukuran, dan fitur farm server web yang menghosting aplikasi Anda. Anda dapat menghemat uang saat menghosting beberapa aplikasi dengan mengonfigurasi aplikasi web untuk berbagi satu paket App Service. Paket App Service mendefinisikan: Wilayah (misalnya: Eropa Utara, AS Timur, atau Asia Tenggara) Ukuran instans (kecil, sedang, atau besar) Jumlah skala (1 hingga 20 instans) SKU (Gratis, Bersama, Dasar, Standar, atau Premium)

Pengaturan Paket Hosting

Pengaturan	Nilai yang disarankan	Deskripsi
Paket Hosting	MySharingServicePlan	Beri nama unik untuk paket hosting Anda
Lokasi	US Barat	Pusat data tempat aplikasi web dihosting. Pilih lokasi yang paling dekat dengan lokasi fisik yang akan digunakan aplikasi Anda
Ukuran	Gratis	Tingkat harga yang menentukan fitur hosting

5. Pilih Buat untuk membuat App Service
6. Setelah layanan aplikasi dibuat, pilih di daftar "Instans layanan aplikasi" dan pilih Selesai
7. Pada tab BerbagiLayanan: Terbitkan pilih Terbitkan

Setelah aplikasi web ASP.NET Core diterbitkan ke Azure, Anda dapat membuka https://<your_app_name>.azurewebsites.net atau mengklik tautan di samping Situs: pada tab BerbagiLayanan: Terbitkan . Salin URL ini ke editor teks untuk digunakan nanti.

Visual Studio Code

Anda perlu membuat grup sumber daya dan paket App Service sebelum anda menyebarkan layanan di Visual Studio Code.

Masuk ke Azure

Masuk ke portal Microsoft Azure, lalu masuk ke langganan Azure Anda.

Buat grup sumber daya

Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure seperti aplikasi web, database, dan akun penyimpanan disebarkan dan dikelola. Misalnya, Anda dapat memilih untuk menghapus seluruh grup sumber daya dalam satu langkah sederhana nanti.

Di samping Grup Sumber Daya, pilih Baru.

Beri nama grup sumber daya myResourceGroup, lalu pilih OK.

Membuat Paket App Service

Rencana App Service menentukan lokasi, ukuran, dan fitur farm server web yang menghosting aplikasi Anda. Anda dapat menghemat uang saat menghosting beberapa aplikasi dengan mengonfigurasi aplikasi web untuk berbagi satu paket Azure App Service.

Paket Azure App Service:

• Wilayah (misalnya: Eropa Utara, AS Timur, atau Asia Tenggara)
• Ukuran instans (kecil, sedang, atau besar)
• Jumlah skala (1 hingga 20 instans)
• SKU (Gratis, Bersama, Dasar, Standar, atau Premium)

Di samping Paket Hosting, pilih Baru.

Pada panel Konfigurasi Paket Hosting, gunakan pengaturan ini:

Pengaturan	Nilai yang disarankan	Deskripsi
Paket App Service	MySharingServicePlan	Nama paket App Service
Lokasi	US Barat	Pusat data tempat aplikasi web di-{i>host
Ukuran	Gratis	Tingkat harga yang menentukan fitur hosting

Pilih OK.

Buka Visual Studio Code, lalu buka proyek di folder Sharing\SharingServiceSample.

Untuk menyebarkan layanan berbagi melaluiVisual Studio Code, ikuti instruksi dalam Memublikasikan aplikasi ASP.NET Core ke Azure dengan Visual Studio Code. Mulai dari bagian "Buka dengan Visual Studio Code". Jangan membuat proyek ASP.NET lain seperti yang sudah dijelaskan pada langkah sebelumnya, karena Anda sudah memiliki proyek yang akan disebar dan diterbitkan: SharingServiceSample.

Mengonfigurasi + menyebarkan aplikasi sampel

Unity - HoloLens

Buka Proyek

Di Unity, buka proyek di folder Unity. Unity mungkin meminta Anda tentang perbedaan antara versi dalam proyek dan versi yang diinstal pada mesin Anda. Peringatan ini tidak apa-apa, selama versi Editor Unity Anda lebih baru daripada yang dibuat oleh proyek. Jika versi Anda lebih baru, pilih Lanjutkan. Jika versi Anda lebih lama dari yang dibutuhkan proyek, pilih Keluar, dan tingkatkan Penyunting Unity Anda.

Pengaturan Penyiapan Build

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bagian Platform, pilih Universal Windows Platform. Ubah Perangkat Target ke HoloLens.

Pilih Beralih Platform untuk mengubah platform ke Universal Windows Platform. Unity mungkin meminta Anda untuk menginstal komponen dukungan UWP jika tidak ada.

Tutup jendela Pengaturan Build.

Mengonfigurasi informasi akun

Langkah selanjutnya adalah mengonfigurasi aplikasi untuk menggunakan informasi akun Anda. Anda menyalin nilai Kunci Akun, ID Akun, dan Domain Akun ke editor teks sebelumnya, di bagian "Buat sumber daya Spatial Anchors".

Pada panel Proyek, masuk ke Assets\AzureSpatialAnchors.SDK\Resources.

Pilih SpatialAnchorConfig. Pada panel Inspektur, masukkan Account Key sebagai nilai untuk Kunci Akun Spatial Anchors, Account ID sebagai nilai untuk Id Akun Spatial Anchors, dan Account Domain sebagai nilai Domain Akun Spatial Anchors.

Buka Adegan yang disebut AzureSpatialAnchorsLocalSharedDemo yang ditemukan Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo dengan mengklik dua kali pada panel proyek

Pada panel Proyek, buka Assets\AzureSpatialAnchors.Examples\Resources.

Pilih SpatialAnchorSamplesConfig. Lalu, di panel Inspektur, masukkan URL Sharing Anchors Service (dari aplikasi web ASP.NET Anda penyebaran Azure) sebagai nilai untuk Base Sharing Url. Tambahkan URL dengan /swagger/api/anchors. Tampilannya akan seperti ini: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Simpan adegan dengan memilih File>Simpan.

Ekspor + sebarkan aplikasi HoloLens

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bawah Scene Dalam Build, pastikan semua scene memiliki tanda centang di sampingnya.

Pilih Kompilasi. Dalam kotak dialog, pilih folder tempat untuk mengekspor proyek HoloLens Visual Studio.

Ketika ekspor selesai, folder yang berisi proyek HoloLens yang diekspor akan muncul.

Di folder, klik dua kali HelloAR U3D.sln untuk membuka proyek di Visual Studio.

Ubah Konfigurasi Solusi ke Rilis, ubah Platform Solusi ke x86, dan pilih Perangkat dari opsi target penyebaran.

Jika menggunakan HoloLens 2, gunakan ARM64 sebagai Platform Solusi, bukan x86.

Nyalakan perangkat HoloLens, masuk, dan sambungkan perangkat ke PC menggunakan kabel USB.

Pilih Debug>Mulai penelusuran kesalahan untuk menyebarkan aplikasi Anda dan mulai penelusuran kesalahan.

Menjalankan aplikasi

Di aplikasi, pilih LocalSharedDemo menggunakan panah, lalu tekan tombol Go! untuk menjalankan demo. Ikuti petunjuk di aplikasi untuk menempatkan dan memanggil kembali jangkar.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

Unity - Android

Buka Proyek

Di Unity, buka proyek di folder Unity. Unity mungkin meminta Anda tentang perbedaan antara versi dalam proyek dan versi yang diinstal pada mesin Anda. Peringatan ini tidak apa-apa, selama versi Editor Unity Anda lebih baru daripada yang dibuat oleh proyek. Jika versi Anda lebih baru, pilih Lanjutkan. Jika versi Anda lebih lama dari yang dibutuhkan proyek, pilih Keluar, dan tingkatkan Penyunting Unity Anda.

Pengaturan Penyiapan Build

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bagian Platform, pilih Android, lalu pilih Ganti Platform untuk mengubah platform ke Android. Unity mungkin meminta Anda untuk menginstal komponen dukungan Android jika hilang.

Tutup jendela Pengaturan Build.

Mengonfigurasi informasi akun

Langkah selanjutnya adalah mengonfigurasi aplikasi untuk menggunakan informasi akun Anda. Anda menyalin nilai Kunci Akun, ID Akun, dan Domain Akun ke editor teks sebelumnya, di bagian "Buat sumber daya Spatial Anchors".

Pada panel Proyek, masuk ke Assets\AzureSpatialAnchors.SDK\Resources.

Pilih SpatialAnchorConfig. Pada panel Inspektur, masukkan Account Key sebagai nilai untuk Kunci Akun Spatial Anchors, Account ID sebagai nilai untuk Id Akun Spatial Anchors, dan Account Domain sebagai nilai Domain Akun Spatial Anchors.

Buka Adegan yang disebut AzureSpatialAnchorsLocalSharedDemo yang ditemukan Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo dengan mengklik dua kali pada panel proyek

Pada panel Proyek, buka Assets\AzureSpatialAnchors.Examples\Resources.

Pilih SpatialAnchorSamplesConfig. Lalu, di panel Inspektur, masukkan URL Sharing Anchors Service (dari aplikasi web ASP.NET Anda penyebaran Azure) sebagai nilai untuk Base Sharing Url. Tambahkan URL dengan /swagger/api/anchors. Tampilannya akan seperti ini: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Simpan adegan dengan memilih File>Simpan.

Sebarkan

Masuk ke perangkat Android Anda dan hubungkan ke komputer Anda dengan menggunakan kabel USB.

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bawah Adegan Dalam Build, pastikan bahwa setiap adegan memiliki tanda centang di sampingnya.

Pastikan bahwa Proyek Ekspor tidak memiliki tanda centang. Pilih Build And Run. Anda akan diminta untuk menyimpan file .apk Anda. Anda dapat memilih nama apapun untuk itu.

Menjalankan aplikasi

Di aplikasi, pilih demo LocalShare menggunakan panah, lalu tekan tombol Go! untuk menjalankan demo. Ikuti petunjuk di aplikasi untuk menempatkan dan memanggil kembali jangkar.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

Unity - iOS

Buka Proyek

Di Unity, buka proyek di folder Unity. Unity mungkin meminta Anda tentang perbedaan antara versi dalam proyek dan versi yang diinstal pada mesin Anda. Peringatan ini tidak apa-apa, selama versi Editor Unity Anda lebih baru daripada yang dibuat oleh proyek. Jika versi Anda lebih baru, pilih Lanjutkan. Jika versi Anda lebih lama dari yang dibutuhkan proyek, pilih Keluar, dan tingkatkan Penyunting Unity Anda.

Pengaturan Penyiapan Build

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bagian Platform, pilih iOS.

Pilih Switch Platform untuk mengubah platform ke iOS. Unity mungkin meminta Anda untuk menginstal komponen dukungan iOS jika hilang.

Tutup jendela Pengaturan Build.

Mengonfigurasi informasi akun

Langkah selanjutnya adalah mengonfigurasi aplikasi untuk menggunakan informasi akun Anda. Anda menyalin nilai Kunci Akun, ID Akun, dan Domain Akun ke editor teks sebelumnya, di bagian "Buat sumber daya Spatial Anchors".

Pada panel Proyek, masuk ke Assets\AzureSpatialAnchors.SDK\Resources.

Pilih SpatialAnchorConfig. Pada panel Inspektur, masukkan Account Key sebagai nilai untuk Kunci Akun Spatial Anchors, Account ID sebagai nilai untuk Id Akun Spatial Anchors, dan Account Domain sebagai nilai Domain Akun Spatial Anchors.

Buka Adegan yang disebut AzureSpatialAnchorsLocalSharedDemo yang ditemukan Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo dengan mengklik dua kali pada panel proyek

Pada panel Proyek, buka Assets\AzureSpatialAnchors.Examples\Resources.

Pilih SpatialAnchorSamplesConfig. Lalu, di panel Inspektur, masukkan URL Sharing Anchors Service (dari aplikasi web ASP.NET Anda penyebaran Azure) sebagai nilai untuk Base Sharing Url. Tambahkan URL dengan /swagger/api/anchors. Tampilannya akan seperti ini: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Simpan adegan dengan memilih File>Simpan.

Menyebarkan ke perangkat iOS

Buka Pengaturan Build dengan memilih File>Pengaturan Build.

Di bawah Adegan Dalam Build, pastikan bahwa setiap adegan memiliki tanda centang di sampingnya.

Pilih Kompilasi. Pada panel yang terbuka, pilih folder untuk mengekspor proyek Xcode ke.

Ketika ekspor selesai, folder yang berisi proyek Xcode yang diekspor muncul.

Catatan

Jika jendela muncul dengan pesan yang menanyakan apakah Anda ingin mengganti atau menambahkan, kami sarankan Anda memilih Tambahkan, karena lebih cepat. Ganti akan menghapus semua file dari folder target dan menghasilkan konten baru.

Mengekspor proyek Xcode

Sekarang, Anda dapat membuka proyek Unity-iPhone.xcodeproj Anda di Xcode.

Anda dapat meluncurkan Xcode dan membuka proyek Unity-iPhone.xcodeproj yang diekspor atau meluncurkan proyek di Xcode dengan menjalankan perintah berikut dari lokasi tempat Anda mengekspor proyek:

open ./Unity-iPhone.xcodeproj

Pilih simpul Unity-iPhone akar untuk melihat pengaturan proyek, lalu pilih tab Umum.

Di bawah Info Penyebaran, pastikan bahwa target penyebaran diatur ke iOS 11.0.

Pilih tab Penandatangan & Kemampuan dan pastikan bahwa Penandatanganan dikelola secara otomatis diaktifkan. Jika tidak, aktifkan, lalu reset pengaturan build dengan memilih Aktifkan Otomatis pada panel yang muncul.

Sebarkan aplikasi ke perangkat iOS Anda

Sambungkan perangkat iOS ke Mac dan atur skema aktif ke perangkat iOS Anda.

Pilih Bangun dan jalankan skema saat ini.

Menjalankan aplikasi

Di aplikasi, pilih demo LocalShare menggunakan panah, lalu tekan tombol Go! untuk menjalankan demo. Ikuti petunjuk di aplikasi untuk menempatkan dan memanggil kembali jangkar.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

Di Xcode, hentikan aplikasi dengan memilih Stop.

Android

Sampel Java Android mendukung berbagi di seluruh perangkat.

Di Android Studio, buka file SharedActivity.java dari folder sampel.

Masukkan URL yang Anda salin di langkah sebelumnya (dari aplikasi web ASP.NET Anda penyebaran Azure) sebagai nilai untuk SharingAnchorsServiceUrl dalam file SharedActivity.java.

Ganti index.html dalam URL dengan api/anchors. Tampilannya akan seperti ini: https://<app_name>.azurewebsites.net/api/anchors.

Sebarkan aplikasi ke perangkat Anda.

Setelah aplikasi dimulai, pada panel Pilih Demo, gunakan panah kiri dan kanan untuk memilih opsi LocalShare. Lalu ketuk Mulai!.

Ikuti petunjuknya di aplikasi. Anda dapat memilih Buat & Berbagi Anchor atau Temukan Jangkar Bersama.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

iOS

Sampel Objective-C iOS mendukung berbagi di seluruh perangkat.

Buka file SharedDemoViewController.m di folder sampel.

Masukkan URL yang Anda peroleh di langkah sebelumnya (dari aplikasi web ASP.NET penyebaran Azure Anda) sebagai nilai untuk SharingAnchorsServiceUrl dalam file SharedDemoViewController.m.

Ganti index.html dalam URL dengan api/anchors. Tampilannya akan seperti ini: https://<app_name>.azurewebsites.net/api/anchors.

Sebarkan aplikasi ke perangkat Anda.

Setelah aplikasi dimulai, pilih opsi Ketuk untuk memulai Demo Bersama, lalu ikuti instruksi di aplikasi. Anda dapat memilih Ketuk untuk menemukan Jangkar dengan nomor jangkarnya atau Ketuk untuk membuat Jangkar dan menyimpannya ke layanan.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

Xamarin

Sampel Xamarin Android dan iOS mendukung berbagi di seluruh perangkat.

Buka file AccountDetails.cs dalam folder sampel.

Masukkan URL yang Anda peroleh di langkah sebelumnya (dari aplikasi web ASP.NET penyebaran Azure Anda) sebagai nilai untuk AnchorSharingServiceUrl dalam file AccountDetails.cs.

Ganti index.html dalam URL dengan api/anchors. Tampilannya akan seperti ini: https://<app_name>.azurewebsites.net/api/anchors.

Sebarkan aplikasi ke perangkat Anda.

Setelah aplikasi dimulai, pada panel Pilih Demo, gunakan panah kiri dan kanan untuk memilih opsi LocalShare. Lalu ketuk Mulai!.

Ikuti petunjuknya di aplikasi. Anda dapat memilih Buat & Berbagi Anchor atau Temukan Jangkar Bersama.

Dengan Jangkar Buat & Berbagi Anda dapat membuat jangkar dan menyimpannya ke layanan berbagi Anda. Sebagai hasil, Anda akan mendapatkan kembali pengidentifikasi yang dapat digunakan untuk mengambilnya dari layanan berbagi. Anda kemudian dapat menjalankan skenario kedua, Temukan Jangkar Bersama, dari perangkat Anda atau yang berbeda.

Dengan Cari Jangkar Bersamai, Anda dapat menemukan jangkar bersama sebelumnya dengan memasukkan pengidentifikasi yang disebutkan sebelumnya. Setelah Anda memilih skenario, aplikasi akan memandu Anda dengan instruksi selengkapnya. Misalnya, Anda akan diminta untuk memindahkan perangkat Anda guna mengumpulkan informasi lingkungan. Kemudian, Anda akan menempatkan jangkar di dunia, menunggu untuk menyimpannya, memulai sesi baru, dan kemudian menemukannya.

Membersihkan sumber daya

Di langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak berharap membutuhkan sumber daya ini di masa mendatang, Anda dapat menghapusnya dengan menghapus grup sumber daya.

Pada menu portal Microsoft Azure atau halaman Beranda, pilih Grup sumber daya. Setelah itu, pada halaman Grup sumber daya, pilih myResourceGroup.

Pada halaman myResourceGroup, pastikan sumber daya yang tercantum adalah sumber daya yang ingin Anda hapus.

Pilih Hapus grup sumber daya, ketik myResourceGroup di kotak teks untuk mengonfirmasi, lalu pilih Hapus.

Langkah berikutnya

Dalam tutorial ini, Anda menyebarkan aplikasi web ASP.NET Core di Azure, dan Anda mengonfigurasi serta menyebarkan aplikasi Unity. Anda membuat {i>anchor

Anda dapat meningkatkan aplikasi web ASP.NET Core Anda sehingga aplikasi menggunakan Azure Cosmos DB untuk menjaga penyimpanan pengidentifikasi {i>anchor anchor anchor anchor

Menggunakan Azure Cosmos DB untuk menyimpan jangkar