# RaiseHandState

# RaiseHandState

Artifact:[androidx.core:core-telecom](https://developer.android.com/jetpack/androidx/releases/core)  
[View Source](https://cs.android.com/search?q=file:androidx/core/telecom/extensions/RaiseHandState.kt+class:androidx.core.telecom.extensions.RaiseHandState)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/core#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/core/telecom/extensions/RaiseHandState "View this page in Java")

<br />

```
@ExperimentalAppActions
interface RaiseHandState
```

<br />

*** ** * ** ***

Provides this application with the ability to notify remote surfaces (automotive, watch, etc..) when[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)s in the call have raised or lowered their hands.

## Summary

|                                  ### Public functions                                   |
|-----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `suspend `[Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [updateRaisedHands](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/RaiseHandState#updateRaisedHands(kotlin.collections.List))`(raisedHands: `[List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)`<`[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)`>)` Notify the remote surfaces of an update to the[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)s that have their hands raised at the current time. |

## Public functions

### updateRaisedHands

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/core#1.0.0)  

```
suspend fun updateRaisedHands(raisedHands: List<Participant>): Unit
```

Notify the remote surfaces of an update to the[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)s that have their hands raised at the current time. Any[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)that is in the call and is in[raisedHands](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/RaiseHandState#updateRaisedHands(kotlin.collections.List))is considered to have their hand raised and any[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)that is in the call that is not in[raisedHands](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/RaiseHandState#updateRaisedHands(kotlin.collections.List))is considered to have their hand lowered. The order of the[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)s in[raisedHands](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/RaiseHandState#updateRaisedHands(kotlin.collections.List))MUST be in the order that the hands were raised, earliest raised hand first.  

|                                                                                                        Parameters                                                                                                        |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `raisedHands: `[List](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html)`<`[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)`>` | The updated List of[Participant](https://developer.android.com/reference/kotlin/androidx/core/telecom/extensions/Participant)s that have their hands raised, ordered as earliest raised hand to newest raised hand. |