FileDocCategorySizeDatePackage
TelephonyIntents.javaAPI DocAndroid 1.5 API6444Wed May 06 22:42:02 BST 2009com.android.internal.telephony

TelephonyIntents

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.

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.

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 "CONNECTED" "CONNECTING" or "DISCONNNECTED"
  • 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 "*" is a special type that means this APN services all types.

Requires the READ_PHONE_STATE permission.

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 &mdash A string version of the phone name.
  • state — One of "CONNECTED" "CONNECTING" or "DISCONNNECTED"
  • reason — A string indicating the reason for the failure, if available

Requires the READ_PHONE_STATE permission.

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 "ABSENT" "LOCKED" "READY" "ISMI" "LOADED"
  • reason - The reason while ss is LOCKED, otherwise is null "PIN" locked on PIN1 "PUK" locked on PUK1 "NETWORK" locked on Network Personalization

Requires the READ_PHONE_STATE permission.

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.

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.

Constructors Summary
Methods Summary