Örnek uygulamayı çalıştırma: iOS - Unity (C#)

Bu hızlı başlangıçta Unity (C#) kullanarak iOS cihazları için Azure Spatial Anchors örnek uygulamasını çalıştırma işlemi açıklanmaktadır. Azure Spatial Anchors, zaman içinde cihazlarda konumlarını kalıcı hale getiren nesneleri kullanarak karma gerçeklik deneyimleri oluşturmanıza olanak tanıyan platformlar arası bir geliştirici hizmetidir. İşiniz bittiğinde, uzamsal bir yer işareti kaydedebilen ve geri çağırabilen Unity ile oluşturulmuş bir ARKit iOS uygulamanız olacak.

Nasıl yapılacağını öğrenin:

• Spatial Anchors hesabı oluşturma
• Unity derleme ayarlarını hazırlama
• Spatial Anchors hesap tanımlayıcısını ve hesap anahtarını yapılandırma
• Xcode projesini dışarı aktarma
• iOS cihazında dağıtma ve çalıştırma

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

Önkoşullar

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

• Geliştirici etkin ARKit uyumlu iOS cihazı.
• Xcode'un en son sürümünün yüklü olduğu bir macOS makinesi.
• Unity yüklemesi. Desteklenen sürümler ve gerekli özellikler için Unity projesi kurulum sayfasını ziyaret edin.
• HomeBrew aracılığıyla yüklenen Git. 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-lfskomutunu çalıştırınbrew install git.

Spatial Anchors kaynağı oluşturma

Portal

Azure portalına gidin.

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

Spatial Anchors'ı aramak için arama kutusunu kullanın.

Uzamsal Tutturucular'ı ve ardından Oluştur'u seçin.

Spatial Anchors Hesabı bölmesinde aşağıdakileri yapın:

• Normal alfasayısal karakterleri kullanarak benzersiz bir kaynak adı girin.

• Kaynağı eklemek istediğiniz aboneliği seçin.

• Yeni oluştur'u seçerek bir kaynak grubu oluşturun. MyResourceGroup olarak adlandırın ve tamam'ı seçin.

  Kaynak grubu, web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği mantıksal bir kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

• Kaynağın yerleştirildiği konumu (bölgeyi) seçin.

• Kaynağı oluşturmaya başlamak için Oluştur'u seçin.

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

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.

Ayrıca kaynağın Hesap Etki Alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Ayarlar altında Erişim Anahtarı'yı seçin. Birincil anahtar değeri olan Hesap Anahtarı'nı daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

Azure CLI

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

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • 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. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısı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.

1. Oturum açtığınızda, uzamsal tutturucu 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
   

2. Az group create komutunu çalıştırarak bir kaynak grubu oluşturun veya mevcut 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 mantıksal bir kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.

   Az spatial-anchors-account list komutunu kullanarak bir kaynak grubu için geçerli uzamsal tutturucu hesaplarınızı görüntüleyebilirsiniz:

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

   Aboneliğiniz için uzamsal tutturucu hesaplarını da görüntüleyebilirsiniz:

   az spatial-anchors-account list
   

3. Spatial anchors hesabınızı oluşturmak için az spatial-anchors-account create komutunu çalıştırın:

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

4. az spatial-anchors-account show 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 Hesap Etki Alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

5. Birincil ve ikincil anahtarlarınızı almak için az spatial-anchors-account key show 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 spatial-anchors-account key renew 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 spatial-anchors-account delete komutunu kullanarak bir hesabı silebilirsiniz :

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

Azure PowerShell

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

• Azure PowerShell'i yerel olarak kullanmayı seçerseniz:
  • Az PowerShell modülünün en son sürümünü yükleyin.
  • Bağlan-AzAccount cmdlet'ini kullanarak Azure hesabınıza Bağlan.
• Azure Cloud Shell'i kullanmayı seçerseniz:
  • Daha fazla bilgi için bkz . Azure Cloud Shell'e genel bakış.

Önemli

Az.MixedReality PowerShell modülü önizleme aşamasındayken, cmdlet'ini Install-Module kullanarak bunu ayrı olarak yüklemeniz gerekir. 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

1. Oturum açtığınızda, uzamsal tutturucu hesabının ayarlanacağı aboneliği seçmek için Set-AzContext cmdlet'ini kullanın:

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

2. New-AzResourceGroup cmdlet'ini çalıştırarak bir kaynak grubu oluşturun veya mevcut 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 mantıksal bir 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 tutturucu hesaplarınızı görüntüleyebilirsiniz:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Aboneliğiniz için uzamsal tutturucu hesaplarını da görüntüleyebilirsiniz:

   Get-AzSpatialAnchorsAccount
   

3. Uzamsal tutturucular hesabınızı oluşturmak için New-AzSpatialAnchorsAccount cmdlet'ini çalıştırın:

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

4. Get-AzSpatialAnchorsAccount cmdlet'ini kullanarak kaynak özelliklerini görüntüleyin:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   accountId değerini ve accountDomain özelliğini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.

5. 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 gerekiyorsa 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 indirme ve SDK'yı içeri aktarma

Kopya Örnekleri Deposu

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

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

ASA SDK'sı içeri aktarma

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

Unity'yi yapılandırma

Unity'de projeyi Unity klasöründe açın. Unity, projedeki sürümle makinenizde yüklü olan sürüm arasında bir fark olup olmadığını size sorabilir. Unity Editor sürümünüz projenin oluşturulduğu sürümden daha yeni olduğu sürece bu uyarı sorun olmaz. Sürümünüz daha yeniyse Devam'ı seçin. Sürümünüz projenin ihtiyaç duyduğu sürümden daha eskiyse Çık'ı seçin ve Unity Düzenleyicinizi yükseltin.

Dosya>Derleme Ayarlar'yi seçerek Derleme Ayarlar'yi açın.

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

Platformu iOS olarak değiştirmek için Platform Değiştir'i seçin. Unity, eksikse iOS destek bileşenlerini yüklemenizi isteyebilir.

Derleme Ayarlar penceresini kapatın.

Hesap bilgilerini yapılandırma

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 "Spatial Anchors kaynağı oluşturma" bölümünde bir metin düzenleyicisine kopyalamıştınız.

Proje bölmesinde öğesine Assets\AzureSpatialAnchors.SDK\Resourcesgidin.

SpatialAnchorConfig'i seçin. Denetçi bölmesinde, Spatial Anchors Hesap Anahtarı değeri olarak değerini, Account ID Spatial Anchors Hesap Kimliği değeri olarak ve Account Domain Spatial Anchors Hesap Etki Alanı değeri olarak değerini girinAccount Key.

Xcode projesini dışarı aktarma

Dosya>Derleme Ayarlar'yi seçerek Derleme Ayarlar'yi açın.

Derlemedeki Sahneler'in altında tüm sahnelerin yanında onay işareti olduğundan emin olun.

Oluştur'a tıklayın. Açılan bölmede, Xcode projesini dışarı aktarmak için bir klasör seçin.

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

Dekont

Değiştirmek mi yoksa eklemek mi istediğinizi soran bir ileti içeren bir pencere görüntülenirse, daha hızlı olduğundan Ekle'yi seçmenizi öneririz. Değiştir seçeneği hedef klasörden tüm dosyaları kaldırır ve yeni içerik oluşturur.

Xcode projesini açma

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

Xcode'ı başlatabilir ve dışarı aktarılan Unity-iPhone.xcodeproj projeyi açabilir veya projeyi dışarı aktardığınız konumdan aşağıdaki komutu çalıştırarak projeyi Xcode'da başlatabilirsiniz:

open ./Unity-iPhone.xcodeproj

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

Dağıtım Bilgileri'nin altında, dağıtım hedefinin iOS 11.0 olarak ayarlandığından emin olun.

İmzalama ve Özellikler sekmesini seçin ve İmzalamayı otomatik olarak yönet'in etkinleştirildiğinden emin olun. Değilse, etkinleştirin ve ardından görüntülenen bölmede Otomatiki Etkinleştir'i seçerek derleme ayarlarını sıfırlayın.

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

iOS cihazını Mac'e Bağlan ve etkin düzeni iOS cihazınıza ayarlayın.

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

Uygulamada, okları kullanarak BasicDemo'yu seçin, ardından demoyu çalıştırmak için Git! düğmesine basın. Yer işareti yerleştirmek ve geri çağırmak için yönergeleri izleyin.

İş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üyorsanız) unity'deki varlıkları yeniden içeri aktarmanız gerekebilir. Uygulamayı durdurun. Unity'nin üst menüsünde Varlıklar -> Tümünü yeniden içeri aktar'ı seçin. Ardından 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ünden veya Giriş sayfasında Kaynak grupları'nı seçin. Ardından Kaynak grupları sayfasında myResourceGroup öğesini seçin.

myResourceGroup sayfasında, silmek istediğiniz kaynakların listelenmiş kaynaklar olduğundan emin olun.

Kaynak grubunu sil'i seçin, onaylamak için metin kutusuna myResourceGroup yazın ve sil'i seçin.

Sonraki adımlar

Bu hızlı başlangıçta bir Spatial Anchors hesabı oluşturdunuz. Ardından uzamsal tutturucuları kaydetmek ve geri çağırmak için bir uygulama yapılandırıp dağıttınız. Uzamsal bağlantıları diğer cihazlarla paylaşabilmek için uygulamayı geliştirme hakkında daha fazla bilgi edinmek için sonraki öğreticiye geçin.

Öğretici: Spatial Anchors'i cihazlar arasında paylaşma

Nasıl yapılır: Unity projesinde Azure Spatial Anchors'ı yapılandırma