Android.Telephony Namespace

Provides access to cellular networks, cell and signal information, subscriptions, carrier settings, phone numbers, and SMS services.

Classes

Name Description
AccessNetworkConstants

Contains access network related constants.

AccessNetworkConstants.AccessNetworkType

Contains identifiers for radio access network families.

AccessNetworkConstants.EutranBand

Frequency bands for EUTRAN.

AccessNetworkConstants.GeranBand

Frequency bands for GERAN.

AccessNetworkConstants.NgranBands

Frequency bands for NGRAN https://www.

AccessNetworkConstants.UtranBand

Frequency bands for UTRAN.

AvailableNetworkInfo

Defines available network information which includes corresponding subscription id, network plmns and corresponding priority to be used for network selection by Opportunistic Network Service when passed through TelephonyManager#updateAvailableNetworks

AvailableNetworkInfo.Builder

Provides a convenient way to set the fields of a AvailableNetworkInfo when creating a new instance.

AvailableNetworkInfo.InterfaceConsts

Provides the inherited parcelable constants for AvailableNetworkInfo.

BarringInfo

Provides the barring configuration for a particular service type.

BarringInfo.BarringServiceInfo

Describe the current barring configuration of a cell

BarringInfo.BarringServiceInfo.InterfaceConsts

Provides the inherited parcelable constants for BarringInfo.BarringServiceInfo.

BarringInfo.InterfaceConsts

Provides the inherited parcelable constants for BarringInfo.

CarrierConfigManager

Provides access to telephony configuration values that are carrier-specific.

CarrierConfigManager.Apn

Configs used for APN setup.

CarrierConfigManager.Bsf

This groups the BSF (BootStrapping Function) related configs.

CarrierConfigManager.CarrierConfigChangeEventArgs

Contains event data for a change to carrier configuration.

CarrierConfigManager.Gps

GPS configs.

CarrierConfigManager.Ims

Configs used by the IMS stack.

CarrierConfigManager.ImsEmergency

Emergency Call/E911.

CarrierConfigManager.ImsRtt

IMS RTT configs.

CarrierConfigManager.ImsServiceEntitlement

Configs used by ImsServiceEntitlement.

CarrierConfigManager.ImsSms

IMS SMS configs.

CarrierConfigManager.ImsSs

IMS supplementary services configs.

CarrierConfigManager.ImsVoice

IMS Voice configs.

CarrierConfigManager.ImsVt

IMS Video Telephony configs.

CarrierConfigManager.ImsWfc

WiFi Calling.

CarrierConfigManager.Iwlan

Configs used for epdg tunnel bring up.

CarrierConfigManager.OpportunisticNetwork

Carrier configuration keys for opportunistic networks.

CellIdentity

CellIdentity represents the identity of a unique cell.

CellIdentity.InterfaceConsts

Provides the inherited parcelable constants for CellIdentity.

CellIdentityCdma

CellIdentity is to represent a unique CDMA cell

CellIdentityGsm

CellIdentity to represent a unique GSM cell

CellIdentityLte

CellIdentity is to represent a unique LTE cell

CellIdentityNr

Information to represent a unique NR(New Radio 5G) cell.

CellIdentityTdscdma

CellIdentity is to represent a unique TD-SCDMA cell

CellIdentityWcdma

CellIdentity to represent a unique UMTS cell

CellInfo

Immutable cell information from a point in time.

CellInfo.InterfaceConsts

Provides the inherited parcelable constants for CellInfo.

CellInfoCdma

A CellInfo representing a CDMA cell that provides identity and measurement info.

CellInfoGsm

A CellInfo representing a GSM cell that provides identity and measurement info.

CellInfoLte

A CellInfo representing an LTE cell that provides identity and measurement info.

CellInfoNr

A CellInfo representing an 5G NR cell that provides identity and measurement info.

CellInfoTdscdma

A CellInfo representing a TD-SCDMA cell that provides identity and measurement info.

CellInfoWcdma

A CellInfo representing a WCDMA cell that provides identity and measurement info.

CellLocation

Abstract class that represents the location of the device.

CellSignalStrength

Abstract base class for cell phone signal strength related information.

