Ev alanından tam alana geçiş

Uygun XR cihazlar
Bu kılavuz, bu tür XR cihazlar için deneyimler oluşturmanıza yardımcı olur.
XR cihaz türleri hakkında bilgi edinin →
XR Kulaklığı
Kablolu XR Gözlükleri
XR cihaz türleri hakkında bilgi edinin →

Kullanıcılar, uygulamanızı iki modda deneyimleyebilir: Ana Sayfa Alanı veya Tam Ekran Alanı. Ana Sayfa Alanı'nda kullanıcılar, uygulamanızı diğer uygulamalarla yan yana çalıştırarak çoklu görev yapabilir. Tam ekran alanında, uygulamanız Android XR'ın yoğun içerik özelliklerine tam erişimle kullanıcının deneyiminin odak noktası olarak ön plana çıkar.

Başlatma için varsayılan modu bildirme bölümünde açıklandığı şekilde başka bir mod belirtmediğiniz sürece uygulamanız varsayılan olarak Ev Alanı'nda açılır.

Uzamsallaştırma yalnızca Tam Ekran Alanı'nda desteklenir. Uygulamanız, uzamsal ve 3D özelliklerden yararlanmak için Tam Ekran Alanı'na geçiş yapabilir. Uygulamanız odaklandığında, ilgili alanı isteyerek bu modlar arasında geçiş yapabilirsiniz.

Ana Sayfa Alanı ve Tam Ekran Alanı arasında geçiş yapmak için SpaceToggleButton simgesini kullanın.

Ana Sayfa Alanı ile Tam Ekran Alanı arasında geçiş yapmak için SpaceToggleButton composable'ı Materyal Tasarım for XR kitaplığından kullanın.

Bu, mevcut uzamsal moda uyum sağlayan ve Tam Ekran Alanı ile Ana Sayfa Alanı arasında geçiş yapan birleştirilebilir bir düğmedir.

Ana Sayfa Alanı ile Tam Ekran Alanı arasında özel geçiş oluşturma

XR için Jetpack Compose kitaplığını kullanıyorsanız LocalSession kompozisyon yerelini kullanarak ana alan veya tam alan isteğinde bulunun.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

Jetpack SceneCore kitaplığını kullanıyorsanız Session adresinden ilgili alanı isteyebilirsiniz. Jetpack SceneCore'dan Erişim Oturumu başlıklı makaleyi inceleyin.

xrSession.scene.requestHomeSpace()

Bir düğmeyi tıklayarak modlar arasında geçiş yapmak için bu isteklerin nasıl kullanılacağına dair örnekler için Android XR Temel Bilgileri: Bölüm 1 - Modlar ve Üç Boyutlu Paneller codelab'ine bakın. Ayrıca, Home Space'ten Full Space'e geçiş ve bu iki alan arasında en iyi şekilde geçiş yapma hakkında daha fazla bilgi edinmek için tasarım rehberimizi incelemenizi öneririz.

Başlatma için varsayılan modu bildirme

Alternatif olarak, uygulamanızın hangi alanda açılacağını seçmek için Android Manifest dosyanıza aşağıdaki satırları ekleyebilirsiniz:

<!-- Launch in Full Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

<!-- Or, launch in Home Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />

Aşağıdaki kaynakları da incelemenizi öneririz: