Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#pubctors) \| [Methods](https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#inhmethods)
# RemoteConnection.Callback
*** ** * ** ***
` public static abstract class RemoteConnection.Callback `
` extends https://developer.android.com/reference/java/lang/Object ` ` `
|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.telecom.RemoteConnection.Callback |
*** ** * ** ***
Callback base class for `https://developer.android.com/reference/android/telecom/RemoteConnection`.
## Summary
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#Callback()() ` |
| ### Public methods ||
|---|---|
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onAddressChanged(android.telecom.RemoteConnection,%20android.net.Uri,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/net/Uri address, int presentation) ` Indicates that the address (e.g., phone number) of this `RemoteConnection` has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onCallerDisplayNameChanged(android.telecom.RemoteConnection,%20java.lang.String,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/java/lang/String callerDisplayName, int presentation) ` Indicates that the caller display name of this `RemoteConnection` has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onConferenceChanged(android.telecom.RemoteConnection,%20android.telecom.RemoteConference)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/telecom/RemoteConference conference) ` Indicates that the `RemoteConference` that this `RemoteConnection` is a part of has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onConferenceableConnectionsChanged(android.telecom.RemoteConnection,%20java.util.List)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/java/util/List conferenceableConnections) ` Indicates that the `RemoteConnection`s with which this `RemoteConnection` may be asked to create a conference has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onConnectionCapabilitiesChanged(android.telecom.RemoteConnection,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, int connectionCapabilities) ` Indicates that the call capabilities of this `RemoteConnection` have changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onConnectionEvent(android.telecom.RemoteConnection,%20java.lang.String,%20android.os.Bundle)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/java/lang/String event, https://developer.android.com/reference/android/os/Bundle extras) ` Handles a connection event propagated to this `https://developer.android.com/reference/android/telecom/RemoteConnection`. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onConnectionPropertiesChanged(android.telecom.RemoteConnection,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, int connectionProperties) ` Indicates that the call properties of this `RemoteConnection` have changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onDestroyed(android.telecom.RemoteConnection)(https://developer.android.com/reference/android/telecom/RemoteConnection connection) ` Indicates that this `RemoteConnection` has been destroyed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onDisconnected(android.telecom.RemoteConnection,%20android.telecom.DisconnectCause)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/telecom/DisconnectCause disconnectCause) ` Invoked when this `RemoteConnection` is disconnected. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onExtrasChanged(android.telecom.RemoteConnection,%20android.os.Bundle)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/os/Bundle extras) ` Handles changes to the `RemoteConnection` extras. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onPostDialChar(android.telecom.RemoteConnection,%20char)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, char nextChar) ` Invoked when the post-dial sequence in the outgoing `Connection` has processed a character. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onPostDialWait(android.telecom.RemoteConnection,%20java.lang.String)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/java/lang/String remainingPostDialSequence) ` Invoked when the post-dial sequence in the outgoing `Connection` has reached a pause character. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onRingbackRequested(android.telecom.RemoteConnection,%20boolean)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, boolean ringback) ` Invoked when this `RemoteConnection` is requesting ringback. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onStateChanged(android.telecom.RemoteConnection,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, int state) ` Invoked when the state of this `RemoteConnection` has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onStatusHintsChanged(android.telecom.RemoteConnection,%20android.telecom.StatusHints)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/telecom/StatusHints statusHints) ` Indicates that the status hints of this `RemoteConnection` have changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onVideoProviderChanged(android.telecom.RemoteConnection,%20android.telecom.RemoteConnection.VideoProvider)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, https://developer.android.com/reference/android/telecom/RemoteConnection.VideoProvider videoProvider) ` Indicates that the `VideoProvider` associated with this `RemoteConnection` has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onVideoStateChanged(android.telecom.RemoteConnection,%20int)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, int videoState) ` Indicates that the video state of this `RemoteConnection` has changed. |
| ` void` | ` https://developer.android.com/reference/android/telecom/RemoteConnection.Callback#onVoipAudioChanged(android.telecom.RemoteConnection,%20boolean)(https://developer.android.com/reference/android/telecom/RemoteConnection connection, boolean isVoip) ` Indicates that the VOIP audio status of this `RemoteConnection` has changed. |
### Inherited methods
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `
Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `
Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class` ` https://developer.android.com/reference/java/lang/Object#getClass()() `
Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `
Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `
Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `
Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `
Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `
Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
## Public constructors
### Callback
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Callback ()
```
## Public methods
### onAddressChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onAddressChanged (RemoteConnection connection,
Uri address,
int presentation)
```
Indicates that the address (e.g., phone number) of this `RemoteConnection` has changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getAddress()` and `https://developer.android.com/reference/android/telecom/RemoteConnection#getAddressPresentation()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `address` | `Uri`: The new address of the `RemoteConnection`.
|
| `presentation` | `int`: The presentation requirements for the address. See `https://developer.android.com/reference/android/telecom/TelecomManager` for valid values.
|
### onCallerDisplayNameChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onCallerDisplayNameChanged (RemoteConnection connection,
String callerDisplayName,
int presentation)
```
Indicates that the caller display name of this `RemoteConnection` has changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getCallerDisplayName()` and `https://developer.android.com/reference/android/telecom/RemoteConnection#getCallerDisplayNamePresentation()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `callerDisplayName` | `String`: The new caller display name of the `RemoteConnection`.
|
| `presentation` | `int`: The presentation requirements for the handle. See `https://developer.android.com/reference/android/telecom/TelecomManager` for valid values.
|
### onConferenceChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onConferenceChanged (RemoteConnection connection,
RemoteConference conference)
```
Indicates that the `RemoteConference` that this `RemoteConnection` is a part of has changed.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `conference` | `RemoteConference`: The `RemoteConference` of which this `RemoteConnection` is a part, which may be `null`.
|
### onConferenceableConnectionsChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onConferenceableConnectionsChanged (RemoteConnection connection,
List conferenceableConnections)
```
Indicates that the `RemoteConnection`s with which this `RemoteConnection` may be asked to create a conference has changed.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `conferenceableConnections` | `List`: The `RemoteConnection`s with which this `RemoteConnection` may be asked to create a conference.
|
### onConnectionCapabilitiesChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onConnectionCapabilitiesChanged (RemoteConnection connection,
int connectionCapabilities)
```
Indicates that the call capabilities of this `RemoteConnection` have changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getConnectionCapabilities()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `connectionCapabilities` | `int`: The new capabilities of the `RemoteConnection`.
|
### onConnectionEvent
Added in [API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onConnectionEvent (RemoteConnection connection,
String event,
Bundle extras)
```
Handles a connection event propagated to this `https://developer.android.com/reference/android/telecom/RemoteConnection`.
Connection events originate from `https://developer.android.com/reference/android/telecom/Connection#sendConnectionEvent(java.lang.String,%20android.os.Bundle)`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `event` | `String`: The connection event.
|
| `extras` | `Bundle`: Extras associated with the event.
|
### onConnectionPropertiesChanged
Added in [API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onConnectionPropertiesChanged (RemoteConnection connection,
int connectionProperties)
```
Indicates that the call properties of this `RemoteConnection` have changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getConnectionProperties()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `connectionProperties` | `int`: The new properties of the `RemoteConnection`.
|
### onDestroyed
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onDestroyed (RemoteConnection connection)
```
Indicates that this `RemoteConnection` has been destroyed. No further requests should be made to the `RemoteConnection`, and references to it should be cleared.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
### onDisconnected
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onDisconnected (RemoteConnection connection,
DisconnectCause disconnectCause)
```
Invoked when this `RemoteConnection` is disconnected.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `disconnectCause` | `DisconnectCause`: The (`https://developer.android.com/reference/android/telecom/DisconnectCause`) associated with this failed connection.
|
### onExtrasChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onExtrasChanged (RemoteConnection connection,
Bundle extras)
```
Handles changes to the `RemoteConnection` extras.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `extras` | `Bundle`: The extras containing other information associated with the connection. This value may be `null`.
|
### onPostDialChar
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onPostDialChar (RemoteConnection connection,
char nextChar)
```
Invoked when the post-dial sequence in the outgoing `Connection` has processed a character.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `nextChar` | `char`: The character being processed.
|
### onPostDialWait
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onPostDialWait (RemoteConnection connection,
String remainingPostDialSequence)
```
Invoked when the post-dial sequence in the outgoing `Connection` has reached a pause character. This causes the post-dial signals to stop pending user confirmation. An implementation should present this choice to the user and invoke `https://developer.android.com/reference/android/telecom/RemoteConnection#postDialContinue(boolean)` when the user makes the choice.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `remainingPostDialSequence` | `String`: The post-dial characters that remain to be sent.
|
### onRingbackRequested
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onRingbackRequested (RemoteConnection connection,
boolean ringback)
```
Invoked when this `RemoteConnection` is requesting ringback. See `https://developer.android.com/reference/android/telecom/RemoteConnection#isRingbackRequested()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `ringback` | `boolean`: Whether the `RemoteConnection` is requesting ringback.
|
### onStateChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onStateChanged (RemoteConnection connection,
int state)
```
Invoked when the state of this `RemoteConnection` has changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getState()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `state` | `int`: The new state of the `RemoteConnection`.
|
### onStatusHintsChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onStatusHintsChanged (RemoteConnection connection,
StatusHints statusHints)
```
Indicates that the status hints of this `RemoteConnection` have changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getStatusHints()` ()}.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `statusHints` | `StatusHints`: The new status hints of the `RemoteConnection`.
|
### onVideoProviderChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onVideoProviderChanged (RemoteConnection connection,
RemoteConnection.VideoProvider videoProvider)
```
Indicates that the `VideoProvider` associated with this `RemoteConnection` has changed.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `videoProvider` | `RemoteConnection.VideoProvider`: The new `VideoProvider` associated with this `RemoteConnection`.
|
### onVideoStateChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onVideoStateChanged (RemoteConnection connection,
int videoState)
```
Indicates that the video state of this `RemoteConnection` has changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#getVideoState()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `videoState` | `int`: The new video state of the `RemoteConnection`.
|
### onVoipAudioChanged
Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void onVoipAudioChanged (RemoteConnection connection,
boolean isVoip)
```
Indicates that the VOIP audio status of this `RemoteConnection` has changed. See `https://developer.android.com/reference/android/telecom/RemoteConnection#isVoipAudioMode()`.
| Parameters ||
|---|---|
| `connection` | `RemoteConnection`: The `RemoteConnection` invoking this method.
|
| `isVoip` | `boolean`: Whether the new audio state of the `RemoteConnection` is VOIP.
|