AR Foundation uygulamanızda AR'yi etkinleştirme (yalnızca Android)

Yeni veya mevcut uygulamanızda artırılmış gerçeklik özelliklerini kullanmak için AR'yi etkinleştirin.

Uygulamanızı AR Zorunlu veya AR İsteğe Bağlı olacak şekilde yapılandırın

Ayrı ayrı cihazlarda yer tasarrufu sağlamak amacıyla tüm AR özellikleri, Play Store tarafından ayrı olarak güncellenen AR için Google Play Hizmetleri adlı bir uygulamada depolanır. AR özelliklerini kullanan Android uygulamaları, ARCore SDK'sını kullanarak AR için Google Play Hizmetleri ile iletişim kurar. AR özelliklerini destekleyen bir uygulama iki şekilde yapılandırılabilir: AR Gerekli ve AR İsteğe Bağlı. Bu tanımlama, uygulamanın AR için Google Play Hizmetleri uygulamasıyla nasıl etkileşimde bulunduğunu belirler.

AR Gerekli uygulamalar, ARCore olmadan çalışamaz. AR için Google Play Hizmetleri'nin yüklü olduğu ve ARCore destekli cihaz gereklidir.

  • Google Play Store, yalnızca ARCore'u destekleyen cihazlarda AR gerektiren uygulamaları kullanıma sunar.
  • Kullanıcılar AR için gerekli bir uygulama yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihazlarına otomatik olarak yükler. Ancak, AR için Google Play Hizmetleri'nin eski olması veya manuel olarak kaldırılması durumunda uygulamanızın yine de ek çalışma zamanı kontrolleri gerçekleştirmesi gerekir.

AR İsteğe Bağlı uygulamalar, mevcut işlevleri iyileştirmek için ARCore'u kullanır. Bu uygulamada, yalnızca AR için Google Play Hizmetleri'nin yüklü olduğu ve ARCore destekli cihazlarda etkinleştirilen isteğe bağlı AR özellikleri bulunur.

  • AR destekli uygulamalar, ARCore'u desteklemeyen cihazlara yüklenebilir ve bu cihazlarda çalıştırılabilir.
  • Kullanıcılar AR için isteğe bağlı bir uygulama yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihaza otomatik olarak yüklemez.
Artırılmış gerçeklik (AR) gerekiyorArtırılmış gerçeklik (AR) isteğe bağlı
Artırılmış gerçeklik (AR) özelliğinin kullanımı Uygulamanızın temel işlevini yerine getirmesi için ARCore'u kullanmanız gerekiyor. ARCore, uygulamanızın işlevselliğini artırır. Uygulamanız, ARCore desteği olmadan çalışabilir.
Play Store görünürlüğü Uygulamanız yalnızca ARCore'u destekleyen cihazlarda Play Store'da listelenir. Uygulamanız normal giriş prosedürlerine uyuyor.
AR için Google Play Hizmetleri yükleme yöntemi Play Store, uygulamanızla birlikte AR için Google Play Hizmetleri'ni yükler. Uygulamanızda ARSession.Install() eş yordamı ARCore'u indirip yükleyin.
Android minSdkVersion gereksinimleri Android 7.0 (API Düzeyi 24) Android 4.4 (API Düzeyi 19) olsa da tüm AR işlevlerini çalıştırmak için en az Android 7.0 (API Düzeyi 24) gerekir.
ARCore desteğini ve yükleme durumunu kontrol etmek için ARSession.state kullanılmalıdır
Kullanılmalı ARSession.Install() eş yordamı (AR için Google Play Hizmetleri'ni yükleyin)

Uygulamanızı artırılmış gerçeklik (AR) zorunlu hale getirin

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore adresine gidiş rotasını izle. Requirement, varsayılan olarak Required değerine ayarlıdır.

  2. Edit > Project Settings > Player simgesini tıklayın, Android'in yüklü olduğu sekmeyi seçin simgesini tıklayın.

  3. Other Settings > Identification altında bir 24 veya daha yüksek bir değer olan Minimum API Level.

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit adresine gidiş rotasını izle. Requirement, varsayılan olarak Required değerine ayarlıdır.

  2. Edit > Project Settings > Player simgesini tıklayın, iOS yüklü sekmeyi seçin simgesini tıklayın.

  3. Other Settings > Configuration altında, Uygulamanız için Target minimum iOS Version.

Uygulamanızı artırılmış gerçeklik (AR) isteğe bağlı hale getirin

Android

  1. Edit > Project Settings > XR Plug-in Management > ARCore adresine gidiş rotasını izle.

  2. Requirement açılır menüsünden Optional öğesini seçin değerini girin.

  3. Edit > Project Settings > Player simgesini tıklayın, Android'in yüklü olduğu sekmeyi seçin simgesini tıklayın.

  4. Other Settings > Identification altında bir 24 veya daha yüksek bir değer olan Minimum API Level.

iOS

  1. Edit > Project Settings > XR Plug-in Management > ARKit adresine gidiş rotasını izle.

  2. Requirement açılır menüsünden Optional öğesini seçin kullanarak uygulamanızı AR İsteğe bağlı olarak ayarlayabilirsiniz.

  3. Edit > Project Settings > Player simgesini tıklayın, iOS yüklü sekmeyi seçin simgesini tıklayın.

  4. Other Settings > Configuration altında, Uygulamanız için Target minimum iOS Version.

Çalışma zamanı kontrolleri gerçekleştir

AR için Google Play Hizmetleri'nin yüklü olup olmadığını kontrol etme

Hem artırılmış gerçeklik (AR) hem de artırılmış gerçeklik (AR) isteğe bağlı uygulamalar ARSession.Install() eş yordamı .

Artırılmış gerçeklik (AR) gerektiren uygulamalar, çalışma zamanı sırasında otomatik olarak hedef cihazın şu özelliklere sahip olduğundan emin olun:

  • ARCore'u destekler
  • Google Play Services for AR yüklenmiş olmalıdır (yüklü değilse) (muhtemelen kullanıcı tarafından kaldırıldığı için) veya sürüm çok eskiyse kullanıcıdan uygulamayı yüklemesini veya güncellemesini isteyecektir.
  • Güncel ARCore cihaz profili verilerine sahip olmalıdır. Uygulamanız güncel değilse yeni veriler indirecektir.

Bu varsayılan kontrolleri devre dışı bırakmak için ARSession.attemptUpdate parametresini false olarak ayarlayın. Uygulamanız şu koşulları yine de karşılaması gerekir:

Koşul İşlem
Cihaz, ARCore'u desteklemiyor. Artırılmış gerçeklik (AR) ile ilgili işlevleri gizler.
Cihaz ARCore'u destekliyor ancak Google Play Services for AR ve/veya ARCore cihaz profili verileri yüklü değil veya güncel değil. Kullanıcıdan Google Play Services for AR uygulamasını yüklemesini ya da güncellemesini ister ve/veya Şu numarayı arayarak ARCore cihaz profili verileri: ARSession.Install()
Cihaz, ARCore ile Google Play Services for AR desteği ve ARCore cihaz profili verileri yüklü ve güncel olmalıdır. ARCore Session oluşturur ve ARCore'u kullanmaya başlar.

Yükleme ve destek durumları için ARSession.state sayfasını da kontrol edebilirsiniz.

Kullanıcı Gizlilik Şartlarına Uyma

Uygulamanızı Play Store'da yayınlamak için uygulamanızın ARCore'un Kullanıcı Gizlilik Şartları.

Sırada ne var?