Transisi dari Ruang Rumah ke Ruang Penuh

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Mempelajari jenis perangkat XR →
Headset XR
Kacamata XR Berkabel
Mempelajari jenis perangkat XR →

Pengguna dapat menggunakan aplikasi Anda dalam dua mode, Ruang Utama atau Ruang Penuh. Dalam Ruang Utama, 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 menentukan sebaliknya seperti yang dijelaskan di bagian Mendeklarasikan mode default untuk peluncuran.

Spatialization 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 antar-mode ini dengan meminta ruang yang sesuai.

Menggunakan SpaceToggleButton untuk beralih antara Ruang Utama dan Ruang Penuh

Untuk bertransisi antara Ruang Utama dan Ruang Penuh, gunakan SpaceToggleButton composable dari Material Design untuk XR library.

Ini adalah tombol composable yang beradaptasi dengan mode spasial saat ini dan beralih antara Ruang Penuh dan Ruang Utama.

Membuat transisi kustom antara Ruang Utama dan Ruang Penuh

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

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

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

xrSession.scene.requestHomeSpace()

Lihat Mempelajari Dasar-Dasar Android XR: Bagian 1 - Mode dan Panel Spasial codelab untuk mengetahui contoh cara menggunakan permintaan ini untuk bertransisi antar-mode dengan mengklik tombol. Sebaiknya tinjau panduan desain kami untuk mempelajari Ruang Utama ke Ruang Penuh lebih lanjut dan cara terbaik untuk bertransisi antara keduanya.

Mendeklarasikan mode default untuk peluncuran

Atau, Anda dapat menambahkan baris berikut ke file Android Manifest 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" />

Lihat juga