Ev alanından tam alana geçiş

Uygun XR cihazlar
Bu kılavuz, bu tür XR cihazları için deneyimler geliştirmenize yardımcı olur.
XR Kulaklığı
Kablolu XR Gözlükleri

Kullanıcılar, uygulamanızı Ana Sayfa Alanı veya Tam Ekran Alanı olmak üzere iki modda deneyimleyebilir. Ana Sayfa Alanı'nda kullanıcı, 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 merkezde yer alır.

Başlatma için varsayılan modu bildirme bölümünde açıklandığı şekilde aksi belirtilmediği sürece uygulamanız varsayılan olarak Home Space'te açılır.

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

Ev Alanı ile Tam Ekran Alanı arasında geçiş yapmak için SpaceToggleButton düğmesini kullanın.

Ana Sayfa Alanı ile Tam Ekran Alanı arasında geçiş yapmak için Material Design for XR kitaplığındaki SpaceToggleButton bileşenini kullanın.

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

Ev Alanı ile Tam Ekran Alanı arasında özel bir geçiş oluşturma

XR için Jetpack Compose kitaplığını kullanıyorsanız LocalSession bileşen yerelini kullanarak ev alanı veya tam alan isteyin.

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

Jetpack SceneCore kitaplığını kullanıyorsanız ilgili alanı Session'dan isteyebilirsiniz. Jetpack SceneCore'dan oturuma erişme bölümünü inceleyin.

xrSession.scene.requestHomeSpace()

Ev Alanı'ndan Tam Ekran Alanı'na geçiş ve bu iki alan arasında en iyi şekilde nasıl geçiş yapılacağı hakkında daha fazla bilgi edinmek için tasarım kılavuzumuzu inceleyin.

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: