CallEventCallback | API reference

public interface CallEventCallback

android.telecom.CallEventCallback

CallEventCallback relays call updates (that do not require any action) from the Telecom framework out to the application. This can include operations which the app must implement on a Call due to the presence of other calls on the device, requests relayed from a Bluetooth device, or from another calling surface.

Summary

Public methods
`abstract void`	`onAvailableCallEndpointsChanged(List<CallEndpoint> availableEndpoints)` Telecom is informing the client that the available `CallEndpoint`s have changed.
`abstract void`	`onCallEndpointChanged(CallEndpoint newCallEndpoint)` Telecom is informing the client the current `CallEndpoint` changed.
`abstract void`	`onCallStreamingFailed(int reason)` Telecom is informing the client user requested call streaming but the stream can't be started.
`abstract void`	`onEvent(String event, Bundle extras)` Informs this `CallEventCallback` on events raised from a `InCallService` presenting this call.
`abstract void`	`onMuteStateChanged(boolean isMuted)` Called when the mute state changes.
`default void`	`onVideoStateChanged(int videoState)` Called when the video state changes.

Public methods

onAvailableCallEndpointsChanged

public abstract void onAvailableCallEndpointsChanged (List<CallEndpoint> availableEndpoints)

Telecom is informing the client that the available CallEndpoints have changed.

Parameters
`availableEndpoints`	`List`: The set of available `CallEndpoint`s reported by Telecom. This value cannot be `null`.

onCallEndpointChanged

public abstract void onCallEndpointChanged (CallEndpoint newCallEndpoint)

Telecom is informing the client the current CallEndpoint changed.

Parameters
`newCallEndpoint`	`CallEndpoint`: The new `CallEndpoint` through which call media flows (i.e. speaker, bluetooth, etc.). This value cannot be `null`.

onCallStreamingFailed

public abstract void onCallStreamingFailed (int reason)

Telecom is informing the client user requested call streaming but the stream can't be started.

Parameters
`reason`	`int`: Code to indicate the reason of this failure. Value is one of the following:

onEvent

public abstract void onEvent (String event, 
                Bundle extras)

Informs this CallEventCallback on events raised from a InCallService presenting this call. These events and the associated extra keys for the Bundle parameter are mutually defined by a VoIP application and InCallService. This enables alternative calling surfaces, such as an automotive UI, to relay requests to perform other non-standard call actions to the app. For example, an automotive calling solution may offer the ability for the user to raise their hand during a meeting.

Parameters
`event`	`String`: a string event identifier agreed upon between a VoIP application and an `InCallService` This value cannot be `null`.
`extras`	`Bundle`: a `Bundle` containing information about the event, as agreed upon between a VoIP application and `InCallService`. This value cannot be `null`.

onMuteStateChanged

public abstract void onMuteStateChanged (boolean isMuted)

Called when the mute state changes.

Parameters
`isMuted`	`boolean`: The current mute state.

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.