Ev alanından tam alana geçiş

Kullanıcılar, uygulamanızı iki modda deneyimleyebilir: Ev Alanı veya Tam Alan. Kullanıcılar, Ev Alanı'nda uygulamanızı diğer uygulamalarla yan yana çalıştırarak çoklu görev yapabilir. Tam alanda, uygulamanız kullanıcının deneyiminin odak noktası olarak ön plana çıkar ve Android XR'ın etkileyici ö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 Tam Uzay'a 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ş yapma

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 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_MANAGED" />

Ayrıca bkz.