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ı olarak yapılandırın
Tüm AR özellikleri, cihazlarda yer açmak için 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 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 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, AR'nin gerekli olduğu uygulamaları yalnızca ARCore'u destekleyen cihazlarda kullanıma sunar.
- Kullanıcılar AR gerektiren 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 güncel değilse veya manuel olarak kaldırıldıysa uygulamanızın ek çalışma zamanında denetimler yapması gerekir.
AR İsteğe Bağlı uygulamalar, mevcut işlevleri iyileş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.
- AR İsteğe Bağlı uygulamaları, ARCore'u desteklemeyen cihazlara yüklenip çalıştırılabilir.
- Kullanıcılar AR İsteğe Bağlı bir uygulama yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihaza otomatik olarak yüklemez.
| AR Zorunlu | AR İsteğe bağlı | |
|---|---|---|
| AR özelliğinin kullanımı | Uygulamanızın temel işlevi için ARCore'a ihtiyaç var. | ARCore, uygulamanızın işlevselliğini artırır. Uygulamanız ARCore desteği olmadan çalışabilir. |
| Play Store'da görünürlük | Uygulamanız Play Store'da yalnızca ARCore'u destekleyen cihazlarda listelenir. | Uygulamanız normal listeleme prosedürlerine uygun olmalıdır. |
| 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ız ARCore'u indirmek ve yüklemek için ARSession.Install() eş normalini kullanıyor. |
Android minSdkVersion gereksinimleri |
Android 7.0 (API düzeyi 24) | Android 4.4 (API düzeyi 19), ancak AR işlevlerinin çalışması 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.
|
||
AR için Google Play Hizmetleri'ni yüklemek üzere ARSession.Install() eş yordamını kullanmanız gerekir |
Uygulamanızı AR zorunlu hale getirme
Yapay Zeka
Edit > Project Settings > XR Plug-in Management > ARCore adresine gidin. Requirement varsayılan olarak Required değerine ayarlanı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 gidin. Requirement, varsayılan olarak Required değerine ayarlıdır.
Edit > Project Settings > Player simgesini tıklayın, iOS simgesini içeren sekmeyi seçin.
Other Settings > Configuration bölümünde, uygulamanız için Target minimum iOS Version değerini belirtin.
Uygulamanızı artırılmış gerçeklik (AR) isteğe bağlı hale getirin
Yapay Zeka
Edit > Project Settings > XR Plug-in Management > ARCore adresine gidin.
Uygulamanızı AR'yi isteğe bağlı olarak ayarlamak için Requirement açılır menüsünden Optional'i seçin.
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 gidin.
Uygulamanızı AR İsteğe Bağlı olarak ayarlamak için Requirement açılır menüsünden Optional'i seçin.
Edit > Project Settings > Player simgesini tıklayın, iOS simgesini içeren sekmeyi seçin.
Other Settings > Configuration bölümünde, uygulamanız için Target minimum iOS Version değerini belirtin.
Çalışma zamanı kontrolleri gerçekleştir
AR için Google Play Hizmetleri'nin yüklü olup olmadığını kontrol etme
Hem AR için gerekli hem de AR isteğ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şturmadan önce ARSession.Install() eş yordamını kullanmalıdır.
AR Gerekli uygulamaları, çalışma zamanında hedef cihazın aşağıdaki koşulları karşıladığından emin olmak için otomatik olarak çalışma zamanı kontrolleri gerçekleştirir:
- ARCore'u destekler
- Google Play Services for AR yüklü: Bu uygulama 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 sahip olmalıdır. Veriler güncel değilse uygulamanız yeni veriler indirir.
Bu varsayılan kontrolleri devre dışı bırakmak için ARSession.attemptUpdate parametresini false olarak ayarlayın. Uygulamanız şu koşulları karşılamaya devam edecek:
| Koşul | İşlem |
|---|---|
| Cihaz ARCore'u desteklemiyor. | 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. | ARSession.Install() çağrısını yaparak kullanıcıdan Google Play Services for AR ve/veya ARCore cihaz profili verilerini yüklemesini veya güncellemesini ister. |
| Cihaz, ARCore ve Google Play Services for AR'ü destekler ve ARCore cihaz profili verileri yüklenmiş ve günceldir. | 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ı Gizliliği Şartlarını Yerine Getirme
Uygulamanızı Play Store'da yayınlamak için ARCore'un Kullanıcı Gizliliği Şartları'na uyduğundan emin olun.