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: Ev Alanı veya Tam 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 kullanıcının deneyiminin odak noktası olarak ön plana çıkar ve Android XR'ın yoğun içerik özelliklerine tam erişim sağlar.

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 Alan'da desteklenir. Uygulamanız, uzamsal ve 3D özelliklerden yararlanmak için Full Space'e geçiş yapabilir. Uygulamanız odaklandığında, ilgili alanı isteyerek bu modlar arasında geçiş yapabilirsiniz.

Ev alanı ile tam 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 Material Design for XR kitaplığındaki SpaceToggleButton composable'ı kullanın.

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

Ev alanı ile tam alan arasında özel bir 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.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

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.requestHomeSpaceMode()
ModeTransition.kt

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'ın Temellerini Öğrenin: Bölüm 1 - Modlar ve Uzamsal Paneller codelab'ine bakın. Ayrıca, Ev Alanı'ndan Tam Alan'a geçiş ve bu iki alan arasında en iyi şekilde nasıl geçiş yapacağınız 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" />

Ayrıca bkz.