---
title: "UnmanagedSessionReceiver"
description: "This receiver responds to lambda action clicks for unmanaged sessions (created by
[GlanceAppWidget.runComposition]). In managed sessions that compose UI for a bound widget, the
widget's [GlanceAppWidgetReceiver] is used as the receiver for lambda actions. However, when
running a session with [GlanceAppWidget.runComposition], there is no guarantee that the widget is
attached to some GlanceAppWidgetReceiver. Instead, unmanaged sessions register themselves to
receive lambdas while they are running (with [UnmanagedSessionReceiver.registerSession]), and set
their lambda target to [UnmanagedSessionReceiver]. This is also used by
[GlanceRemoteViewsService] to provide list items for unmanaged sessions."
type: "class"
---

<div class='type'>Class</div>


<a id='references'></a>

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


```kotlin
public open class UnmanagedSessionReceiver : BroadcastReceiver()
```


This receiver responds to lambda action clicks for unmanaged sessions (created by
`GlanceAppWidget.runComposition`). In managed sessions that compose UI for a bound widget, the
widget's `GlanceAppWidgetReceiver` is used as the receiver for lambda actions. However, when
running a session with `GlanceAppWidget.runComposition`, there is no guarantee that the widget is
attached to some GlanceAppWidgetReceiver. Instead, unmanaged sessions register themselves to
receive lambdas while they are running (with `UnmanagedSessionReceiver.registerSession`), and set
their lambda target to `UnmanagedSessionReceiver`. This is also used by
`GlanceRemoteViewsService` to provide list items for unmanaged sessions.


## Companion Object

#### Methods

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


```kotlin
suspend fun registerSession(appWidgetId: Int, session: AppWidgetSession): Nothing
```


Registers `session` to handle lambdas created from an unmanaged session running for
`appWidgetId`.

This call will suspend once the session is registered. On cancellation, this session will
be unregistered. That way, the registration is tied to the surrounding coroutine scope
and does not need to be manually unregistered.

If called from another coroutine with the same `appWidgetId`, this call will resume with
an exception, and the new registration will succeed. (i.e., only one session per
`appWidgetId` can be registered at the same time). By default, `runComposition` uses
random fake IDs, so this could only happen if the user calls `runComposition` with two
identical real IDs.



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


```kotlin
fun getSession(appWidgetId: Int): AppWidgetSession?
```