Hızlı başlangıç: Azure uzamsal bağlayıcılarla Unity iOS uygulaması oluşturma

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

Bu hızlı başlangıçta, Azure uzamsal bağlayıcılarınıkullanarak Unity iOS uygulaması oluşturma 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ı kaydedeve geri çekebilmeniz için Unity ile oluşturulmuş bir ARKit iOS uygulamanız olacaktır.

Şunları öğrenirsiniz:

Uzamsal bağlayıcı hesabı oluşturma
Unity derleme ayarlarını hazırlama
Uzamsal Tutturucuların hesap tanımlayıcısını ve hesap anahtarını yapılandırın
Xcode projesini dışa aktarma
İOS 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:

Bir geliştirici, ARKit uyumlu bir iOS cihazını etkinleştirdi.
En son Xcode sürümü yüklü olan bir MacOS makinesi.
Unity yüklemesi. Desteklenen sürümler ve gerekli yetenekler için Unity proje kurulumu sayfasınıziyaret edin.
Git, HomeBrew aracılığıyla yüklendi. Terminalin tek bir satırına şu komutu girin: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" . Ardından, ve öğesini çalıştırın brew install git brew install git-lfs .

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

Unity örnek projesini indir ve aç

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

İOS platformu için gereken ASA SDK paketlerini indirmek ve içeri aktarmak için buradaki yönergeleri izleyin.

Unity 'de, projeyi Unity klasöründe açın. Unity, projedeki sürüm ve makinenizde yüklü olan sürüm arasında bir fark isteyebilir. Bu uyarı, Unity Düzenleyicisi sürümünüz projenin oluşturulduğuna göre daha yeni olduğu sürece sorun oluşur. Sürümünüz daha yeniyse devam' ı seçin. Sürümünüz proje gereksiniminden eskiyse quit' i seçin ve Unity düzenleyicinizi yükseltin.

Unity bölmesinin ekran görüntüsü.

Dosya derleme ayarları ' nı seçerek derleme ayarlarını açın > Build Settings.

Platform bölümünde iOS' u seçin.

Platformu iOS olarak değiştirmek Için platformu Değiştir ' i seçin. Unity, eksik olmaları durumunda iOS destek bileşenlerini yüklemenizi isteyebilir.

Unity derleme ayarları penceresinin ekran görüntüsü.

Derleme ayarları penceresini kapatın.

Hesap bilgilerini yapılandırın

Sonraki adım, uygulamayı hesap bilgilerinizi kullanacak şekilde yapılandırmaktır. Hesap anahtarı, hesap kimliği ve hesap etki alanı değerlerini, daha önce "uzamsal bağlayıcı kaynağı oluşturma" bölümünde yer alan bir metin düzenleyicisine kopyaladınız.

Proje bölmesinde öğesine gidin Assets\AzureSpatialAnchors.SDK\Resources .

SpatialAnchorConfig öğesini seçin. Inspector bölmesinde, uzamsal bağlayıcı hesap Account Key anahtarı Için değer olarak, Account ID uzamsal bağlayıcı hesap kimliği değeri olarak ve Account Domain uzamsal bağlayıcı hesabı etki alanı değeri olarak değerini girin.

Xcode projesini dışa aktarma

Dosya derleme ayarları ' nı seçerek derleme ayarlarını açın > Build Settings.

Yapı' ın altında, tüm sahnelerin yanında onay işareti olduğundan emin olun.

Oluştur' u seçin. Açılan bölmede, Xcode projesinin dışarı aktarılacağı klasörü seçin.

Dışarı aktarma işlemi tamamlandığında dışarı aktarılmış Xcode projesini içeren bir klasör görüntülenir.

Not

Değiştirmek veya eklemek isteyip istemediğinizi soran bir ileti içeren bir pencere görünürse, daha hızlı olduğundan Ekle' yi seçmenizi öneririz. Yalnızca sahneinizdeki varlıkları değiştiriyorsanız Değiştir ' i seçmeniz gerekir. Örneğin, üst/alt ilişkileri ekliyor, kaldırıyor veya değiştiriyor olabilirsiniz veya özellikleri ekleme, kaldırma ya da değiştirme olabilirsiniz. Yalnızca kaynak kodu değişikliği yapıyorsanız, ekleme yeterli olmalıdır.

Xcode projesini açın

Artık Unity-iPhone.xcodeproj projenizi Xcode 'da açabilirsiniz.

Unity-iPhone.xcodeprojProjeyi verdiğiniz konumdan aşağıdaki komutu çalıştırarak Xcode 'u başlatabilir ve içe aktarılmış projeyi açabilir ya da projeyi Xcode 'da başlatabilirsiniz:

open ./Unity-iPhone.xcodeproj

Proje ayarlarını görüntülemek için kök Unity-iPhone düğümünü seçin ve ardından genel sekmesini seçin.

Dağıtım bilgileri altında dağıtım hedefinin iOS 11,0 olarak ayarlandığından emin olun.

İmzalama & özellikleri sekmesini seçin ve imzalamayı otomatik olarak Yönet ' in etkinleştirildiğinden emin olun. Aksi takdirde, etkinleştirin ve ardından açılan bölmedeki Otomatik Etkinleştir ' i seçerek yapı ayarlarını sıfırlayın.

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

İOS cihazını Mac 'e bağlayın ve etkin düzeni iOS cihazınıza ayarlayın.

Cihazı seçmek için iPhone 'Um düğmesinin ekran görüntüsü.

Oluştur ' u seçin ve ardından geçerli düzeni çalıştırın.

"Dağıt ve Çalıştır" ok düğmesinin ekran görüntüsü.

Uygulamada, okları kullanarak Basicdemo ' i seçin ve git ' e basın ! gösteriyi çalıştırmak için düğme. Bir bağlayıcıyı yerleştirmek ve geri çağırmak için yönergeleri izleyin.

Ekran görüntüsü 1 ekran görüntüsü 2 ekran görüntüsü 3

İşiniz bittiğinde, Xcode 'da Durdur ' a basarak uygulamayı durdurun.

Sorun giderme

İşleme sorunları

Uygulamayı çalıştırırken, kamerayı arka plan olarak görmüyorsanız (örneğin, boş, mavi veya diğer dokular görürseniz), muhtemelen varlıkları Unity 'de yeniden içeri aktarmanız gerekir. Uygulamayı durdurun. Unity 'deki üst menüden varlıklar ' ı seçin > tümünü yeniden içeri aktarın. Sonra, uygulamayı yeniden çalıştırın.

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

Nasıl yapılır: Unity projesinde Azure uzamsal bağlayıcılarını yapılandırma