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)  XR Headsets [](https://developer.android.com/develop/xr/devices.md.txt#xr-headsets)  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)
The [`Session`](https://developer.android.com/reference/kotlin/androidx/xr/runtime/Session.md.txt) provides the primary interface to spatialized functionality
for your app. Each spatialized `Activity` must create and hold an instance of
`Session`. After your app creates a session, it can use the `Session` interfaces
to create spatialized content entities such as panels or 3D models, as well as
[set a spatial environment](https://developer.android.com/develop/xr/jetpack-xr-sdk/add-environments.md.txt), [identify device position](https://developer.android.com/develop/xr/jetpack-xr-sdk/arcore/device-pose.md.txt), and [anchor
content](https://developer.android.com/develop/xr/jetpack-xr-sdk/work-with-entities) to the real world.
## Access a session from Jetpack Compose for XR
When using Jetpack Compose for XR, the session is created for you and can be
accessed using [`LocalSession.current`](https://developer.android.com/reference/kotlin/androidx/xr/compose/platform/package-summary.md.txt#LocalSession()). See the following example:
```kotlin
@Composable
fun ComposableUsingSession() {
val session = LocalSession.current
}
```
## Access a session from Jetpack XR Runtime
If you're creating spatialized entities from the Jetpack SceneCore library,
you'll need to create a session.
To create a session, pass a [`Context`](https://developer.android.com/reference/kotlin/android/content/Context.md.txt) to the
[`create()`](https://developer.android.com/reference/kotlin/androidx/xr/runtime/Session.md.txt#create(android.content.Context,kotlin.coroutines.CoroutineContext,androidx.lifecycle.LifecycleOwner)) method. This `Context` can be an `Activity` on
immersive XR devices or mobile devices, or a
[projected context](https://developer.android.com/develop/xr/jetpack-xr-sdk/access-hardware-projected-context.md.txt) on Intelligent Eyewear.
Creating an ARCore session can be an expensive task, and should be
[processed in the background](https://developer.android.com/develop/background-work/background-tasks/asynchronous.md.txt), as shown in
the following example:
```kotlin
lifecycleScope.launch {
when (val result = Session.create(context)) {
is SessionCreateSuccess -> {
val xrSession = result.session
// ...
}
else ->
TODO(/* A different unhandled exception was thrown. */)
}
}
```
> [!NOTE]
> **Note:** You can only create a session on either an Android XR device, or on a [supported ARCore device](https://developers.google.com/ar/devices). See [`SessionCreateResult`](https://developer.android.com/reference/kotlin/androidx/xr/runtime/SessionCreateResult.md.txt) to see reasons why a session may not be able to be created.
The `create()` function can use an optional
[`LifecycleOwner`](https://developer.android.com/reference/kotlin/androidx/lifecycle/LifecycleOwner.md.txt) parameter, which allows the
session's lifecycle to be managed by a different `LifecycleOwner`. The
`LifecycleOwner` must begin and end its lifecycle within the scope of the
provided context, otherwise the `Session` may be prone to leaks.
> [!NOTE]
> **Note:** Some features, such as [hand tracking](https://developer.android.com/develop/xr/jetpack-xr-sdk/arcore/hands.md.txt) and [plane tracking](https://developer.android.com/develop/xr/jetpack-xr-sdk/arcore/planes.md.txt), require additional runtime permissions in order for session configuration to succeed.
## See also
- [Check for spatial capabilities](https://developer.android.com/develop/xr/jetpack-xr-sdk/check-spatial-capabilities.md.txt)
- [Transition between HSM and FSM](https://developer.android.com/develop/xr/jetpack-xr-sdk/transition-home-space-to-full-space.md.txt)
- [Add spatial 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)