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

  • Makale

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 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.

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.

ASA paketlerini içeri aktarma

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

  1. Aracı ayarlamak ve nasıl kullanacağınızı öğrenmek için Karma Gerçeklik Özellik Aracı belgelerini izleyin.
  2. 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

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.