Yeni veya mevcut uygulamanızda artırılmış gerçeklik özelliklerini kullanmak için artırılmış gerçeklik özelliğini etkinleştirin.
Uygulamanızı Artırılmış Gerçeklik (AR) Zorunlu veya Artırılmış Gerçeklik (AR) İsteğe Bağlı olacak şekilde yapılandırın
Her bir cihazda yer açmak için 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 uygulamalar iki şekilde yapılandırılabilir: AR Zorunlu 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 Tarafından Gerekli uygulamalar, ARCore olmadan çalışamaz. AR için Google Play Hizmetleri'nin yüklü olduğu, ARCore destekli bir cihaz gerekir.
- Google Play Store, yalnızca AR Core gerektiren uygulamaları ARCore'u destekleyen cihazlarda kullanıma sunacaktır.
- Kullanıcılar AR için Gerekli bir uygulamayı yüklediklerinde, Google Play Store AR için Google Play Hizmetleri'ni cihazlarına otomatik olarak yükler. Ancak, AR için Google Play Hizmetleri güncel değilse veya manuel olarak kaldırılmışsa uygulamanızın ek çalışma zamanı kontrolleri gerçekleştirmesi gerekir.
İsteğe bağlı artırılmış gerçeklik (AR) uygulamaları, mevcut işlevleri geliştirmek için ARCore'u kullanır. Yalnızca AR için Google Play Hizmetleri'nin yüklü olduğu, ARCore destekli cihazlarda etkinleştirilen isteğe bağlı AR özelliklerine sahiptir.
- İsteğe bağlı AR uygulamaları, ARCore'u desteklemeyen cihazlara yüklenebilir ve bu cihazlarda çalıştırılabilir.
- Kullanıcılar isteğe bağlı bir AR için Google Play Hizmetleri uygulamasını cihaza yüklediklerinde Google Play Store, AR için Google Play Hizmetleri'ni cihaza otomatik olarak yüklemez.
| Artırılmış Gerçeklik (AR) Gerekli | Artırılmış Gerçeklik (AR) İsteğe Bağlı | |
|---|---|---|
| Artırılmış gerçeklik (AR) özelliğinin kullanımı | Uygulamanızın temel işlevselliği için ARCore'a ihtiyacı vardır. | 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 cihazların Play Store'unda listelenir. | Uygulamanızda normal giriş prosedürleri uygulanmaktadır. |
| AR için Google Play Hizmetleri yükleme yöntemi | Play Store, uygulamanızın yanı sıra AR için Google Play Hizmetleri'ni yükler. | Uygulamanızda, ARCore'u indirip yüklemek için ARSession.state kullanılıyor. |
Android minSdkVersion gereksinimleri |
Android 7.0 (API Düzeyi 24) | Android 4.4 (API Düzeyi 19) ancak AR işlevlerinin çalıştırılması 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 |
Uygulamanızı artırılmış gerçeklik (AR) zorunlu hale getirme
Android
Edit > Project Settings > XR Plug-in Management > ARCore adresine gidiş rotasını izle. Requirement varsayılan olarak Required değerine ayarlıdır.
Edit > Project Settings > Player simgesini tıklayın, Android simgesini içeren sekmeyi seçin.
Other Settings > Identification altında,
24veya daha yüksek bir Minimum API Level belirtin.
iOS
Edit > Project Settings > XR Plug-in Management > ARKit adresine gidiş rotasını izle. Requirement varsayılan olarak Required değerine ayarlıdır.
Edit > Project Settings > Player öğesini tıklayın ve iOS simgesini içeren sekmeyi seçin.
Other Settings > Configuration altında, uygulamanız için Target minimum iOS Version belirtin.
Uygulamanızı AR'yi İsteğe Bağlı Hale Getirme
Android
Edit > Project Settings > XR Plug-in Management > ARCore adresine gidiş rotasını izle.
Requirement açılır menüsünden Optional seçeneğini belirleyerek uygulamanızı isteğe bağlı AR olarak ayarlayın.
Edit > Project Settings > Player simgesini tıklayın, Android simgesini içeren sekmeyi seçin.
Other Settings > Identification altında,
24veya daha yüksek bir Minimum API Level belirtin.
iOS
Edit > Project Settings > XR Plug-in Management > ARKit adresine gidiş rotasını izle.
Requirement açılır menüsünden Optional seçeneğini belirleyerek uygulamanızı AR İsteğe Bağlı olarak ayarlayın.
Edit > Project Settings > Player öğesini tıklayın ve iOS simgesini içeren sekmeyi seçin.
Other Settings > Configuration altında, uygulamanız için Target minimum iOS Version belirtin.
Çalışma zamanı kontrolleri gerçekleştirme
AR için Google Play Hizmetleri'nin yüklü olup olmadığını kontrol etme
Hem AR Zorunlu hem de AR İsteğe bağlı uygulamalar, AR için Google Play Hizmetleri'nin uyumlu bir sürümünün yüklü olup olmadığını kontrol etmek ve gerekli tüm ARCore cihaz profili verilerinin indirildiğinden emin olmak amacıyla, ARCore oturumu oluşturulmadan önce ARSession.state'ı çağırmalıdır.
AR Gerekli uygulamalar, çalışma zamanında otomatik olarak hedef cihazın aşağıdaki koşulları sağladığından emin olmak için çalışma zamanı kontrolleri yapar:
- ARCore'u destekler
- Google Play Services for AR yüklü. Yüklü değilse (muhtemelen kullanıcı tarafından kaldırıldığı için) veya sürüm çok eskiyse uygulamanız kullanıcıdan uygulamayı yüklemesini veya güncellemesini ister.
- Güncel ARCore cihaz profili verilerine sahiptir. Bu veriler güncel değilse uygulamanız yeni verileri indirir.
Bu varsayılan kontrolleri devre dışı bırakmak için ARSession.attemptUpdate öğesini false olarak ayarlayın. Uygulamanız şu koşulları karşılamaya devam etmelidir:
| 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 ya da eski. | Kullanıcıdan, ARSession.Install() yöntemini çağırarak Google Play Services for AR ve/veya ARCore cihaz profili verilerini yüklemesini ya da güncellemesini ister. |
| Cihazda ARCore ve Google Play Services for AR desteği mevcut. ARCore cihaz profili verileri yüklü ve güncel. | ARCore Session oluşturur ve ARCore'u kullanmaya başlar. |
Yükleme ve destek durumlarını görmek için ARSession.state sayfasını da kontrol edebilirsiniz.
Kullanıcı Gizliliği Şartlarına Uyma
Uygulamanızı Play Store'da yayınlamak için uygulamanızın ARCore'un Kullanıcı Gizliliği Şartları'na uyduğundan emin olun.