Android.Telecom Namespace

Provides Android framework APIs for call management, connection services, in-call user interfaces, call screening, and call redirection.

Classes

Name Description
Call

Represents an ongoing phone call that the in-call app should present to the user.

Call.Callback

Defines callbacks which inform the InCallService of changes to a Call.

Call.Details

Contains the state, routing, and other details of a call.

Call.RttCall

A class that holds the state that describes the state of the RTT channel to the remote party, if it is active.

CallAttributes

CallAttributes represents a set of properties that define a new Call.

CallAttributes.Builder

Build an instance of CallAttributes.

CallAttributes.InterfaceConsts

Contains the parcel constants inherited by CallAttributes.

CallAudioState

Encapsulates the telecom audio state, including the current audio routing, supported audio routing and mute.

CallAudioState.InterfaceConsts

Contains the parcel constants inherited by CallAudioState.

CallControl

CallControl provides client side control of a call.

CallEndpoint

Encapsulates the endpoint where call media can flow

CallEndpoint.InterfaceConsts

Contains the parcel constants inherited by CallEndpoint.

CallEndpointException

This class represents a set of exceptions that can occur when requesting a CallEndpoint change.

CallEndpointException.InterfaceConsts

Contains the parcel constants inherited by CallEndpointException.

CallException

This class defines exceptions that can be thrown when using Telecom APIs with android.os.OutcomeReceivers.

CallException.InterfaceConsts

Contains the parcel constants inherited by CallException.

CallRedirectionService

This service can be implemented to interact between Telecom and its implementor for making outgoing call with optional redirection/cancellation purposes.

CallScreeningService

