public class CallActionAdapter

Object
CallActionAdapter

A CallActionListener whose methods all do nothing, for overriding the few that matter.

Note that leaving providerReset() as a no-op is a real decision and usually the wrong one – see the method on the interface.

Constructors

public CallActionAdapter()

Methods

`public void answerRequested(String callId, CallAction action)`	The user answered.
`public void endRequested(String callId, CallAction action)`	The user hung up.
`public void holdRequested(String callId, boolean held, CallAction action)`	The user held or resumed the call, or the system did in order to give the audio to something else.
`public void muteRequested(String callId, boolean muted, CallAction action)`	The user muted or unmuted the call.
`public void dtmfRequested(String callId, String digits, CallAction action)`	The user typed on the system keypad.
`public void startCallRequested(String callId, CallHandle handle, boolean video, CallAction action)`	The system is asking this app to place a call: the user tapped an entry in Recents, or asked a voice assistant to call somebody through this app.
`public void audioSessionActivated(CallAudioSession session)`	The operating system has activated the audio session.
`public void audioSessionDeactivated(String callId)`	The operating system has taken the audio back.
`public void callEnded(String callId, CallEndReason reason)`	The call ended for a reason that did not come from this app – the far end hung up, or the system ended it.
`public void providerReset()`	Every call this app had is gone.

Inherited methods

From Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait, clone

Constructor details

CallActionAdapter

public CallActionAdapter()

Method details

answerRequested

public void answerRequested(String callId, CallAction action)

The user answered. Start media when audioSessionActivated arrives, not here.

endRequested

public void endRequested(String callId, CallAction action)

The user hung up.

holdRequested

public void holdRequested(String callId, boolean held, CallAction action)

The user held or resumed the call, or the system did in order to give the audio to something else.

muteRequested

public void muteRequested(String callId, boolean muted, CallAction action)

The user muted or unmuted the call.

dtmfRequested

public void dtmfRequested(String callId, String digits, CallAction action)

The user typed on the system keypad.

startCallRequested

public void startCallRequested(String callId, CallHandle handle, boolean video, CallAction action)

The system is asking this app to place a call: the user tapped an entry in Recents, or asked a voice assistant to call somebody through this app. No call exists yet – report one with Calls.reportOutgoing using the id carried here.

Unlike every other action here, an unanswered request is failed rather than fulfilled, and the system call ends. Nothing else can place the call, so reporting success for a request the app ignored would leave it dialing for ever. An app that does not place calls on the system’s behalf can leave this alone; one that does must either report the call or answer the action itself.

audioSessionActivated

public void audioSessionActivated(CallAudioSession session)

The operating system has activated the audio session. This is where media starts. See CallAudioSession for why it is not where the call is answered.

audioSessionDeactivated

public void audioSessionDeactivated(String callId)

The operating system has taken the audio back. Stop media.

callEnded

public void callEnded(String callId, CallEndReason reason)

The call ended for a reason that did not come from this app – the far end hung up, or the system ended it.

providerReset

public void providerReset()

Every call this app had is gone.

The system’s call provider was reset, which happens when the user switches the app’s calling off or the platform recovers from an error. Tear down media and forget every session, but do not call CallSession.end on them: they no longer exist as far as the system is concerned, and ending a call on a reset provider is undefined.

An app that does not implement this leaks its media engine and shows calls that are not there.