File Doc Category Size Date Package
TelephonyIntents.java API Doc Android 5.1 API 16985 Thu Mar 12 22:22:42 GMT 2015 com.android.internal.telephony

TelephonyIntents

java.lang.Object

public class TelephonyIntents extends Object

The intents that the telephony services broadcast.

THESE ARE NOT THE API! Use the {@link android.telephony.TelephonyManager} class. DON'T LISTEN TO THESE DIRECTLY.

Fields Summary
public static final String
ACTION_SERVICE_STATE_CHANGED
Broadcast Action: The phone service state has changed. The intent will have the following extra values:

state - An int with one of the following values: {@link android.telephony.ServiceState#STATE_IN_SERVICE}, {@link android.telephony.ServiceState#STATE_OUT_OF_SERVICE}, {@link android.telephony.ServiceState#STATE_EMERGENCY_ONLY} or {@link android.telephony.ServiceState#STATE_POWER_OFF}
roaming - A boolean value indicating whether the phone is roaming.

operator-alpha-long - The carrier name as a string.

operator-alpha-short - A potentially shortened version of the carrier name, as a string.

operator-numeric - A number representing the carrier, as a string. This is a five or six digit number consisting of the MCC (Mobile Country Code, 3 digits) and MNC (Mobile Network code, 2-3 digits).

manual - A boolean, where true indicates that the user has chosen to select the network manually, and false indicates that network selection is handled by the phone.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_RADIO_TECHNOLOGY_CHANGED
Broadcast Action: The radio technology has changed. The intent will have the following extra values:

phoneName - A string version of the new phone name.

You can not receive this through components declared in manifests, only by explicitly registering for it with {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter) Context.registerReceiver()}.
Requires no permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_EMERGENCY_CALLBACK_MODE_CHANGED
Broadcast Action: The emergency callback mode is changed.

phoneinECMState - A boolean value,true=phone in ECM, false=ECM off

You can not receive this through components declared in manifests, only by explicitly registering for it with {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter) Context.registerReceiver()}.
Requires no permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_SIGNAL_STRENGTH_CHANGED
Broadcast Action: The phone's signal strength has changed. The intent will have the following extra values:

phoneName - A string version of the phone name.

asu - A numeric value for the signal strength. An ASU is 0-31 or -1 if unknown (for GSM, dBm = -113 - 2 * asu). The following special values are defined:
0 means "-113 dBm or less".
31 means "-51 dBm or greater".

You can not receive this through components declared in manifests, only by exlicitly registering for it with {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter) Context.registerReceiver()}.
Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_ANY_DATA_CONNECTION_STATE_CHANGED
Broadcast Action: The data connection state has changed for any one of the phone's mobile data connections (eg, default, MMS or GPS specific connection). The intent will have the following extra values:

phoneName
A string version of the phone name.

state
One of {@code CONNECTED}, {@code CONNECTING}, or {@code DISCONNECTED}.

apn
A string that is the APN associated with this connection.

apnType
A string array of APN types associated with this connection. The APN type {@code *} is a special type that means this APN services all types.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_DATA_CONNECTION_CONNECTED_TO_PROVISIONING_APN
Broadcast Action: Occurs when a data connection connects to a provisioning apn and is broadcast by the low level data connection code. The intent will have the following extra values:

apn
A string that is the APN associated with this connection.

apnType
A string array of APN types associated with this connection. The APN type {@code *} is a special type that means this APN services all types.

linkProperties
{@code LinkProperties} for this APN.

linkCapabilities
The {@code LinkCapabilities} for this APN.

iface
A string that is the name of the interface.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_DATA_CONNECTION_FAILED
Broadcast Action: An attempt to establish a data connection has failed. The intent will have the following extra values:

phoneName
A string version of the phone name.

state
One of {@code CONNECTED}, {@code CONNECTING}, or {code DISCONNECTED}.

reason
A string indicating the reason for the failure, if available.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_SIM_STATE_CHANGED
Broadcast Action: The sim card state has changed. The intent will have the following extra values:

phoneName
A string version of the phone name.

ss
The sim state. One of:

{@code ABSENT}
SIM card not found

{@code LOCKED}
SIM card locked (see {@code reason})

