1 package com.android.internal.telephony; 2 3 /** 4 * The intents that the telephony services broadcast. 5 * 6 * <p class="warning"> 7 * THESE ARE NOT THE API! Use the {@link android.telephony.TelephonyManager} class. 8 * DON'T LISTEN TO THESE DIRECTLY. 9 */ 10 public class TelephonyIntents { 11 12 /** 13 * Broadcast Action: The phone service state has changed. The intent will have the following 14 * extra values:</p> 15 * <ul> 16 * <li><em>state</em> - An int with one of the following values: 17 * {@link android.telephony.ServiceState#STATE_IN_SERVICE}, 18 * {@link android.telephony.ServiceState#STATE_OUT_OF_SERVICE}, 19 * {@link android.telephony.ServiceState#STATE_EMERGENCY_ONLY} 20 * or {@link android.telephony.ServiceState#STATE_POWER_OFF} 21 * <li><em>roaming</em> - A boolean value indicating whether the phone is roaming.</li> 22 * <li><em>operator-alpha-long</em> - The carrier name as a string.</li> 23 * <li><em>operator-alpha-short</em> - A potentially shortened version of the carrier name, 24 * as a string.</li> 25 * <li><em>operator-numeric</em> - A number representing the carrier, as a string. This is 26 * a five or six digit number consisting of the MCC (Mobile Country Code, 3 digits) 27 * and MNC (Mobile Network code, 2-3 digits).</li> 28 * <li><em>manual</em> - A boolean, where true indicates that the user has chosen to select 29 * the network manually, and false indicates that network selection is handled by the 30 * phone.</li> 31 * </ul> 32 * 33 * <p class="note"> 34 * Requires the READ_PHONE_STATE permission. 35 * 36 * <p class="note">This is a protected intent that can only be sent 37 * by the system. 38 */ 39 public static final String ACTION_SERVICE_STATE_CHANGED = "android.intent.action.SERVICE_STATE"; 40 41 /** 42 * <p>Broadcast Action: The radio technology has changed. The intent will have the following 43 * extra values:</p> 44 * <ul> 45 * <li><em>phoneName</em> - A string version of the new phone name.</li> 46 * </ul> 47 * 48 * <p class="note"> 49 * You can <em>not</em> receive this through components declared 50 * in manifests, only by explicitly registering for it with 51 * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, 52 * android.content.IntentFilter) Context.registerReceiver()}. 53 * 54 * <p class="note"> 55 * Requires no permission. 56 * 57 * <p class="note">This is a protected intent that can only be sent 58 * by the system. 59 */ 60 public static final String ACTION_RADIO_TECHNOLOGY_CHANGED 61 = "android.intent.action.RADIO_TECHNOLOGY"; 62 /** 63 * <p>Broadcast Action: The emergency callback mode is changed. 64 * <ul> 65 * <li><em>phoneinECMState</em> - A boolean value,true=phone in ECM, false=ECM off</li> 66 * </ul> 67 * <p class="note"> 68 * You can <em>not</em> receive this through components declared 69 * in manifests, only by explicitly registering for it with 70 * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, 71 * android.content.IntentFilter) Context.registerReceiver()}. 72 * 73 * <p class="note"> 74 * Requires no permission. 75 * 76 * <p class="note">This is a protected intent that can only be sent 77 * by the system. 78 */ 79 public static final String ACTION_EMERGENCY_CALLBACK_MODE_CHANGED 80 = "android.intent.action.EMERGENCY_CALLBACK_MODE_CHANGED"; 81 /** 82 * Broadcast Action: The phone's signal strength has changed. The intent will have the 83 * following extra values:</p> 84 * <ul> 85 * <li><em>phoneName</em> - A string version of the phone name.</li> 86 * <li><em>asu</em> - A numeric value for the signal strength. 87 * An ASU is 0-31 or -1 if unknown (for GSM, dBm = -113 - 2 * asu). 88 * The following special values are defined: 89 * <ul><li>0 means "-113 dBm or less".</li><li>31 means "-51 dBm or greater".</li></ul> 90 * </li> 91 * </ul> 92 * 93 * <p class="note"> 94 * You can <em>not</em> receive this through components declared 95 * in manifests, only by exlicitly registering for it with 96 * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver, 97 * android.content.IntentFilter) Context.registerReceiver()}. 98 * 99 * <p class="note"> 100 * Requires the READ_PHONE_STATE permission. 101 * 102 * <p class="note">This is a protected intent that can only be sent 103 * by the system. 104 */ 105 public static final String ACTION_SIGNAL_STRENGTH_CHANGED = "android.intent.action.SIG_STR"; 106 107 108 /** 109 * Broadcast Action: The data connection state has changed for any one of the 110 * phone's mobile data connections (eg, default, MMS or GPS specific connection). 111 * The intent will have the following extra values:</p> 112 * <ul> 113 * <li><em>phoneName</em> - A string version of the phone name.</li> 114 * <li><em>state</em> - One of <code>"CONNECTED"</code> 115 * <code>"CONNECTING"</code> or <code>"DISCONNNECTED"</code></li> 116 * <li><em>apn</em> - A string that is the APN associated with this 117 * connection.</li> 118 * <li><em>apnType</em> - A string array of APN types associated with 119 * this connection. The APN type <code>"*"</code> is a special 120 * type that means this APN services all types.</li> 121 * </ul> 122 * 123 * <p class="note"> 124 * Requires the READ_PHONE_STATE permission. 125 * 126 * <p class="note">This is a protected intent that can only be sent 127 * by the system. 128 */ 129 public static final String ACTION_ANY_DATA_CONNECTION_STATE_CHANGED 130 = "android.intent.action.ANY_DATA_STATE"; 131 132 133 /** 134 * Broadcast Action: An attempt to establish a data connection has failed. 135 * The intent will have the following extra values:</p> 136 * <ul> 137 * <li><em>phoneName</em> &mdash A string version of the phone name.</li> 138 * <li><em>state</em> — One of <code>"CONNECTED"</code> 139 * <code>"CONNECTING"</code> or <code>"DISCONNNECTED"</code></li> 140 * <li><em>reason</em> — A string indicating the reason for the failure, if available</li> 141 * </ul> 142 * 143 * <p class="note"> 144 * Requires the READ_PHONE_STATE permission. 145 * 146 * <p class="note">This is a protected intent that can only be sent 147 * by the system. 148 */ 149 public static final String ACTION_DATA_CONNECTION_FAILED 150 = "android.intent.action.DATA_CONNECTION_FAILED"; 151 152 153 /** 154 * Broadcast Action: The sim card state has changed. 155 * The intent will have the following extra values:</p> 156 * <ul> 157 * <li><em>phoneName</em> - A string version of the phone name.</li> 158 * <li><em>ss</em> - The sim state. One of 159 * <code>"ABSENT"</code> <code>"LOCKED"</code> 160 * <code>"READY"</code> <code>"ISMI"</code> <code>"LOADED"</code> </li> 161 * <li><em>reason</em> - The reason while ss is LOCKED, otherwise is null 162 * <code>"PIN"</code> locked on PIN1 163 * <code>"PUK"</code> locked on PUK1 164 * <code>"NETWORK"</code> locked on Network Personalization </li> 165 * </ul> 166 * 167 * <p class="note"> 168 * Requires the READ_PHONE_STATE permission. 169 * 170 * <p class="note">This is a protected intent that can only be sent 171 * by the system. 172 */ 173 public static final String ACTION_SIM_STATE_CHANGED 174 = "android.intent.action.SIM_STATE_CHANGED"; 175 176 177 /** 178 * Broadcast Action: The time was set by the carrier (typically by the NITZ string). 179 * This is a sticky broadcast. 180 * The intent will have the following extra values:</p> 181 * <ul> 182 * <li><em>time</em> - The time as a long in UTC milliseconds.</li> 183 * </ul> 184 * 185 * <p class="note"> 186 * Requires the READ_PHONE_STATE permission. 187 * 188 * <p class="note">This is a protected intent that can only be sent 189 * by the system. 190 */ 191 public static final String ACTION_NETWORK_SET_TIME = "android.intent.action.NETWORK_SET_TIME"; 192 193 194 /** 195 * Broadcast Action: The timezone was set by the carrier (typically by the NITZ string). 196 * This is a sticky broadcast. 197 * The intent will have the following extra values:</p> 198 * <ul> 199 * <li><em>time-zone</em> - The java.util.TimeZone.getID() value identifying the new time 200 * zone.</li> 201 * </ul> 202 * 203 * <p class="note"> 204 * Requires the READ_PHONE_STATE permission. 205 * 206 * <p class="note">This is a protected intent that can only be sent 207 * by the system. 208 */ 209 public static final String ACTION_NETWORK_SET_TIMEZONE 210 = "android.intent.action.NETWORK_SET_TIMEZONE"; 211 212 /** 213 * <p>Broadcast Action: It indicates the Emergency callback mode blocks datacall/sms 214 * <p class="note">. 215 * This is to pop up a notice to show user that the phone is in emergency callback mode 216 * and atacalls and outgoing sms are blocked. 217 * 218 * <p class="note">This is a protected intent that can only be sent 219 * by the system. 220 */ 221 public static final String ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS 222 = "android.intent.action.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS"; 223 } 224