Hızlı Başlangıç: Azure Spatial Anchors ile Android uygulaması oluşturma

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

Bu hızlı başlangıçta Java veya C++/NDK'de Azure Spatial Anchors Android uygulaması oluşturma hakkında bilgi edinebilirsiniz. Azure Spatial Anchors, zaman içinde farklı cihazlarda konumlarını kalıcı olarak bulunduran nesneleri kullanarak karma gerçeklik deneyimleri oluşturmanıza olanak sağlayan platformlar arası bir geliştirici hizmetidir. Bitirdikten sonra uzamsal sabit noktasını kaydeden ve hatırlayan bir ARCore Android uygulamasına sahip oluruz.

Şunları öğrenirsiniz:

Spatial Anchors hesabı oluşturma
Hesap Spatial Anchors ve hesap anahtarını yapılandırma
Android cihazda 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:

3 Windows 3.4+ ile bir Android Studio veyamacOS makinesi.
- Windows üzerinde çalıştırıyorsanız, Windows ve Git LFS için Git'e de ihtiyacınız vardır.
- macOS üzerinde çalışıyorsanız Git'i HomeBrew aracılığıyla yükleyin. Terminalin tek bir satırına aşağıdaki komutu girin: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" . Ardından ve brew install git brew install git-lfs çalıştırın.
- NDK örneğini oluşturmak için NDK ve CMake 3.6 veya daha yeni bir sürümü SDK Tools yüklemeniz Android Studio.
Geliştirici özellikli ve ARCore özellikli bir Android cihaz.
- Bilgisayarınızın Android cihazınızla iletişim kurması için ek cihaz sürücüleri gerekebilir. Ek bilgi ve yönergeler için buraya bakın.
Uygulamanız ARCore 1.11.0'i hedeflemeli.

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

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

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

Buradan arcore_c_api.h indirin ve içinde yer Android\NDK\libraries\include edin.

Yeni kopyalanan deponun içinde aşağıdaki komutu çalıştırarak altmodülleri başlatabilirsiniz:

git submodule update --init --recursive

Android Studio’yu açın.

Java
NDK

Var olan bir Android Studio projesini aç'ı seçin ve üzerinde bulunan projeyi Android/Java/ seçin.

Hesap tanımlayıcısını ve anahtarı yapılandırma

Sonraki adım, uygulamayı hesap tanımlayıcınızı ve hesap anahtarınızı kullanmak üzere yapılandırmaktır. Kaynak için kaynak ayarlarken bunları bir metin düzenleyicisine Spatial Anchors.

Java
NDK

Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java dosyasını açın.

alanını SpatialAnchorsAccountKey bulun ve yerine Set me hesap anahtarını girin.

alanını SpatialAnchorsAccountId bulun ve yerine Set me hesap tanımlayıcısını girin.

alanını bulun SpatialAnchorsAccountDomain ve yerine hesap etki alanını Set me girin.

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

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

Araç çubuğundan Çalıştır'Android Studio seçin.

Android Studio Ve Çalıştır

Dağıtım Hedefi Seç iletişim kutusunda Android cihazı seçin ve Uygulamayı Android cihazda çalıştırmak için Tamam'ı seçin.

Bir yer noktası yer ve anımsama için uygulamanın yönergelerini izleyin.

Uygulama araç çubuğundan Durdur'Android Studio durdurun.

Android Studio Durdur

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: Spatial Anchors arasında paylaşım