Hızlı başlangıç: Azure uzamsal bağlayıcılarla bir Xamarin Android uygulaması oluşturma

Makale
11/24/2021
Okumak için 6 dakika

Bu hızlı başlangıçta, Azure uzamsal bağlayıcılarıkullanarak Xamarin Ile bir Android uygulamasının nasıl oluşturulacağı ele alınmaktadır. Azure uzamsal bağlantıları, zaman içinde cihazlarda konumlarını sürekli tutan nesneleri kullanarak karma gerçeklik deneyimleri oluşturmanıza olanak sağlayan bir platformlar arası geliştirici hizmetidir. İşiniz bittiğinde, bir uzamsal bağlayıcıyı kaydedip geri çekebilmeniz için bir Android uygulamanız olacaktır.

Şunları öğrenirsiniz:

Uzamsal bağlayıcı hesabı oluşturma
Uzamsal Tutturucuların hesap tanımlayıcısını ve hesap anahtarını yapılandırın
Android cihazında dağıtma ve çalıştırma

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Bu hızlı başlangıcı tamamlamak için aşağıdakileri yaptığınızdan emin olun:

Windows veya macos bilgisayarı:
- Windows kullanıyorsanız:
  - Visual Studio 2019 16.2 +' nin güncel sürümü.
  - Windows Için git.
  - GIT LFS.
- MacOS kullanılıyorsa:
  - Mac için Visual Studio 8.1 +' nin güncel sürümü.
  - MacOS Için git.
  - GIT LFS.
Xamarin. Android ' in en son sürümü, tercih ettiğiniz platformda yüklü ve çalışır. Xamarin. Android Yükleme Kılavuzu için Xamarin. Android yükleme kılavuzlarını inceleyin.
Geliştirici etkin ve korumalı bir Android cihaz.
- Bilgisayarınızın Android cihazından iletişim kurması için ek cihaz sürücüleri gerekebilir. Daha fazla bilgi için burayabakın.
Uygulamanızın ARCore 1,8' i hedeflemesi gerekir.

Uzamsal bağlayıcı kaynağı oluşturma

Azure Portal gidin.

Sol bölmede kaynak oluştur' u seçin.

Uzamsal bağlantıları aramak için arama kutusunu kullanın.

Uzamsal bağlayıcıları seçin ve ardından Oluştur' u seçin.

Uzamsal bağlayıcı hesabı bölmesinde şunları yapın:

Normal alfasayısal karakterleri kullanarak benzersiz bir kaynak adı girin.
Kaynağı iliştirmek istediğiniz aboneliği seçin.
Yeni oluştur seçeneğini belirleyerek bir kaynak grubu oluşturun. Myresourcegroup olarak adlandırın ve ardından Tamam' ı seçin.

Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Kaynağın yerleştirileceği bir konum (bölge) seçin.
Kaynağı oluşturmaya başlamak için Oluştur ' u seçin.

Kaynak oluşturmak için uzamsal bağlayıcı bölmesinin ekran görüntüsü.

Kaynak oluşturulduktan sonra, Azure portal dağıtımınızın tamamlandığını gösterir.

Kaynak dağıtımının tamamlandığını gösteren ekran görüntüsü.

Kaynağa git’i seçin. Artık kaynak özelliklerini görüntüleyebilirsiniz.

Kaynağın hesap kimliği değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Kaynak özellikleri bölmesinin ekran görüntüsü.

Ayrıca, kaynağın hesap etki alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Kaynağın hesap etki alanı değerini gösteren ekran görüntüsü.

Ayarlar altında erişim anahtarı' nı seçin. Birincil anahtar değerini, hesap anahtarını daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Hesap için anahtarlar bölmesinin ekran görüntüsü.

Başlangıç olarak ortamınızı Azure CLI için hazırlayın:

Azure Cloud Shell'Da Bash ortamını kullanın.
Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.
- Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.
- İstendiğinde, ilk kullanımda Azure CLI uzantılarını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
- Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Oturum açtıktan sonra, uzamsal bağlayıcı hesabının ayarlanacağı aboneliği seçmek için az Account set komutunu kullanın:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Bir kaynak grubu oluşturmak için az Group Create komutunu çalıştırın veya var olan bir kaynak grubunu kullanın:
```
az group create --name myResourceGroup --location eastus2
```
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

Az uzamsal-bağlayıcı hesabı listesi komutunu kullanarak bir kaynak grubu için geçerli uzamsal bağlayıcı hesaplarınızı görüntüleyebilirsiniz:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Aboneliğiniz için de uzamsal bağlayıcı hesaplarını görüntüleyebilirsiniz:
```
az spatial-anchors-account list
```

Uzamsal bağlayıcı hesabınızı oluşturmak için az uzamsal-bağlayıcı-hesap oluştur komutunu çalıştırın:

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

