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ı Artırılmış Gerçeklik Gerekli veya Artırılmış Gerçeklik İsteğe Bağlı olarak yapılandırma

Tüm AR özellikleri, bağımsız cihazlarda yer kazanmak için Play Store tarafından ayrı olarak güncellenen AR için Google Play Hizmetleri adlı bir uygulamada saklanı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 Required (AR Zorunlu) ve AR Optional (AR İsteğe Bağlı). Bu tanımlama, artırılmış gerçeklik uygulaması : AR uygulamasının AR için Google Play Hizmetleri uygulamasıyla nasıl etkileşim kuracağını belirler.

AR Required (AR Gerekli) uygulamalar, ARCore olmadan çalışamaz. Bu özellik için ARCore'u destekleyen ve AR için Google Play Hizmetleri'nin yüklü olduğu bir cihaz gerekir.

  • Google Play Store, yalnızca ARCore'u destekleyen cihazlarda AR Required uygulamalarını kullanıma sunar.
  • Kullanıcılar AR Required uygulaması yüklediğinde Google Play Store, AR için Google Play Hizmetleri'ni cihazlarına otomatik olarak yükler. Ancak uygulamanız, AR için Google Play Hizmetleri güncel değilse veya manuel olarak kaldırılmışsa ek çalışma zamanı kontrolleri gerçekleştirmelidir.

AR İsteğe Bağlı uygulamalar, mevcut işlevleri geliştirmek için ARCore'u kullanır. AR için Google Play Hizmetleri'nin yüklü olduğu ve ARCore'un desteklendiği cihazlarda etkinleştirilen isteğe bağlı AR özellikleri vardır.

  • AR isteğe bağlı uygulamalar, ARCore'u desteklemeyen cihazlara yüklenebilir ve bu cihazlarda ç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 GerekliAR İsteğe Bağlı
AR özelliğinin kullanımı Uygulamanızın temel işlevleri için ARCore'a ihtiyacı 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 yalnızca ARCore'u destekleyen cihazlarda Play Store'da listelenir. Uygulamanız normal listeleme prosedürlerine uygundur.
AR için Google Play Hizmetleri yükleme yöntemi Play Store, AR için Google Play Hizmetleri'ni uygulamanızla birlikte yükler. Uygulamanız, ARCore'u indirmek ve yüklemek için ARSession.Install() coroutine'i kullanıyor.
Android minSdkVersion gereksinimleri Android 7.0 (API düzeyi 24) Android 4.4 (API düzeyi 19) ancak herhangi bir AR işlevinin ç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() coroutine'i kullanmalıdır.

Uygulamanızı AR Required (Artırılmış Gerçeklik Gerekli) yapma

Android

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

  2. Edit > Project Settings > Player simgesini tıklayın ve Android simgesinin bulunduğu sekmeyi seçin.

  3. Other Settings > Identification altında, 24 veya daha yüksek bir Minimum API Level belirtin.

iOS

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

  2. Edit > Project Settings > Player simgesini tıklayın ve iOS simgesinin bulunduğu sekmeyi seçin.

  3. Other Settings > Configuration bölümünde uygulamanız için Target minimum iOS Version belirtin.

Uygulamanızda artırılmış gerçekliği isteğe bağlı hale getirme

Android

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

  2. Requirement açılır menüsünde Optional seçeneğini belirleyerek uygulamanızı AR isteğe bağlı olarak ayarlayın.

  3. Edit > Project Settings > Player simgesini tıklayın ve Android simgesinin bulunduğu sekmeyi seçin.

  4. Other Settings > Identification altında, 24 veya daha yüksek bir Minimum API Level belirtin.

iOS

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

  2. Requirement açılır menüsünde Optional'ı seçerek uygulamanızı AR İsteğe Bağlı olarak ayarlayın.

  3. Edit > Project Settings > Player simgesini tıklayın ve iOS simgesinin bulunduğu sekmeyi seçin.

  4. Other Settings > Configuration bölümünde uygulamanız için Target minimum iOS Version belirtin.

Çalışma zamanı denetimleri gerçekleştirme

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

Hem AR Required hem de AR Optional uygulamaları, ARCore oturumu oluşturmadan önce ARSession.Install() coroutine'i kullanarak AR için Google Play Hizmetleri'nin uyumlu bir sürümünün (hâlâ) yüklü olup olmadığını kontrol etmeli ve gerekli tüm ARCore cihaz profili verilerinin indirildiğinden emin olmalıdır.

Çalışma zamanında, AR Required uygulamaları, 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 desteği
  • Google Play Services for AR yüklüyse (yüklenmemişse, örneğin kullanıcı tarafından kaldırılmışsa veya sürüm çok eskiyse uygulamanız kullanıcıdan yüklemesini ya da güncellemesini ister).
  • ARCore cihaz profil verileri güncel olmalıdır. Güncel değilse uygulamanız yeni veriler indirir.

Bu varsayılan kontrolleri devre dışı bırakmak için ARSession.attemptUpdate değerini false olarak ayarlayın. Uygulamanız bu koşulları yine de karşılamalıdır:

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 ya da güncel değil. ARSession.Install() işlevi çağrılarak kullanıcıdan Google Play Services for AR ve/veya ARCore cihaz profil verilerini yüklemesi ya da güncellemesi istenir.
Cihaz, ARCore'u ve Google Play Services for AR'yı destekliyor olmalı ve ARCore cihaz profili verileri yüklü ve güncel olmalıdır. ARCore Session oluşturur ve ARCore'u kullanmaya başlar.

Kurulum ve destek durumları için ARSession.state bölümünü de inceleyebilirsiniz.

Kullanıcı Gizliliği Şartlarına Uyma

Uygulamanızı Play Store'da yayınlamak için ARCore'un Kullanıcı Gizliliği Şartları'na uyduğundan emin olun.

Sırada ne var?