Android'i hedefleyen Unity (AR Foundation) uygulamanız için Geospatial API'yi etkinleştirin

Uygulamanızın ayarlarını, Geospatial API'yi kullanabilecek şekilde yapılandırın.

Ön koşullar

Devam etmeden önce temel AR kavramlarını ve ARCore oturumunu nasıl yapılandıracağınızı anladığınızdan emin olun.

Geospatial API hakkında daha fazla bilgi için Geospatial API'ye giriş bölümüne bakın.

ARCore ile geliştirme konusunda yeniyseniz yazılım ve donanım gereksinimleri, ön koşullar ve kullandığınız platformlara özgü diğer bilgiler hakkında bilgi için Başlarken bölümüne bakın.

ARCore Geospatial API'yi kullanmak için projenizin AR Foundation'ı ve ARCore Extensions for AR Foundation'ı desteklemesi gerekir.

ARCore API'yi etkinleştir

Uygulamanızda Görsel Konumlandırma Sistemi'ni (VPS) kullanmadan önce, yeni veya mevcut bir Google Cloud projesinde ARCore API'yi etkinleştirmeniz gerekir. Bu hizmet, Coğrafi çapaların barındırılması, depolanması ve çözümlenmesinden sorumludur.

Anahtarsız yetkilendirme tercih edilir ancak API anahtarı yetkilendirmesi de desteklenir.

Gerekli kitaplıkları uygulamanıza ekleme

Uygulamanızı ARCore API'yi çağırmak üzere yetkilendirdikten sonra, uygulamanızda Coğrafi özellikleri etkinleştirmek için kitaplıklar eklemeniz gerekir.

  1. Düzenle > Proje Ayarları > XR Eklenti Yönetimi > ARCore Uzantıları'na gidin.
  2. İsteğe Bağlı Özellikler bölümünde, Coğrafi konum'u seçin.

Oturum yapılandırmasında Coğrafi özellikleri etkinleştir

Uygulamanızda Coğrafi işlevler etkinleştirildikten sonra, ARCore API'si ile iletişim kurabilmesi için uygulamanızın AR oturum yapılandırmasında Coğrafi özellikleri etkinleştirin:

  1. Proje Assets klasörünün ARCoreExtensionsConfig komut dosyası oluşturma amaçlı bir nesne içerdiğinden emin olun. Oluşturmak için Öğeler bölmesini sağ tıklayın ve Oluştur > XR > ARCore Extensions Yapılandırması'nı seçin.

  2. Assets klasörünüzde ARCoreExtensionsConfig komut dosyası oluşturma nesnesini seçin ve Geospatial Mode'u (Coğrafi Mekansal Mod) Enabled (Etkin) olarak ayarlayın.

  3. ARCoreExtensionsConfig yapılandırmasını kullanmak için ARCore Extensions oyun nesnesini yapılandırın. Hiyerarşi bölmesinde, ARCore Extensions'ı ayarlarken oluşturduğunuz ARCore Extensions oyun nesnesini bulun ve Assets klasörünüzdeki ARCoreExtensionsConfig komut dosyası oluşturma nesnesine ARCore Extensions Config alanını bağlayın.

Kullanıcıdan cihaz verilerinin kullanımına izin vermesini iste

ARCore Geospatial API'yi kullanan uygulamalar, kullanıcıya, cihazındaki verilerin kullanımına onay ve izin verme istemi sunmalıdır. Daha fazla bilgi için Kullanıcı gizlilik şartları bölümüne bakın.

Cihaz uyumluluğunu kontrol etme

ARCore'u destekleyen bazı cihazlar Geospatial API'yi de desteklemez. Kullanıcının cihazının uyumluluğunu kontrol etmek için AREarthManager.IsGeospatialModeSupported() numaralı telefonu arayın. Bu işlem FeatureSupported.Unsupported sonucunu döndürürse oturumu yapılandırmaya çalışmayın.

Çalışma zamanında kullanıcıdan konum izni iste

ARCore Uzantıları, ARCoreExtensions.Update() ürününde Coğrafi mod etkinleştirildiğinde uygun konum izinlerini otomatik olarak ister. Kullanıcı tam konum izni vermezse oturum devam ettirilemez ve "izin verilmedi" hatası oluşur. Bu bir sonlandırma hatasıdır ve izin isteğinin tekrar tetiklenmesi için yeniden başlatma gerektirir.

Cihazın mevcut konumundaki Coğrafi kullanılabilirliği kontrol edin

Geospatial API, Coğrafi konumu belirlemek için VPS ve GPS kombinasyonunu kullandığından, cihaz konumunu belirleyebildiği sürece API kullanılabilir. API, iç mekan alanları ve yoğun kentsel ortamlar gibi GPS doğruluğunun düşük olduğu alanlarda yüksek doğruluklu pozlar oluşturmak için VPS'nin kapsamını kullanır. VPS'nin normal koşullarda yaklaşık 5 metre konum doğruluğu ve 5 derece dönme doğruluğu sağlaması beklenebilir. Belirli bir konumun VPS kapsamında olup olmadığını belirlemek için AREarthManager.CheckVpsAvailability() özelliğini kullanın.

Geospatial API, VPS kapsamında olmayan bölgelerde de kullanılabilir. Yukarıdan engellerin çok az olduğu veya hiç olmadığı açık ortamlarda GPS, yüksek doğrulukta poz oluşturmak için yeterli olabilir.

Sırada ne var?