Applicable XR devices This guidance helps you build experiences for these types of XR devices. [Learn about XR device types →](https://developer.android.com/develop/xr/devices.md.txt) ![](https://developer.android.com/static/images/develop/xr/xr-headsets-icon.svg) XR Headsets [](https://developer.android.com/develop/xr/devices.md.txt#xr-headsets) ![](https://developer.android.com/static/images/develop/xr/xr-glasses-icon.svg) Wired XR Glasses [](https://developer.android.com/develop/xr/devices.md.txt#xr-glasses) [Learn about XR device types →](https://developer.android.com/develop/xr/devices.md.txt)
A user can experience your app in two modes, Home Space or Full Space. In Home Space, a user is able to multitask with your app running side by side with other apps. In Full Space, your app takes center stage as the focus of the user's experience with full access to the immersive capabilities of Android XR. Your app opens in Home Space by default unless you specify otherwise as described in the [Declare the default mode for launch](https://developer.android.com/develop/xr/jetpack-xr-sdk/transition-home-space-to-full-space.md.txt#declare-default-mode) section. [Spatialization](https://developer.android.com/design/ui/xr/guides/foundations.md.txt) is only supported in Full Space. Your app can transition to Full Space to take advantage of spatial and 3D capabilities. When your app has focus, you can transition between these modes by requesting the corresponding space. ## Use `SpaceToggleButton` to switch between Home Space and Full Space To transition between Home Space and Full Space, use the [`SpaceToggleButton`](https://developer.android.com/reference/kotlin/androidx/xr/compose/material3/SpaceToggleButton.composable.md.txt#SpaceToggleButton(androidx.compose.ui.Modifier,androidx.compose.material3.IconToggleButtonColors,kotlin.Function1)) composable from the [Material Design for XR](https://developer.android.com/jetpack/androidx/releases/xr-compose-material3.md.txt) library. This is a composable button that adapts to the current spatial mode and toggles between Full Space and Home Space. ## Build a custom transition between Home Space and Full Space If you are using the Jetpack Compose for XR library, request home space or full space using the [`LocalSession`](https://developer.android.com/reference/kotlin/androidx/xr/compose/platform/package-summary.md.txt#LocalSession()) composition local. ```kotlin val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace() ```
If you are using the Jetpack SceneCore library, you can request the corresponding space from the [`Session`](https://developer.android.com/reference/kotlin/androidx/xr/runtime/Session.md.txt); see [Access Session from Jetpack SceneCore](https://developer.android.com/develop/xr/jetpack-xr-sdk/add-session#access-session). ```kotlin xrSession.scene.requestHomeSpace() ```
Review our [design guidance](https://developer.android.com/design/ui/xr/guides/foundations.md.txt) to learn more about Home Space to Full Space and how to best transition between the two. ## Declare the default mode for launch Alternatively, you can add the following lines to your Android Manifest file to choose which space your app should open in: ```xml ``` > [!NOTE] > **Note:** These manifest attributes can be declared at either the `` or the `` level in your app's manifest. Declaring at the activity level will impact the launch preference for the activity element you apply it to. ## See also - [Check for spatial capabilities](https://developer.android.com/develop/xr/jetpack-xr-sdk/check-spatial-capabilities.md.txt) - [Create a session](https://developer.android.com/develop/xr/jetpack-xr-sdk/add-session.md.txt) - [Add environments to your app](https://developer.android.com/develop/xr/jetpack-xr-sdk/add-environments.md.txt) - [Add 3D models to your app](https://developer.android.com/develop/xr/jetpack-xr-sdk/add-3d-models.md.txt)