Unity projesinde Azure Spatial Anchors'i yapılandırma

Makale
10/26/2023

Bu kılavuzda Unity projenizde Azure Spatial Anchors SDK'sını kullanmaya nasıl başlanacağı gösterilir.

Proje gereksinimleri

Yeni bir Unity projesi başlattığınızda Unity XR Eklenti Çerçevesi ile Eski Yerleşik XR arasında seçim yapabilirsiniz.

XR Eklenti Çerçevesi
Eski Yerleşik XR

XR Eklenti Çerçevesi yalnızca ASA SDK 2.9.0 veya sonraki bir sürümde desteklenir. XR Eklenti Çerçevesi'ni hedeflemek için, platformunuza bağlı olarak unity 2020.3 (LTS) ve AR Foundation 4.1.7'yi aşağıdaki paketlerle birlikte kullanın:

Karma Gerçeklik OpenXR Eklentisi: 1.1.2
Windows XR Eklentisi: 4.5.0
ARCore XR Eklentisi: 4.1.7
ARKit XR Eklentisi: 4.1.7

Projeyi yapılandırma

Unity projenize Azure Spatial Anchors SDK'sını eklemeden önce Unity Paket Yöneticisi aracılığıyla gerekli paketleri yüklediğinizden emin olun.

ASA sürümünü seçin

Unity projenizde hangi ASA SDK sürümünü kullanacağınızı belirlemek için lütfen aşağıdan Unity sürümünüzü seçin.

Unity 2020
Unity 2019

ASA SDK 2.9.0 ile Unity 2020 desteği eklendi. Unity 2020 geliştirmesi için en son ASA SDK'sını kullanmanızı öneririz.

Önemli

Karma Gerçeklik OpenXR eklentisini kullanıyorsanız ASA SDK 2.10.0 desteklenen en düşük sürümdür. Windows XR 4.5.1 veya üzerini kullanıyorsanız, ASA SDK 2.11.0 desteklenen en düşük sürümdür.

ASA paketlerini indirme

Sonraki adım Unity için Azure Spatial Anchors paketlerini indirmektir.

Unity'de Azure Spatial Anchors'ı kullanmak için, desteklemeyi planladığınız her platform için hem çekirdek paketi (com.microsoft.azure.spatial-anchors-sdk.core) hem de platforma özgü bir paketi indirmeniz gerekir.

Platform	Gerekli paket adları
HoloLens	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>`
Android	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.android@<version_number>`
iOS	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>`

Dekont

Karma Gerçeklik Özellik Aracı şu anda yalnızca Windows'un desteklemektedir.

Sonraki adıma geçin. Sonraki bir adımda Karma Gerçeklik Özellik Aracı'nı kullanacaksınız.

Aşağıdaki adımlarda NPM'nin yüklü ve kullanılabilir olduğu varsayılır.

öğesini geçerli klasöre indirmek istediğiniz Azure Spatial Anchors sürümüyle değiştirerek <version_number> aşağıdaki komutu çalıştırın:

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Dekont

Azure Spatial Anchors paketinin kullanılabilir sürümlerini listelemek için aşağıdakileri çalıştırın:

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

Azure Spatial Anchors çekirdek paketi, komutu çalıştırdığınız klasöre indirilir. Desteklemeyi planladığınız her platform için paketi indirmek için bu adımı yineleyin .

ASA paketlerini içeri aktarma

Bu adım, Karma Gerçeklik Özellik Aracı'nın indirilip kullanılabilir olmasını gerektirir.

Aracı ayarlamak ve nasıl kullanacağınızı öğrenmek için Karma Gerçeklik Özellik Aracı belgelerini izleyin.
Yüklemek
1. Azure Spatial Anchors SDK Core
2. Platformlarınız için <Azure Spatial Anchors SDK'sı >
3. OpenXR kullanıyorsanız OpenXR Eklenti Karma Gerçeklik - Platform Desteği altında bulunur

Ek Yapılandırmalar

HoloLens veya Android için geliştiriyorsanız lütfen aşağıdaki ek kurulum adımlarını izleyin

HoloLens
Android

Unity projesi XR ayarlarınızı yapılandırma

HoloLens'te MixedReality uygulamaları geliştirirken Unity'de XR yapılandırmasını ayarlamanız gerekir. Daha fazla bilgi için bkz. XR yapılandırmanızı ayarlama - Karma Gerçeklik | Microsoft Docs ve Unity sürümü ve XR eklentisi seçme - Karma Gerçeklik | Microsoft Docs.

Azure Spatial Anchors SDK'sı 2.9.0 veya önceki sürümleri yalnızca Windows XR eklentisi (com.unity.xr.windowsmr ) için destek sağlar, bu nedenle Azure Spatial Anchors windows paketinin Windows XR Eklentisi'ne açık bir bağımlılığı vardır.

Azure Spatial Anchors SDK 2.10.0 veya sonraki sürümleri hem Karma Gerçeklik OpenXR eklentisi (com.microsoft.mixedreality.openxr) hem de Windows XR eklentisi com.unity.xr.windowsmriçin destek sağlar. Seçiminize bağlı olarak paketi veya com.unity.xr.windowsmr paketi projenize eklemeniz com.microsoft.mixedreality.openxr gerekir.

Unity projenizin özelliklerini yapılandırma

Unity projenizde aşağıdaki özellikleri etkinleştirdiğinizden emin olun:

SpatialPerception
InternetClient
PrivateNetworkClientServer

Uyarı

PrivateNetworkClientServer özelliğinin etkinleştirilmemesi, cihaz özel olarak yapılandırılmış bir ağ kullanırken bağlantıları sorgulama hatasına neden olabilir.

mainTemplate.gradle dosyasını yapılandırma

Project Ayarlar> Player'ı Düzenle'ye >gidin.
Player Ayarlar için Denetçi Paneli'nde Android simgesini seçin.
Derleme bölümünün altında, konumunda özel bir gradle şablonu oluşturmak için Özel Ana Gradle Şablonu Assets\Plugins\Android\mainTemplate.gradleonay kutusunu işaretleyin.
Dosyanızı mainTemplate.gradle bir metin düzenleyicisinde açın.

dependencies bölümüne aşağıdaki bağımlılıkları yapıştırın:

implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')

Her şey tamamlandığında bölümünüz dependencies aşağıdakine benzer olmalıdır:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

Sonraki adımlar

Nasıl Yapılır: Unity'de yer işaretleri oluşturma ve bulma

Aracılığıyla paylaş