TelephonyManager

Broadcast intent action indicating that the call state (cellular) on the device has changed.

The EXTRA_STATE extra indicates the new call state. If the new state is RINGING, a second extra EXTRA_INCOMING_NUMBER provides the incoming phone number as a String.

Requires the READ_PHONE_STATE permission.

This was a sticky broadcast in version 1.0, but it is no longer sticky. Instead, use getCallState() to synchronously query the current call state.

The Phone app sends this intent when a user opts to respond-via-message during an incoming call. By default, the device's default SMS app consumes this message and sends a text message to the caller. A third party app can also provide this functionality by consuming this Intent with a Service and sending the message using its own messaging system.

The intent contains a URI (available from getData()) describing the recipient, using either the sms:, smsto:, mms:, or mmsto: URI schema. Each of these URI schema carry the recipient information the same way: the path part of the URI contains the recipient's phone number or a comma-separated set of phone numbers if there are multiple recipients. For example, smsto:2065551234.

The intent may also contain extras for the message text (in EXTRA_TEXT) and a message subject (in EXTRA_SUBJECT).

Note: The intent-filter that consumes this Intent needs to be in a Service that requires the permission SEND_RESPOND_VIA_MESSAGE.

For example, the service that receives this intent can be declared in the manifest file with an intent filter like this:

 <!-- Service that delivers SMS messages received from the phone "quick response" -->
 <service android:name=".HeadlessSmsSendService"
          android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE"
          android:exported="true" >
   <intent-filter>
     <action android:name="android.intent.action.RESPOND_VIA_MESSAGE" />
     <category android:name="android.intent.category.DEFAULT" />
     <data android:scheme="sms" />
     <data android:scheme="smsto" />
     <data android:scheme="mms" />
     <data android:scheme="mmsto" />
   </intent-filter>
 </service>

Output: nothing.

Device call state: No activity.

Device call state: Off-hook. At least one call exists that is dialing, active, or on hold, and no calls are ringing or waiting.

Device call state: Ringing. A new call arrived and is ringing or waiting. In the latter case, another call is already active.

Data connection is active, but physical link is down

Data connection activity: Currently receiving IP PPP traffic.

Data connection activity: Currently both sending and receiving IP PPP traffic.

Data connection activity: No traffic.

Data connection activity: Currently sending IP PPP traffic.

Data connection state: Connected. IP traffic should be available.

Data connection state: Currently setting up a data connection.

Data connection state: Disconnected. IP traffic not available.

Data connection state: Suspended. The connection is up, but IP traffic is temporarily unavailable. For example, in a 2G network, data activity may be suspended when a voice call arrives.

The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the incoming phone number. Only valid when the new call state is RINGING.

Retrieve with getStringExtra(String).

The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the new call state.

Current network is 1xRTT

Current network is CDMA: Either IS95A or IS95B

Current network is EDGE

Current network is eHRPD

Current network is EVDO revision 0

Current network is EVDO revision A

Current network is EVDO revision B

Current network is GPRS

Current network is HSDPA

Current network is HSPA

Current network is HSPA+

Current network is HSUPA

Current network is iDen

Current network is LTE

Current network is UMTS

Network type is unknown

Phone radio is CDMA.

Phone radio is GSM.

No phone radio.

Phone is via SIP.

SIM card state: no SIM card is available in the device

SIM card state: Locked: requires a network PIN to unlock

SIM card state: Locked: requires the user's SIM PIN to unlock

SIM card state: Locked: requires the user's SIM PUK to unlock

SIM card state: Ready

SIM card state: Unknown. Signifies that the SIM is in transition between states. For example, when the user inputs the SIM pin under PIN_REQUIRED state, a query for sim status returns this state before turning to SIM_STATE_READY. These are the ordinal value of IccCardConstants.State.

Value used with EXTRA_STATE corresponding to CALL_STATE_IDLE.

Value used with EXTRA_STATE corresponding to CALL_STATE_OFFHOOK.

Value used with EXTRA_STATE corresponding to CALL_STATE_RINGING.