{@code READY}
SIM card ready

{@code IMSI}
FIXME: what is this state?

{@code LOADED}
SIM card data loaded

reason
The reason why ss is {@code LOCKED}; null otherwise.

{@code PIN}
locked on PIN1

{@code PUK}
locked on PUK1

{@code NETWORK}
locked on network personalization

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_NETWORK_SET_TIME
Broadcast Action: The time was set by the carrier (typically by the NITZ string). This is a sticky broadcast. The intent will have the following extra values:

time - The time as a long in UTC milliseconds.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_NETWORK_SET_TIMEZONE
Broadcast Action: The timezone was set by the carrier (typically by the NITZ string). This is a sticky broadcast. The intent will have the following extra values:

time-zone - The java.util.TimeZone.getID() value identifying the new time zone.

Requires the READ_PHONE_STATE permission.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS
Broadcast Action: It indicates the Emergency callback mode blocks datacall/sms
. This is to pop up a notice to show user that the phone is in emergency callback mode and atacalls and outgoing sms are blocked.
This is a protected intent that can only be sent by the system.
public static final String
ACTION_CARRIER_SETUP
Activity Action: Start this activity to invoke the carrier setup app. The carrier app must be signed using a certificate that matches the UICC access rules.
Callers of this should hold the android.permission.INVOKE_CARRIER_SETUP permission.
public static final String
ACTION_FORBIDDEN_NO_SERVICE_AUTHORIZATION
Broadcast Action: Indicates that the action is forbidden by network.
This is for the OEM applications to understand about possible provisioning issues. Used in OMA-DM applications.
public static final String
SECRET_CODE_ACTION
Broadcast Action: A "secret code" has been entered in the dialer. Secret codes are of the form {@code *#*##*#*}. The intent will have the data URI: {@code android_secret_code://}
public static final String
SPN_STRINGS_UPDATED_ACTION
Broadcast Action: The Service Provider string(s) have been updated. Activities or services that use these strings should update their display. The intent will have the following extra values:

showPlmn
Boolean that indicates whether the PLMN should be shown.

plmn
The operator name of the registered network, as a string.

showSpn
Boolean that indicates whether the SPN should be shown.

spn
The service provider name, as a string.

Note that showPlmn may indicate that plmn should be displayed, even though the value for plmn is null. This can happen, for example, if the phone has not registered to a network yet. In this case the receiver may substitute an appropriate placeholder string (eg, "No service"). It is recommended to display plmn before / above spn if both are displayed.
Note: this is a protected intent that can only be sent by the system.
public static final String
EXTRA_SHOW_PLMN
public static final String
EXTRA_PLMN
public static final String
EXTRA_SHOW_SPN
public static final String
EXTRA_SPN
public static final String
ACTION_SUBINFO_CONTENT_CHANGE
Broadcast Action: It indicates one column of a subinfo record has been changed
This is a protected intent that can only be sent by the system.
public static final String
ACTION_SUBINFO_RECORD_UPDATED
Broadcast Action: It indicates subinfo record update is completed when SIM inserted state change
This is a protected intent that can only be sent by the system.
public static final String
ACTION_DEFAULT_SUBSCRIPTION_CHANGED
Broadcast Action: The default subscription has changed. This has the following extra values:

subscription - A int, the current default subscription.

public static final String
ACTION_DEFAULT_DATA_SUBSCRIPTION_CHANGED
Broadcast Action: The default data subscription has changed. This has the following extra values:

subscription - A int, the current data default subscription.

public static final String
ACTION_DEFAULT_VOICE_SUBSCRIPTION_CHANGED
Broadcast Action: The default voice subscription has changed. This has the following extra values:

subscription - A int, the current voice default subscription.

public static final String
ACTION_DEFAULT_SMS_SUBSCRIPTION_CHANGED
Broadcast Action: The default sms subscription has changed. This has the following extra values:

subscription - A int, the current sms default subscription.

public static final String
ACTION_SET_RADIO_CAPABILITY_DONE
public static final String
EXTRA_RADIO_ACCESS_FAMILY
public static final String
ACTION_SET_RADIO_CAPABILITY_FAILED
Constructors Summary
Methods Summary