CellSignalStrengthCdma

Signal strength related information.

CellSignalStrengthCdma.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthCdma.

CellSignalStrengthGsm

GSM signal strength related information.

CellSignalStrengthGsm.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthGsm.

CellSignalStrengthLte

LTE signal strength related information.

CellSignalStrengthLte.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthLte.

CellSignalStrengthNr

5G NR signal strength related information.

CellSignalStrengthNr.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthNr.

CellSignalStrengthTdscdma

Tdscdma signal strength related information.

CellSignalStrengthTdscdma.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthTdscdma.

CellSignalStrengthWcdma

Wcdma signal strength related information.

CellSignalStrengthWcdma.InterfaceConsts

Provides the inherited parcelable constants for CellSignalStrengthWcdma.

ClosedSubscriberGroupInfo

Information to represent a closed subscriber group.

ClosedSubscriberGroupInfo.InterfaceConsts

Provides the inherited parcelable constants for ClosedSubscriberGroupInfo.

DataFailCause

DataFailCause collects data connection failure causes code from different sources.

DisconnectCause

Describes the cause of a disconnected call.

IccOpenLogicalChannelResponse

Response to the TelephonyManager#iccOpenLogicalChannel command.

IccOpenLogicalChannelResponse.InterfaceConsts

Provides the inherited parcelable constants for IccOpenLogicalChannelResponse.

MbmsDownloadSession

This class provides functionality for file download over MBMS.

MbmsGroupCallSession

This class provides functionality for accessing group call functionality over MBMS.

MbmsStreamingSession

This class provides functionality for streaming media over MBMS.

NeighboringCellInfo

Represents the neighboring cell information, including Received Signal Strength and Cell ID location.

NeighboringCellInfo.InterfaceConsts

Provides the inherited parcelable constants for NeighboringCellInfo.

NetworkRegistrationInfo

Description of a mobile network registration info

NetworkRegistrationInfo.InterfaceConsts

Provides the inherited parcelable constants for NetworkRegistrationInfo.

NetworkScan

The caller of TelephonyManager#requestNetworkScan(NetworkScanRequest, Executor, NetworkScanCallback) will receive an instance of NetworkScan, which contains a callback method #stopScan() for stopping the in-progress scan.

NetworkScanRequest

Defines a request to perform a network scan.

NetworkScanRequest.InterfaceConsts

Provides the inherited parcelable constants for NetworkScanRequest.

ParsedPhoneNumber

Handles the results from PhoneNumberManager by providing Phone number, error code, and is valid number.

ParsedPhoneNumber.InterfaceConsts

Provides the inherited parcelable constants for ParsedPhoneNumber.

PhoneNumberFormattingTextWatcher

Watches a android.widget.TextView and if a phone number is entered will format it.

PhoneNumberManager

PhoneNumberManager provides APIs for parsing phone numbers from various sources, such as URIs.

PhoneNumberUtils

Various utilities for dealing with phone number strings.

PhoneStateListener

A listener class for monitoring changes in specific telephony states on the device, including service state, signal strength, message waiting indicator (voicemail), and others.

PhysicalChannelConfig

Information describing the physical channel configuration.

PhysicalChannelConfig.InterfaceConsts

Provides the inherited parcelable constants for PhysicalChannelConfig.

PreciseDataConnectionState

Contains precise data connection state.

PreciseDataConnectionState.InterfaceConsts

Provides the inherited parcelable constants for PreciseDataConnectionState.

RadioAccessSpecifier

Describes a particular radio access network to be scanned.

RadioAccessSpecifier.InterfaceConsts

Provides the inherited parcelable constants for RadioAccessSpecifier.

ServiceState

Contains phone state and service related information.

ServiceState.InterfaceConsts

Provides the inherited parcelable constants for ServiceState.

SignalStrength

Contains phone signal strength related information.

SignalStrength.InterfaceConsts

Provides the inherited parcelable constants for SignalStrength.

SignalStrengthUpdateRequest

Request used to register SignalThresholdInfo to be notified when the signal strength breach the specified thresholds.

SignalStrengthUpdateRequest.Builder

Builder class to create SignalStrengthUpdateRequest object.

