Callback

HANDOVER_FAILURE_DEST_APP_REJECTED

static val HANDOVER_FAILURE_DEST_APP_REJECTED: Int

Handover failure reason returned via onHandoverFailed(android.telecom.Call,int) when the app to handover the call to rejects the handover request.

Will be returned when Call.handoverTo(PhoneAccountHandle, int, Bundle) is called and the destination PhoneAccountHandle's ConnectionService returns a null Connection from ConnectionService.onCreateOutgoingHandoverConnection(PhoneAccountHandle,.

For more information on call handovers, see handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle).

Value: 1

HANDOVER_FAILURE_NOT_SUPPORTED

static val HANDOVER_FAILURE_NOT_SUPPORTED: Int

Handover failure reason returned via onHandoverFailed(android.telecom.Call,int) when a handover is initiated but the source or destination app does not support handover.

Will be returned when a handover is requested via handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle) and the destination PhoneAccountHandle does not declare PhoneAccount.EXTRA_SUPPORTS_HANDOVER_TO. May also be returned when a handover is requested at the PhoneAccountHandle for the current call (i.e. the source call's Details.getAccountHandle()) does not declare PhoneAccount.EXTRA_SUPPORTS_HANDOVER_FROM.

For more information on call handovers, see handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle).

Value: 2

HANDOVER_FAILURE_ONGOING_EMERGENCY_CALL

static val HANDOVER_FAILURE_ONGOING_EMERGENCY_CALL: Int

Handover failure reason returned via onHandoverFailed(android.telecom.Call,int) when there is ongoing emergency call.

This error code is returned when handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle) is called on an emergency call, or if any other call is an emergency call.

Handovers are not permitted while there are ongoing emergency calls.

For more information on call handovers, see handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle).

Value: 4

HANDOVER_FAILURE_UNKNOWN

static val HANDOVER_FAILURE_UNKNOWN: Int

Handover failure reason returned via onHandoverFailed(android.telecom.Call,int) when a handover fails for an unknown reason.

For more information on call handovers, see handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle).

Value: 5

HANDOVER_FAILURE_USER_REJECTED

static val HANDOVER_FAILURE_USER_REJECTED: Int

Handover failure reason returned via onHandoverFailed(android.telecom.Call,int) when the remote user rejects the handover request.

For more information on call handovers, see handoverTo(android.telecom.PhoneAccountHandle,int,android.os.Bundle).

Value: 3

onCallDestroyed

open fun onCallDestroyed(call: Call!): Unit

Invoked when the Call is destroyed. Clients should refrain from cleaning up their UI for the Call in response to state transitions. Specifically, clients should not assume that a onStateChanged(android.telecom.Call,int) with a state of STATE_DISCONNECTED is the final notification the Call will send. Rather, clients should wait for this method to be invoked.

onCannedTextResponsesLoaded

open fun onCannedTextResponsesLoaded(
    call: Call!, 
    cannedTextResponses: MutableList<String!>!
): Unit

Invoked when the text messages that can be used as responses to the incoming Call are loaded from the relevant database. See getCannedTextResponses().

onChildrenChanged

open fun onChildrenChanged(
    call: Call!, 
    children: MutableList<Call!>!
): Unit

Invoked when the children of this Call have changed. See getChildren().

onConferenceableCallsChanged

open fun onConferenceableCallsChanged(
    call: Call!, 
    conferenceableCalls: MutableList<Call!>!
): Unit

Invoked upon changes to the set of Calls with which this Call can be conferenced.

onConnectionEvent

open fun onConnectionEvent(
    call: Call!, 
    event: String!, 
    extras: Bundle!
): Unit

Invoked when a Call receives an event from its associated Connection or Conference.

Where possible, the Call should make an attempt to handle Connection events which are part of the android.telecom.* namespace. The Call should ignore any events it does not wish to handle. Unexpected events should be handled gracefully, as it is possible that a ConnectionService has defined its own Connection events which a Call is not aware of.

See Connection.sendConnectionEvent(String, Bundle), Conference.sendConferenceEvent(String, Bundle).

onDetailsChanged

open fun onDetailsChanged(
    call: Call!, 
    details: Call.Details!
): Unit

Invoked when the details of this Call have changed. See getDetails().

onHandoverComplete

open fun onHandoverComplete(call: Call!): Unit

Invoked when Call handover from one PhoneAccount to other PhoneAccount has completed successfully.

For a full discussion of the handover process and the APIs involved, see android.telecom.Call#handoverTo(PhoneAccountHandle, int, Bundle).

onHandoverFailed

open fun onHandoverFailed(
    call: Call!, 
    failureReason: Int
): Unit

Invoked when Call handover from one PhoneAccount to other PhoneAccount has failed.

For a full discussion of the handover process and the APIs involved, see android.telecom.Call#handoverTo(PhoneAccountHandle, int, Bundle).

onParentChanged

open fun onParentChanged(
    call: Call!, 
    parent: Call!
): Unit

Invoked when the parent of this Call has changed. See getParent().

onPostDialWait

open fun onPostDialWait(
    call: Call!, 
    remainingPostDialSequence: String!
): Unit

Invoked when the post-dial sequence in the outgoing Call 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 postDialContinue(boolean) when the user makes the choice.

onRttInitiationFailure

open fun onRttInitiationFailure(
    call: Call!, 
    reason: Int
): Unit

Invoked when the RTT session failed to initiate for some reason, including rejection by the remote party.

This callback will ONLY be invoked to report a failure related to a user initiated session modification request (i.e. Call.sendRttRequest()).

If a call is initiated with TelecomManager.EXTRA_START_CALL_WITH_RTT specified, the availability of RTT can be determined by checking Details.PROPERTY_RTT once the call enters state Details.STATE_ACTIVE.

onRttModeChanged

open fun onRttModeChanged(
    call: Call!, 
    mode: Int
): Unit

Invoked when the RTT mode changes for this call.

onRttRequest

open fun onRttRequest(
    call: Call!, 
    id: Int
): Unit

Invoked when the remote end of the connection has requested that an RTT communication channel be opened. A response to this should be sent via respondToRttRequest with the same ID that this method is invoked with.

onRttStatusChanged

open fun onRttStatusChanged(
    call: Call!, 
    enabled: Boolean, 
    rttCall: Call.RttCall!
): Unit

Invoked when the call's RTT status changes, either from off to on or from on to off.

onStateChanged

open fun onStateChanged(
    call: Call!, 
    state: Int
): Unit

Invoked when the state of this Call has changed. See getState().

onVideoCallChanged

open fun onVideoCallChanged(
    call: Call!, 
    videoCall: InCallService.VideoCall!
): Unit

Invoked when the Call.VideoCall of the Call has changed.