# OrchestratorCallback

# OrchestratorCallback

Artifact:[androidx.test:runner](https://developer.android.com/jetpack/androidx/releases/test)  
[View Source](https://cs.android.com/search?q=file:androidx/test/runner_aidl/runner/android_junit_runner/java/androidx/test/orchestrator/callback/OrchestratorCallback.java+class:androidx.test.orchestrator.callback.OrchestratorCallback)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/test/orchestrator/callback/OrchestratorCallback "View this page in Java")

<br />

```
interface OrchestratorCallback : IInterface
```

<br />

Known direct subclasses  
[OrchestratorCallback.Default](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Default),[OrchestratorCallback.Stub](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Stub)  

|-------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------|
| [OrchestratorCallback.Default](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Default) | Default implementation for OrchestratorCallback. |
| [OrchestratorCallback.Stub](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Stub)       | Local-side IPC implementation stub class.        |

*** ** * ** ***

Defines an interface for remote Instrumentation service to speak to the AndroidTestOrchestrator

## Summary

|                                                                                                                                                                                                   ### Nested types                                                                                                                                                                                                   |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `class `[OrchestratorCallback.Default](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Default)` : `[OrchestratorCallback](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback) Default implementation for OrchestratorCallback.                                                                         |
| `abstract class `[OrchestratorCallback.Stub](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback.Stub)` : `[Binder](https://developer.android.com/reference/android/os/Binder.html)`, `[OrchestratorCallback](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback) Local-side IPC implementation stub class. |

|                             ### Public functions                              |
|-------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [addTest](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback#addTest(java.lang.String))`(test: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!)` Remote instrumentations, when given the parameter listTestsForOrchestrator, must add each test they wish executed to AndroidTestOrchestrator before terminating. |
| [Unit](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html) | [sendTestNotification](https://developer.android.com/reference/kotlin/androidx/test/orchestrator/callback/OrchestratorCallback#sendTestNotification(android.os.Bundle))`(bundle: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`!)` Remote instrumentations should pass a notification along to AndroidTestOrchestrator whenever they get a notification of test progress.       |

|                                                                                                                                                                                                                       ### Inherited functions                                                                                                                                                                                                                       |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From[android.os.IInterface](https://developer.android.com/reference/android/os/IInterface.html) |-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| | [IBinder](https://developer.android.com/reference/android/os/IBinder.html)`!` | [asBinder](https://developer.android.com/reference/android/os/IInterface.html#asBinder())`()` | |

## Public functions

### addTest

```
fun addTest(test: String!): Unit
```

Remote instrumentations, when given the parameter listTestsForOrchestrator, must add each test they wish executed to AndroidTestOrchestrator before terminating.  

|                                                Throws                                                 |
|-------------------------------------------------------------------------------------------------------|---|
| [android.os.RemoteException](https://developer.android.com/reference/android/os/RemoteException.html) |   |

### sendTestNotification

```
fun sendTestNotification(bundle: Bundle!): Unit
```

Remote instrumentations should pass a notification along to AndroidTestOrchestrator whenever they get a notification of test progress. Use OrchestratorService constants to determine the notification type.  

|                                                Throws                                                 |
|-------------------------------------------------------------------------------------------------------|---|
| [android.os.RemoteException](https://developer.android.com/reference/android/os/RemoteException.html) |   |