Returns all observed cell information from all radios on the device including the primary and neighboring cells. This does not cause or change the rate of PhoneStateListner#onCellInfoChanged.

The list can include one or more of CellInfoGsm, CellInfoCdma, CellInfoLte and CellInfoCdma in any combination. Specifically on devices with multiple radios it is typical to see instances of one or more of any these in the list. In addition 0, 1 or more CellInfo objects may return isRegistered() true.

This is preferred over using getCellLocation although for older devices this may return null in which case getCellLocation should be called.

Returns a constant indicating the call state (cellular) on the device.

Returns the current location of the device.

If there is only one radio in the device and that radio has an LTE connection, this method will return null. The implementation must not to try add LTE identifiers into the existing cdma/gsm classes.

In the future this call will be deprecated.

Returns a constant indicating the type of activity on a data connection (cellular).

Returns a constant indicating the current data connection state (cellular).

Returns the unique device ID, for example, the IMEI for GSM and the MEID or ESN for CDMA phones. Return null if device ID is not available.

Requires Permission: READ_PHONE_STATE

Returns the software version number for the device, for example, the IMEI/SV for GSM phones. Return null if the software version is not available.

Requires Permission: READ_PHONE_STATE

Returns the Group Identifier Level1 for a GSM phone. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE

Returns the phone number string for line 1, for example, the MSISDN for a GSM phone. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE

Returns the MMS user agent profile URL.

Returns the MMS user agent.

Returns the neighboring cell information of the device. The getAllCellInfo is preferred and use this only if getAllCellInfo return nulls or an empty list.

In the future this call will be deprecated.

Returns the ISO country code equivalent of the current registered operator's MCC (Mobile Country Code).

Availability: Only when user is registered to a network. Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).

Returns the numeric name (MCC+MNC) of current registered operator.

Availability: Only when user is registered to a network. Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).

Returns the alphabetic name of current registered operator.

Availability: Only when user is registered to a network. Result may be unreliable on CDMA networks (use getPhoneType() to determine if on a CDMA network).

Returns a constant indicating the device phone type. This indicates the type of radio used to transmit voice calls.

Returns the ISO country code equivalent for the SIM provider's country code.

Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM. 5 or 6 decimal digits.

Availability: SIM state must be SIM_STATE_READY

Returns the Service Provider Name (SPN).

Availability: SIM state must be SIM_STATE_READY

Returns the serial number of the SIM, if applicable. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE

Returns a constant indicating the state of the default SIM card.

Returns the unique subscriber ID, for example, the IMSI for a GSM phone. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE

Retrieves the alphabetic identifier associated with the voice mail number.

Requires Permission: READ_PHONE_STATE

Returns the voice mail number. Return null if it is unavailable.

Requires Permission: READ_PHONE_STATE

Closes a previously opened logical channel to the ICC card. Input parameters equivalent to TS 27.007 AT+CCHC command.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges

Returns the response APDU for a command APDU sent through SIM_IO.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges

Opens a logical channel to the ICC card. Input parameters equivalent to TS 27.007 AT+CCHO command.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges

Transmit an APDU to the ICC card over the basic channel. Input parameters equivalent to TS 27.007 AT+CSIM command.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges

Transmit an APDU to the ICC card over a logical channel. Input parameters equivalent to TS 27.007 AT+CGLA command.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges

Returns true if the device is considered roaming on the current network, for GSM purposes.

Availability: Only when user registered to a network.

Registers a listener object to receive notification of changes in specified telephony states.

To register a listener, pass a PhoneStateListener and specify at least one telephony state of interest in the events argument. At registration, and when a specified telephony state changes, the telephony manager invokes the appropriate callback method on the listener object and passes the current (updated) values.

To unregister a listener, pass the listener object and set the events argument to LISTEN_NONE (0).

Send ENVELOPE to the SIM and return the response.

Requires Permission: MODIFY_PHONE_STATE Or the calling app has carrier privileges. @see #hasCarrierPrivileges