SignalStrengthUpdateRequest.InterfaceConsts

Provides the inherited parcelable constants for SignalStrengthUpdateRequest.

SignalThresholdInfo

Defines the threshold value of the signal strength.

SignalThresholdInfo.Builder

Builder class to create SignalThresholdInfo objects.

SignalThresholdInfo.InterfaceConsts

Provides the inherited parcelable constants for SignalThresholdInfo.

SmsManager

Manages SMS operations such as sending data, text, and pdu SMS messages.

SmsManager.FinancialSmsCallback

callback for providing asynchronous sms messages for financial app.

SmsMessage

A Short Message Service message.

SmsMessage.MessageClass

SMS Class enumeration.

SmsMessage.SubmitPdu

Contains encoded data for submitting an SMS message.

SubscriptionInfo

A Parcelable class for Subscription Information.

SubscriptionInfo.InterfaceConsts

Provides the inherited parcelable constants for SubscriptionInfo.

SubscriptionManager

Subscription manager provides the mobile subscription information.

SubscriptionManager.OnOpportunisticSubscriptionsChangedListener

A listener class for monitoring changes to SubscriptionInfo records of opportunistic subscriptions.

SubscriptionManager.OnSubscriptionsChangedListener

A listener class for monitoring changes to SubscriptionInfo records.

SubscriptionPlan

Description of a billing relationship plan between a carrier and a specific subscriber.

SubscriptionPlan.Builder

Builder for a SubscriptionPlan.

SubscriptionPlan.InterfaceConsts

Provides the inherited parcelable constants for SubscriptionPlan.

TelephonyCallback

A callback class for monitoring changes in specific telephony states on the device, including service state, signal strength, message waiting indicator (voicemail), and others.

TelephonyCallback.ActiveDataSubscriptionIdEventArgs

Contains event data for a change to the active data subscription.

TelephonyCallback.BarringInfoEventArgs

Contains event data for updated service barring information.

TelephonyCallback.CallDisconnectCauseEventArgs

Contains event data for a call disconnection.

TelephonyCallback.CallForwardingIndicatorEventArgs

Contains event data for a change to the call forwarding indicator.

TelephonyCallback.CallStateEventArgs

Contains event data for a change to the call state.

TelephonyCallback.CarrierNetworkEventArgs

Contains event data for a carrier network change.

TelephonyCallback.CarrierRoamingNtnAvailableServicesChangedEventArgs

Contains event data for a change to carrier roaming non-terrestrial network services.

TelephonyCallback.CarrierRoamingNtnEligibleStateChangedEventArgs

Contains event data for a change to carrier roaming non-terrestrial network eligibility.

TelephonyCallback.CarrierRoamingNtnModeChangedEventArgs

Contains event data for a change to carrier roaming non-terrestrial network mode.

TelephonyCallback.CarrierRoamingNtnSignalStrengthChangedEventArgs

Contains event data for a change to carrier roaming non-terrestrial network signal strength.

TelephonyCallback.CellInfoEventArgs

Contains event data for updated cell information.

TelephonyCallback.CellLocationEventArgs

Contains event data for a change to the cell location.

TelephonyCallback.DataActivationStateEventArgs

Contains event data for a change to SIM data activation.

TelephonyCallback.DataActivityEventArgs

Contains event data for a change to data activity.

TelephonyCallback.DataConnectionStateEventArgs

Contains event data for a change to the data connection.

TelephonyCallback.DisplayInfoEventArgs

Contains event data for a change to telephony display information.

TelephonyCallback.EmergencyNumberListEventArgs

Contains event data for a change to emergency number information.

TelephonyCallback.ImsCallDisconnectCauseEventArgs

Contains event data for an IMS call disconnection.

TelephonyCallback.MessageWaitingIndicatorEventArgs

Contains event data for a change to the message waiting indicator.

TelephonyCallback.PhysicalChannelConfigEventArgs

Contains event data for a change to physical channel configuration.

TelephonyCallback.PreciseDataConnectionStateEventArgs

Contains event data for a detailed data connection update.

TelephonyCallback.RegistrationFailedEventArgs

Contains event data for a failed network registration or area update.

TelephonyCallback.ServiceStateEventArgs

