Ev alanından tam alana geçiş

Geçerli 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ıklar
Kablolu XR Gözlükler
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ığı gibi 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çebilir. 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 LocalSpatialConfiguration kompozisyon yerelini kullanarak ana alanı veya tam alanı isteyin.

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

Jetpack SceneCore kitaplığını kullanıyorsanız Session'den ilgili alanı isteyebilirsiniz. Access Session from Jetpack SceneCore (Jetpack SceneCore'dan oturuma erişme) 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 ilişkin örnekleri Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels (Android XR'ın Temellerini Öğrenin: Bölüm 1 - Modlar ve Uzamsal Paneller) adlı codelab'de bulabilirsiniz. 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.