Transisi dari Ruang Rumah ke Ruang Penuh

Pengguna dapat menggunakan aplikasi Anda dalam dua mode, Ruang Utama 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 pusat perhatian sebagai fokus pengalaman pengguna dengan akses penuh ke kemampuan imersif Android XR.

Aplikasi Anda akan terbuka di Ruang Utama secara default, kecuali jika Anda menentukannya secara berbeda seperti yang dijelaskan di bagian Mendeklarasikan mode default untuk peluncuran.

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

Transisi antara Ruang Utama 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()
ModeTransition.kt

Jika menggunakan library Jetpack SceneCore, Anda dapat meminta ruang yang sesuai dari Session; lihat Mengakses Sesi dari Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Lihat codelab Mempelajari Dasar-Dasar Android XR: Bagian 1 - Mode dan Panel Spasial untuk mengetahui contoh cara menggunakan permintaan ini untuk bertransisi antar-mode dengan mengklik tombol. Sebaiknya Anda juga meninjau panduan desain kami untuk mempelajari lebih lanjut transisi dari Ruang Utama 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 harus dibuka:

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