Contains event data for a change to the service state.

TelephonyCallback.SignalStrengthsEventArgs

Contains event data for a signal strength update.

TelephonyCallback.UserMobileDataStateEventArgs

Contains event data for a change to the user's mobile data setting.

TelephonyDisplayInfo

TelephonyDisplayInfo contains telephony-related information used for display purposes only.

TelephonyDisplayInfo.InterfaceConsts

Provides the inherited parcelable constants for TelephonyDisplayInfo.

TelephonyManager

Provides access to information about the telephony services on the device.

TelephonyManager.CallComposerException

Exception that may be supplied to the callback in #uploadCallComposerPicture if something goes awry.

TelephonyManager.CellInfoCallback

Callback for providing asynchronous CellInfo on request

TelephonyManager.ModemErrorException

Exception that is supplied to the callback in #getNetworkSlicingConfiguration if the modem returned a failure.

TelephonyManager.NetworkSlicingException

Exception that may be supplied to the callback in #getNetworkSlicingConfiguration if something goes awry.

TelephonyManager.TimeoutException

Exception that is supplied to the callback in #getNetworkSlicingConfiguration if the system timed out waiting for a response from the Radio.

TelephonyManager.UssdResponseCallback

Used to notify callers of TelephonyManager#sendUssdRequest(String, UssdResponseCallback, Handler) when the network either successfully executes a USSD request, or if there was a failure while executing the request.

TelephonyScanManager

Manages the radio access network scan requests and callbacks.

TelephonyScanManager.NetworkScanCallback

The caller of TelephonyManager#requestNetworkScan(NetworkScanRequest, Executor, NetworkScanCallback) should implement and provide this callback so that the scan results or errors can be returned.

UiccCardInfo

The UiccCardInfo represents information about a currently inserted UICC or embedded eUICC.

UiccCardInfo.InterfaceConsts

Provides the inherited parcelable constants for UiccCardInfo.

UiccPortInfo

UiccPortInfo class represents information about a single port contained on UiccCardInfo.

UiccPortInfo.InterfaceConsts

Provides the inherited parcelable constants for UiccPortInfo.

VisualVoicemailService

This service is implemented by dialer apps that wishes to handle OMTP or similar visual voicemails.

VisualVoicemailService.VisualVoicemailTask

Represents a visual voicemail event which needs to be handled.

VisualVoicemailSms

Represents the content of a visual voicemail SMS.

VisualVoicemailSms.InterfaceConsts

Provides the inherited parcelable constants for VisualVoicemailSms.

VisualVoicemailSmsFilterSettings

Class to represent various settings for the visual voicemail SMS filter.

VisualVoicemailSmsFilterSettings.Builder

Builder class for VisualVoicemailSmsFilterSettings objects.

VisualVoicemailSmsFilterSettings.InterfaceConsts

Provides the inherited parcelable constants for VisualVoicemailSmsFilterSettings.

Interfaces

Name Description
CarrierConfigManager.ICarrierConfigChangeListener

Listener interface to get a notification when the carrier configurations have changed.

TelephonyCallback.IActiveDataSubscriptionIdListener

Interface for active data subscription ID listener.

TelephonyCallback.IBarringInfoListener

Interface for barring information listener.

TelephonyCallback.ICallDisconnectCauseListener

Interface for call disconnect cause listener.

TelephonyCallback.ICallForwardingIndicatorListener

Interface for call-forwarding indicator listener.

TelephonyCallback.ICallStateListener

Interface for call state listener.

TelephonyCallback.ICarrierNetworkListener

Interface for carrier network listener.

TelephonyCallback.ICarrierRoamingNtnListener

Interface for carrier roaming non-terrestrial network listener.

TelephonyCallback.ICellInfoListener

Interface for cell info listener.

TelephonyCallback.ICellLocationListener

Interface for device cell location listener.

TelephonyCallback.IDataActivationStateListener

Interface for SIM data activation state listener.

TelephonyCallback.IDataActivityListener

Interface for data activity state listener.

TelephonyCallback.IDataConnectionStateListener

Interface for data connection state listener.

TelephonyCallback.IDisplayInfoListener

