<h2 id="requestfullspace">requestFullSpace</h2>

<div class='sourceset sourceset-android'>Android</div>

```kotlin
public suspend fun ComponentActivity.requestFullSpace(): Unit
```

Request that the system places the application into full space mode.

In full space, this application will be the only application in the visible space, its spatial
capabilities will be expanded, and its physical bounds will expand to fill the entire virtual
space.

This suspend function will complete once the application has successfully entered full space.
Cancelling this suspend function does not cancel the request to switch spaces. This should not
throw any exceptions and will do nothing on devices that do not support XR spaces. This request
will be cancelled if `requestFullSpace` or [requestHomeSpace](/jetpack-compose/androidx.xr.compose/compose/functions/requestHomeSpace) is called before this request
completes.

See [modes in XR](https://developer.android.com/design/ui/xr/guides/foundations#modes).