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 sorotan sebagai fokus pengalaman pengguna dengan akses penuh ke kemampuan imersif Android XR.

Spasialisasi saat ini 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 mode yang sesuai dari sesi XR.

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

Transisi antara Ruang Rumah dan Ruang Penuh

Untuk bertransisi antara Ruang Rumah dan Ruang Penuh, Anda harus meminta mode operasi dari Session. Seperti yang ditunjukkan pada contoh berikut, Anda dapat menggunakan permintaan ini agar pengguna dapat bertransisi antar-mode dengan mengklik tombol.

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

Lihat panduan desain untuk mempelajari lebih lanjut ruang Beranda ke ruang Penuh dan cara terbaik untuk bertransisi di antara keduanya.

Mendeklarasikan mode default untuk peluncuran

Untuk memilih apakah aplikasi Anda diluncurkan di Ruang Utama atau Ruang Penuh, tambahkan baris berikut ke file Manifes Android:

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