This service can be implemented by the default dialer (see TelecomManager#getDefaultDialerPackage()) or a third party app to allow or disallow incoming calls before they are shown to a user.

CallScreeningService.CallResponse

Information about how to respond to an incoming call.

CallScreeningService.CallResponse.Builder

Builds screening responses from call handling and notification options.

Conference

Represents a conference call which can contain any number of Connection objects.

Conferenceable

Interface used to identify entities with which another entity can participate in a conference call with.

Connection

Represents a phone call or connection to a remote endpoint that carries voice and/or video traffic.

Connection.RttModifyStatus

Provides constants to represent the results of responses to session modify requests sent via Call#sendRttRequest()

Connection.RttTextStream

Provides methods to read and write RTT data to/from the in-call app.

Connection.VideoProvider

Provides a means of controlling the video session associated with a Connection.

ConnectionRequest

Simple data container encapsulating a request to some entity to create a new Connection.

ConnectionRequest.InterfaceConsts

Contains the parcel constants inherited by ConnectionRequest.

ConnectionService

An abstract service that should be implemented by any apps which either: <ol> <li>Can make phone calls (VoIP or otherwise) and want those calls to be integrated into the built-in phone app.

DisconnectCause

Describes the cause of a disconnected call.

DisconnectCause.InterfaceConsts

Contains the parcel constants inherited by DisconnectCause.

GatewayInfo

Encapsulated gateway address information for outgoing call.

GatewayInfo.InterfaceConsts

Contains the parcel constants inherited by GatewayInfo.

InCallService

This service is implemented by an app that wishes to provide functionality for managing phone calls.

InCallService.VideoCall

Used to issue commands to the Connection.VideoProvider associated with a Call.

InCallService.VideoCall.Callback

The InCallService extends this class to provide a means of receiving callbacks from the Connection.VideoProvider.

PhoneAccount

Represents a distinct method to place or receive a phone call.

PhoneAccount.Builder

Helper class for creating a PhoneAccount.

PhoneAccount.InterfaceConsts

Contains the parcel constants inherited by PhoneAccount.

PhoneAccountHandle

The unique identifier for a PhoneAccount.

PhoneAccountHandle.InterfaceConsts

Contains the parcel constants inherited by PhoneAccountHandle.

PhoneAccountSuggestion

Describes a phone account choice and its selection hints for a call.

PhoneAccountSuggestion.InterfaceConsts

Contains the parcel constants inherited by PhoneAccountSuggestion.

QueryLocationException

This class represents a set of exceptions that can occur when requesting a Connection#queryLocationForEmergency(long, String, Executor, OutcomeReceiver)

QueryLocationException.InterfaceConsts

Contains the parcel constants inherited by QueryLocationException.

RemoteConference

A conference provided to a ConnectionService by another ConnectionService through ConnectionService#conferenceRemoteConnections.

RemoteConference.Callback

Callback base class for RemoteConference.

RemoteConnection

A connection provided to a ConnectionService by another ConnectionService running in a different process.

RemoteConnection.Callback

Callback base class for RemoteConnection.

RemoteConnection.VideoProvider

RemoteConnection.VideoProvider associated with a RemoteConnection.

RemoteConnection.VideoProvider.Callback

Callback class used by the RemoteConnection.VideoProvider to relay events from the Connection.VideoProvider.

StatusHints

Contains status label and icon displayed in the in-call UI.

StatusHints.InterfaceConsts

Contains the parcel constants inherited by StatusHints.

TelecomManager

The Android Telecom framework manages audio and video calls on an Android device.

VideoProfile

Represents attributes of video calls.

VideoProfile.CameraCapabilities

Represents the camera capabilities important to a Video Telephony provider.

VideoProfile.CameraCapabilities.InterfaceConsts

Contains the parcel constants inherited by VideoProfile.CameraCapabilities.

VideoProfile.InterfaceConsts

Contains the parcel constants inherited by VideoProfile.

Interfaces

Name Description
ICallControlCallback

CallControlCallback relays call updates (that require a response) from the Telecom framework out to the application.

ICallEventCallback

CallEventCallback relays call updates (that do not require any action) from the Telecom framework out to the application.

Enums

Name Description
AudioProcessingUseCase

Identifies the purpose of background call audio processing.

CallAttributesDirection

Identifies whether a call is incoming or outgoing in its call attributes.

CallAudioRoute

Identifies call audio routes and route masks.

CallCapabilities

Specifies the optional operations supported by a call created with call attributes.

CallCapability

Specifies capability and related flags reported in call details.

CallComposerAttachment

Specifies which call composer attachments a screening response allows.

CallDirection

Identifies the direction of a call reported in call details.

CallEndpointErrorReason

Identifies why a call audio endpoint change failed.

CallEndpointType

Identifies the kind of audio endpoint used by a call.

CallExceptionErrorCode

Identifies an error in a call control operation.

CallProperty

Specifies properties reported in call details.

CallRejectReason

Identifies the reason given when rejecting a call.

CallState

Identifies the current state of a call.

CallType

Identifies the communication type declared in call attributes.

Causes

Identifies the reason a call was disconnected.

ConnectionAudioCodec

Identifies the audio codec reported for a connection.

ConnectionCapability

Specifies the operations and media features supported by a connection.

ConnectionProperties

Specifies properties reported by a connection.

ConnectionState

Identifies the current state of a connection.

ConnectionVerificationStatusType

Identifies the caller number verification result for a connection.

CrsMediaType

Specifies media types reported for a customized ringing signal.

Duration

Identifies a completed call's duration category.

HandoverFailureReason

Identifies why a call handover failed.

ModifyRequestResult

Identifies the result of a video session modification request.

PhoneAccountCapability

Specifies the services and features supported by a phone account.

Presentation

Enumerates values returned by several methods of Presentation.

Priority

Identifies the priority of a call composer call.

QueryLocationErrorReason

Identifies why a connection location query failed.

ReasonType

Identifies why a phone account was suggested for a call.

RttMode

Identifies the audio mode used with real-time text in a call.

RttSessionModifyResult

Identifies the result of a real-time text session modification request.

VideoProfileState

Specifies video transmission, reception, and pause state.

VideoQuality

Identifies a requested or reported video quality level.

VideoSessionEvent

Identifies an event reported by a connection's video provider.