Mulai cepat ini mencakup cara menjalankan aplikasi sampel Azure Spatial Anchors untuk perangkat Android menggunakan Xamarin (C#). 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. Setelah selesai, Anda akan memiliki aplikasi Android yang dapat menyimpan dan memanggil kembali jangkar spasial.
Anda akan mempelajari cara:
Buat akun Spatial Anchors
Konfigurasikan pengidentifikasi akun Spatial Anchors dan kunci akun
Versi terbaru Xamarin.Android yang dipasang dan berjalan di platform pilihan Anda. Untuk panduan penginstalan Xamarin.Android, lihat panduan Penginstalan Xamarin.Android.
Driver perangkat tambahan mungkin diperlukan agar komputer Anda dapat berkomunikasi dengan perangkat Android Anda. Untuk informasi selengkapnya, lihat di sini.
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.
Mulailah dengan mempersiapkan lingkungan Anda untuk Azure CLI:
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.
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
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 key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
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
Setelah Anda masuk, gunakan perintah cmdlet Set-AzContext untuk memilih langganan mana untuk menyiapkan akun spatial anchors:
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:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Buka Xamarin/SampleXamarin.sln di Visual Studio.
Mengonfigurasi pengidentifikasi dan kunci akun
Langkah selanjutnya adalah mengonfigurasi aplikasi untuk menggunakan pengidentifikasi akun dan kunci akun Anda. Anda menyalinnya ke editor teks saat menyiapkan sumber daya Spatial Anchors.
Temukan SpatialAnchorsAccountKey bidang dan ganti Set me dengan kunci akun.
Temukan SpatialAnchorsAccountId bidang dan ganti Set me dengan pengidentifikasi akun.
Temukan bidang SpatialAnchorsAccountDomain dan ganti Set me dengan domain akun.
Menyebarkan aplikasi ke perangkat Android Anda
Nyalakan perangkat Android, masuk, dan sambungkan ke komputer menggunakan kabel USB.
Atur proyek startup ke SampleXamarin.Android, ubah Konfigurasi Solusi ke Rilis, dan pilih perangkat yang ingin Anda sebarkan di daftar drop-down pemilih perangkat.
Pilih Debug>Mulai penelusuran kesalahan untuk menyebarkan dan memulai aplikasi Anda.
Pilih Jalankan>Mulai Tanpa Debugging untuk menyebarkan dan memulai aplikasi Anda.
Di aplikasi, pilih Dasar untuk menjalankan demo dan ikuti instruksi untuk menempatkan dan memanggil kembali jangkar.
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 mulai cepat ini, Anda membuat akun Spatial Anchors. Anda kemudian mengonfigurasi dan menerapkan aplikasi untuk menyimpan dan memanggil kembali spatial anchors. Untuk mempelajari lebih lanjut tentang cara meningkatkan aplikasi sehingga dapat berbagi spatial anchors dengan perangkat lain, lanjutkan ke tutorial berikutnya.