Az uzamsal-bağlayıcı-hesap göster komutunu kullanarak kaynak özelliklerini görüntüleyin:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Kaynak hesap kimliği değerini ve kaynak hesabı etki alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Birincil ve ikincil anahtarlarınızı almak için az uzamsal-bağlayıcı-hesap anahtarı göster komutunu çalıştırın:
```
az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Anahtar değerlerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Anahtarları yeniden oluşturmanız gerekiyorsa, az uzamsal-bağlayıcı-hesap anahtar yenileme komutunu kullanın:
```
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
```

Az uzamsal-bağlayıcı-Account Delete komutunu kullanarak bir hesabı silebilirsiniz:

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

Başlangıç olarak ortamınızı Azure PowerShell için hazırlayın:

Yerel olarak kullanmak Azure PowerShell:
- Az PowerShell modülünü yükleyin.
- Bağlan-AzAccount cmdlet'ini kullanarak Azure Bağlan oturum açın.
Şu bilgileri kullanmayı Azure Cloud Shell:
- Daha fazla bilgi için Azure Cloud Shell Genel Bakış'a bakın.

Önemli

Az. MixedReality PowerShell modülü önizlemedeyken, cmdlet 'ini kullanarak ayrı olarak yüklemelisiniz Install-Module . Bu PowerShell modülü genel kullanıma sunulduktan sonra, gelecekteki Az PowerShell modülü sürümlerinin bir parçası haline gelecek ve Azure Cloud Shell içinden varsayılan olarak sağlanacaktır.

Install-Module -Name Az.MixedReality

Oturum açtıktan sonra, uzamsal bağlayıcı hesabının ayarlanacağı aboneliği seçmek için set-AzContext cmdlet 'ini kullanın:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Yeni-AzResourceGroup cmdlet 'ini çalıştırarak bir kaynak grubu oluşturun veya var olan bir kaynak grubunu kullanın:
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

Get-AzSpatialAnchorsAccount cmdlet 'ini kullanarak, bir kaynak grubu için geçerli uzamsal bağlayıcı hesaplarınızı görüntüleyebilirsiniz:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Aboneliğiniz için de uzamsal bağlayıcı hesaplarını görüntüleyebilirsiniz:
```
Get-AzSpatialAnchorsAccount
```

Uzamsal bağlayıcı hesabınızı oluşturmak için New-AzSpatialAnchorsAccount cmdlet 'ini çalıştırın:

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

Get-AzSpatialAnchorsAccount cmdlet 'ini kullanarak kaynak özelliklerini görüntüleyin:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Daha sonra kullanmak üzere AccountID değerini ve accountdomain değerini bir metin düzenleyicisine kopyalayın.

Birincil ve ikincil anahtarlarınızı almak için Get-AzSpatialAnchorsAccountKey cmdlet 'ini çalıştırın:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Anahtar değerlerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Anahtarları yeniden oluşturmanız gerekirse, New-AzSpatialAnchorsAccountKey cmdlet 'ini kullanın:

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

Remove-AzSpatialAnchorsAccount cmdlet 'ini kullanarak bir hesabı silebilirsiniz:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Örnek projeyi açın

Aşağıdaki komutları çalıştırarak örnek depoyu kopyalayın:

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

Xamarin/SampleXamarin.slnVisual Studio açın.

Hesap tanımlayıcıyı ve anahtarı yapılandırın

Bir sonraki adım, uygulamayı hesap tanımlayıcıyı ve hesap anahtarınızı kullanacak şekilde yapılandırmaktır. Uzamsal Tutturucuların kaynağını ayarlarkenbunları bir metin düzenleyicisine kopyaladınız.

Xamarin/SampleXamarin.Common/AccountDetails.cs dosyasını açın.

Alanı bulun SpatialAnchorsAccountKey ve Set me Hesap anahtarıyla değiştirin.

Alanı bulun SpatialAnchorsAccountId ve Set me Hesap tanımlayıcısıyla değiştirin.

Alanı bulun SpatialAnchorsAccountDomain ve Set me hesap etki alanı ile değiştirin.

Uygulamayı Android cihazınıza dağıtma

Android cihazda güç açın, oturum açın ve USB kablosu kullanarak bilgisayara bağlayın.

Başlangıç projesini Samplexamarin. Android olarak ayarlayın, çözüm yapılandırmasını Yayınla değiştirin ve cihaz Seçicisi açılır penceresinde dağıtmak istediğiniz cihazı seçin.

Windows
macOS

Windows ' de proje ve cihazı seçme menüsünü gösteren ekran görüntüsü.

Uygulamanızı dağıtmak ve başlatmak için hata ayıklamayı Başlat ' ı seçin.

Uygulamada, tanıtımı çalıştırmak için temel ' yı seçin ve bir tutturucu yerleştirip geri çekmeniz için yönergeleri izleyin.

Kaynakları temizleme

Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.

Azure portal menüsünde veya giriş sayfasında, kaynak grupları' nı seçin. Ardından, kaynak grupları sayfasında, myresourcegroup öğesini seçin.

Myresourcegroup sayfasında, listelenen kaynakların silmek istedikleriniz olduğundan emin olun.

Kaynak grubunu sil' i seçin, onaylamak için metin kutusuna myresourcegroup yazın ve ardından Sil' i seçin.

Sonraki adımlar

Bu hızlı başlangıçta bir uzamsal bağlayıcı hesabı oluşturdunuz. Daha sonra uzamsal bağlayıcıları kaydetmek ve geri çağırmak için bir uygulama yapılandırmış ve dağıttınız. Farklı cihazlarla uzamsal Tutturucuların paylaşılacağını sağlamak üzere uygulamayı geliştirme hakkında daha fazla bilgi edinmek için sonraki öğreticiye geçin.

Öğretici: cihazlarda uzamsal bağlayıcıları paylaşma