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

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

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

Her bir cihazda alandan tasarruf etmek 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 Zorunlu ve İ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 Zorunlu uygulamaları, ARCore olmadan çalışamaz. AR için Google Play Hizmetleri'nin yüklü olduğu, ARCore destekli bir cihaz gerektirir.

• Google Play Store, ARCore uygulamaları yalnızca 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'nin eski olması veya yüklemesinin manuel olarak kaldırılmış olması durumunda uygulamanızın yine de 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üklenip çalıştırılabilir.
• Kullanıcılar isteğe bağlı bir AR uygulaması yüklediğinde Google Play Store, cihaza AR için Google Play Hizmetleri'ni 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şlevi için ARCore uygulaması gereklidir.	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 cihazlardaki Play Store'da listelenir.	Uygulamanızda normal giriş prosedürleri kullanılıyor.
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ız, ARCore'u indirip yüklemek için ARSession.Install() eş yormasını kullanır.
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
AR için Google Play Hizmetleri'ni yüklemek amacıyla ARSession.Install() eş yordasının kullanılması gerekir

Uygulamanızı Artırılmış Gerçeklik (AR) Gerekli Hale Getirme

Android

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

   

2. Edit > Project Settings > Player simgesini tıklayıp 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 ayarlanmıştır.

   

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

   

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

   

Uygulamanızı Artırılmış Gerçeklik (AR) İsteğ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ünden Optional seçeneğini belirleyerek uygulamanızı isteğe bağlı AR özelliğine ayarlayın.

   

3. Edit > Project Settings > Player simgesini tıklayıp 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ünden Optional'ı seçerek uygulamanızı Artırılmış Gerçeklik (AR) İsteğe Bağlı olarak ayarlayın.

   

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

   

4. 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, ARCore oturumu oluşturmadan önce ARSession.Install() eş yordasını 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.

AR Zorunlu uygulamalar, çalışma sırasında hedef cihazın aşağıdaki özelliklere sahip olmasını sağlamak için otomatik olarak çalışma zamanı kontrolleri gerçekleştirir:

• 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 veriler indirir.

Bu varsayılan kontrolleri devre dışı bırakmak için ARSession.attemptUpdate değerini false olarak ayarlayın. Uygulamanız yine de şu koşulları 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 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.
Cihaz, ARCore ve Google Play Services for AR ürününü destekler. ARCore cihaz profili verileri yüklü 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ı Gizlilik Şartlarına Uyma

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

Sonraki adımlar

• ARCore oturumunu nasıl yapılandıracağınızı öğrenin.