Transisi dari Ruang Rumah ke Ruang Penuh

Pengguna dapat menggunakan aplikasi Anda dalam dua mode, Ruang Rumah atau Ruang Penuh. Di Ruang Rumah, pengguna dapat melakukan multitasking dengan aplikasi Anda yang berjalan berdampingan dengan aplikasi lain. Dalam Ruang Penuh, aplikasi Anda menjadi fokus utama sebagai fokus pengalaman pengguna dengan akses penuh ke kemampuan imersif Android XR.

Aplikasi Anda akan terbuka di Ruang Rumah secara default, kecuali jika Anda menentukannya sebagai dijelaskan di bagian Mendeklarasikan mode default untuk peluncuran.

Spasialisasi hanya didukung di Ruang Penuh. Aplikasi Anda dapat bertransisi ke Ruang Penuh untuk memanfaatkan kemampuan spasial dan 3D. Saat aplikasi memiliki fokus, Anda dapat bertransisi di antara mode ini dengan meminta ruang yang sesuai.

Transisi antara Ruang Rumah dan Ruang Penuh

Jika Anda menggunakan library Jetpack Compose untuk XR, minta ruang rumah atau ruang penuh menggunakan komposisi lokal LocalSpatialConfiguration.

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

Jika menggunakan library Jetpack SceneCore, Anda dapat meminta ruang yang sesuai dari Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

Lihat codelab Mempelajari Dasar-Dasar Android XR: Bagian 1 - Mode dan Panel Spasial untuk mengetahui contoh cara menggunakan permintaan ini untuk bertransisi di antara mode dengan mengklik tombol. Sebaiknya Anda juga meninjau panduan desain kami untuk mempelajari lebih lanjut Ruang rumah ke Ruang penuh dan cara terbaik untuk bertransisi di antara keduanya.

Mendeklarasikan mode default untuk peluncuran

Atau, Anda dapat menambahkan baris berikut ke file Manifes Android untuk memilih ruang tempat aplikasi Anda akan terbuka:

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

Lihat juga