# Action.WaitForMessage

# Action.WaitForMessage

Artifact: [androidx.media3:media3-test-utils](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/test/utils/Action.java+class:androidx.media3.test.utils.Action.WaitForMessage)

*** ** * ** ***

Kotlin \|[Java](https://developer.android.com/reference/androidx/media3/test/utils/Action.WaitForMessage "View this page in Java")


```
class Action.WaitForMessage : Action
```

<br />

|---|---|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)                                                                        |||
| ↳ | [androidx.media3.test.utils.Action](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action)                                  ||
|   | ↳ | [androidx.media3.test.utils.Action.WaitForMessage](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action.WaitForMessage) |

*** ** * ** ***

Waits for a player message to arrive. If the target already received a message, the action returns immediately.

## Summary

|                                                                                                                                                                                                                                                                       ### Public constructors                                                                                                                                                                                                                                                                        |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [WaitForMessage](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action.WaitForMessage#WaitForMessage(java.lang.String,androidx.media3.test.utils.ActionSchedule.PlayerTarget))`(` ` tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!,` ` playerTarget: `[ActionSchedule.PlayerTarget](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/ActionSchedule.PlayerTarget)`!` `)` |

|                            ### Protected functions                            |
|-------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [doActionImpl](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action.WaitForMessage#doActionImpl(androidx.media3.exoplayer.ExoPlayer,androidx.media3.exoplayer.trackselection.DefaultTrackSelector,android.view.Surface))`(` ` player: `[ExoPlayer](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer)`!,` ` trackSelector: `[DefaultTrackSelector](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/DefaultTrackSelector)`!,` ` surface: `[Surface](https://developer.android.com/reference/android/view/Surface.html)`?` `)` Called by [doActionAndScheduleNextImpl](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action#doActionAndScheduleNextImpl(androidx.media3.exoplayer.ExoPlayer,androidx.media3.exoplayer.trackselection.DefaultTrackSelector,android.view.Surface,androidx.media3.common.util.HandlerWrapper,androidx.media3.test.utils.ActionSchedule.ActionNode)) to perform the action. |

## Public constructors

### WaitForMessage

```
WaitForMessage(
    tag: @Size(max = 23) String!,
    playerTarget: ActionSchedule.PlayerTarget!
)
```  

|                                                                                        Parameters                                                                                        |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
| `tag: @`[Size](https://developer.android.com/reference/kotlin/androidx/annotation/Size)`(max = 23) `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | A tag to use for logging. |
| `playerTarget: `[ActionSchedule.PlayerTarget](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/ActionSchedule.PlayerTarget)`!`                                  | The target to observe.    |

## Protected functions

### doActionImpl

```
protected fun doActionImpl(
    player: ExoPlayer!,
    trackSelector: DefaultTrackSelector!,
    surface: Surface?
): Unit
```

Called by [doActionAndScheduleNextImpl](https://developer.android.com/reference/kotlin/androidx/media3/test/utils/Action#doActionAndScheduleNextImpl(androidx.media3.exoplayer.ExoPlayer,androidx.media3.exoplayer.trackselection.DefaultTrackSelector,android.view.Surface,androidx.media3.common.util.HandlerWrapper,androidx.media3.test.utils.ActionSchedule.ActionNode)) to perform the action.  

|                                                                        Parameters                                                                        |
|----------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| `player: `[ExoPlayer](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/ExoPlayer)`!`                                             | The player to which the action should be applied.                            |
| `trackSelector: `[DefaultTrackSelector](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/DefaultTrackSelector)`!` | The track selector to which the action should be applied.                    |
| `surface: `[Surface](https://developer.android.com/reference/android/view/Surface.html)`?`                                                               | The surface to use when applying actions, or `null` if no surface is needed. |