<h2 id="requesthomespace">requestHomeSpace</h2>

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

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

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

In home space, the visible space may be shared with other applications; however, applications in
home space will have their spatial capabilities and physical bounds limited.

This suspend function will complete once the application has successfully entered home 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 `requestHomeSpace` or [requestFullSpace](/jetpack-compose/androidx.xr.compose/compose/functions/requestFullSpace) is called before this request
completes.

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