Interface for display info listener.

TelephonyCallback.IEmergencyNumberListListener

Interface for the current emergency number list listener.

TelephonyCallback.IImsCallDisconnectCauseListener

Interface for IMS call disconnect cause listener.

TelephonyCallback.IMessageWaitingIndicatorListener

Interface for message waiting indicator listener.

TelephonyCallback.IPhysicalChannelConfigListener

Interface for current physical channel configuration listener.

TelephonyCallback.IPreciseDataConnectionStateListener

Interface for precise data connection state listener.

TelephonyCallback.IRegistrationFailedListener

Interface for registration failures listener.

TelephonyCallback.IServiceStateListener

Interface for service state listener.

TelephonyCallback.ISignalStrengthsListener

Interface for network signal strengths listener.

TelephonyCallback.IUserMobileDataStateListener

Interface for user mobile data state listener.

Enums

Name Description
AllowedNetworkTypesReason

Identifies the policy that sets an allowed-network restriction.

AutheenticationType

Specifies the authentication procedure for a UICC challenge.

AvailableNetworkInfoPriority

Specifies the selection priority of an available network.

BarringServiceType

Identifies a service for which a cell reports access barring.

BarringType

Specifies how access to a service is barred.

BcdExtendedType

Selects the extended-character alphabet used for binary-coded decimal phone numbers.

CallComposerErrorCode

Identifies an error during a call composer picture upload.

CallComposerStatus

Specifies the call composer status from the user setting.

CallDisconnectCause

Identifies why a telephone call ended or could not be placed.

CallState

Enumerates values returned by several types and taken as a parameter of the F:Android.Telephony.PhoneStateListener.OnCallStateChanged member.

CarrierCallWaitingSyncType

Specifies how terminal-based IMS call waiting is synchronized with the carrier network.

CarrierImsSmsFormat

Specifies the SMS format used by the carrier's IMS configuration.

CarrierImsSupplementaryService

Identifies an IMS supplementary service in carrier configuration.

CarrierRestrictionStatus

Specifies the carrier restriction status for a device.

CellConnectionStatus

Specifies the connection role of a reported cell.

D2DSharing

Specifies which contacts can receive device status during a call.

DataActivity

Enumerates values returned by several types and taken as a parameter of the F:Android.Telephony.PhoneStateListener.OnDataActivity member.

DataConnectionStatus

Specifies the state of a cellular data connection.

DataEnabledReason

Identifies the policy responsible for enabling or disabling cellular data.

DataFailCauseType

Identifies a cellular data connection failure.

DataLimitBehavior

Specifies what a subscription plan does when its data limit is reached.

DataRoamingMode

Specifies whether data roaming is enabled for a subscription.

DuplexMode

Specifies how a radio network separates uplink and downlink transmissions.

EnhancedRoamingIndicator

Specifies the state of the legacy CDMA enhanced roaming indicator.

IccOpenLogicalChannelResponseStatus

Enumerates values returned by several types.

ImsEmergencyDomain

Specifies a domain used to select a network for emergency calls.

ImsEmergencyScanType

Specifies the network scan policy used for emergency service.

ImsEmergencyVoWifiRequires

Specifies additional conditions for an emergency call over Wi-Fi.

ImsGeolocationPidfFor

Identifies a scenario that requires geolocation PIDF XML in IMS signaling.

ImsIpsecAuthenticationAlgorithm

Specifies an IPsec authentication algorithm for IMS signaling.

ImsIpsecEncryptionAlgorithm

Specifies an IPsec encryption algorithm for IMS signaling.

ImsNetworkType

Identifies whether an IMS network is a home or roaming network.

ImsPreferredTransport

Specifies the preferred transport for IMS SIP messages.

ImsRequestUriFormat

Specifies the URI format for an IMS request.

ImsVoiceConferenceSubscribeType

Specifies how an IMS client subscribes to conference state events.

ImsVoiceEvsEncodedBwType

Specifies an encoded audio bandwidth or bandwidth range for the EVS codec.

ImsVoiceEvsOperationalMode

Specifies the operating mode of the EVS voice codec.

ImsVoiceEvsPrimaryModeBitrate

Specifies a coded bit-rate choice for EVS primary mode.

ImsVoicePayloadFormat

Specifies the RTP payload layout for AMR narrowband or wideband voice.

ImsVoiceSessionPrivacyType

Specifies a privacy service for an IMS voice session.

ImsVoiceSessionRefresherType

Specifies which SIP endpoint refreshes an IMS voice session.

ImsVoiceSessionRefreshMethod

Specifies the SIP method policy for refreshing an IMS voice session.

ImsVoiceSrvccSupport

Identifies a supported single-radio voice call continuity procedure.

IncludeLocationDataType

Specifies the location detail requested in telephony callbacks.

IwlanAuthenticationMethod

Specifies how an IWLAN connection authenticates the server.

IwlanEpdgAddressPreference

Specifies the IP address-family policy for an evolved packet data gateway.

IwlanEpdgAddressType

Specifies a source or selection rule for an evolved packet data gateway address.

IwlanIdType

Specifies the form of an IKE identity used for IWLAN.

MmsError

Enumerates values returned by several methods of MmsError.

MultiSimMode

Specifies whether simultaneous use of multiple SIM subscriptions is permitted.

NetworkRegistrationInfoDomain

Specifies the service domain of network registration information.

NetworkRegistrationInfoNrState

Specifies the NR state associated with LTE and NR dual connectivity.

NetworkRegistrationInfoServiceType

Identifies a service available through a network registration.

NetworkScanType

Specifies whether a network scan runs once or repeats.

NetworkSelectionMode

Specifies whether network selection is automatic, manual, or unknown.

NetworkType

Identifies the radio technology used by a telephony network.

OverrideNetworkType

Specifies a carrier display override for the network type.

ParsedPhoneNumberErrorType

Identifies an error while extracting or validating a phone number.

PhoneNumberFormat

Enumerates values returned by several types and taken as a parameter of the F:Android.Telephony.PhoneNumberUtils.FormatNumber member.

PhoneNumberSource

Identifies where a subscription's phone number was obtained.

PhoneNumberToa

Enumerates values returned by several types and taken as a parameter of the F:Android.Telephony.PhoneNumberUtils.StringFromStringAndTOA member.

PhoneState

Enumerates values returned by several types and taken as a parameter of the F:Android.Telephony.TelephonyManager.Listen, and F:Android.Telephony.TelephonyManager.Listen members.

PhoneStateListenerFlags

Enumerates values returned by several methods of PhoneStateListenerFlags and taken as a parameter of the F:Android.Telephony.TelephonyManager.Listen member.

PhoneType

Enumerates values returned by several types.

PhysicalChannelConnectionStatus

Specifies whether a physical channel serves the device as a primary or secondary connection.

PreciseDataConnectionStateNetworkValidation

Specifies the network validation state of a cellular data connection.

PremiumCapability

Identifies a premium network capability that an application can request to purchase.

PurchasePremiumCapabilityResult

Specifies the outcome of a premium network capability purchase request.

ScanResultCode

Identifies an error reported by a telephony network scan.

ServiceCapabilityType

Identifies a service capability of a subscription.

SignalMeasurementType

Identifies the radio signal measurement used by a signal threshold.

SimState

Enumerates values returned by several types.

SmsEncoding

Enumerates values returned by several methods of SmsEncoding.

SmsResult

Identifies a result or error reported by an SMS operation.

SmsResultError

Enumerates values returned by several methods of SmsResultError.

SmsRpCause

Identifies an SMS relay-protocol cause.

SmsStatus

Enumerates values returned by several types.

StreamingState

Specifies the state of an MBMS media stream.

SubscriptionPlanType

Specifies the category of a subscription plan.

SubscriptionStatus

Specifies the status of a subscription plan.

SubscriptionType

Specifies whether a subscription uses a local or remote SIM.

TelephonyManagerErrorCode

Identifies an error when requesting updated cell information.

TelephonyManagerTtyMode

Specifies the teletypewriter mode for telephone calls.

UiccApplicationType

Identifies the application selected on a UICC.

UsageSetting

Specifies a subscription's preferred voice-centric or data-centric use.

UssdResultCode

Identifies why a USSD request failed.