Home | History | Annotate | Download | only in telephony
      1 /*
      2  * Copyright (C) 2008 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package com.android.internal.telephony;
     18 
     19 /**
     20  * The intents that the telephony services broadcast.
     21  *
     22  * <p class="warning">
     23  * THESE ARE NOT THE API!  Use the {@link android.telephony.TelephonyManager} class.
     24  * DON'T LISTEN TO THESE DIRECTLY.
     25  */
     26 public class TelephonyIntents {
     27 
     28     /**
     29      * Broadcast Action: The phone service state has changed. The intent will have the following
     30      * extra values:</p>
     31      * <ul>
     32      *   <li><em>state</em> - An int with one of the following values:
     33      *          {@link android.telephony.ServiceState#STATE_IN_SERVICE},
     34      *          {@link android.telephony.ServiceState#STATE_OUT_OF_SERVICE},
     35      *          {@link android.telephony.ServiceState#STATE_EMERGENCY_ONLY}
     36      *          or {@link android.telephony.ServiceState#STATE_POWER_OFF}
     37      *   <li><em>roaming</em> - A boolean value indicating whether the phone is roaming.</li>
     38      *   <li><em>operator-alpha-long</em> - The carrier name as a string.</li>
     39      *   <li><em>operator-alpha-short</em> - A potentially shortened version of the carrier name,
     40      *          as a string.</li>
     41      *   <li><em>operator-numeric</em> - A number representing the carrier, as a string. This is
     42      *          a five or six digit number consisting of the MCC (Mobile Country Code, 3 digits)
     43      *          and MNC (Mobile Network code, 2-3 digits).</li>
     44      *   <li><em>manual</em> - A boolean, where true indicates that the user has chosen to select
     45      *          the network manually, and false indicates that network selection is handled by the
     46      *          phone.</li>
     47      * </ul>
     48      *
     49      * <p class="note">
     50      * Requires the READ_PHONE_STATE permission.
     51      *
     52      * <p class="note">This is a protected intent that can only be sent
     53      * by the system.
     54      */
     55     public static final String ACTION_SERVICE_STATE_CHANGED = "android.intent.action.SERVICE_STATE";
     56 
     57     /**
     58      * <p>Broadcast Action: The radio technology has changed. The intent will have the following
     59      * extra values:</p>
     60      * <ul>
     61      *   <li><em>phoneName</em> - A string version of the new phone name.</li>
     62      * </ul>
     63      *
     64      * <p class="note">
     65      * You can <em>not</em> receive this through components declared
     66      * in manifests, only by explicitly registering for it with
     67      * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver,
     68      * android.content.IntentFilter) Context.registerReceiver()}.
     69      *
     70      * <p class="note">
     71      * Requires no permission.
     72      *
     73      * <p class="note">This is a protected intent that can only be sent
     74      * by the system.
     75      */
     76     public static final String ACTION_RADIO_TECHNOLOGY_CHANGED
     77             = "android.intent.action.RADIO_TECHNOLOGY";
     78     /**
     79      * <p>Broadcast Action: The emergency callback mode is changed.
     80      * <ul>
     81      *   <li><em>phoneinECMState</em> - A boolean value,true=phone in ECM, false=ECM off</li>
     82      * </ul>
     83      * <p class="note">
     84      * You can <em>not</em> receive this through components declared
     85      * in manifests, only by explicitly registering for it with
     86      * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver,
     87      * android.content.IntentFilter) Context.registerReceiver()}.
     88      *
     89      * <p class="note">
     90      * Requires no permission.
     91      *
     92      * <p class="note">This is a protected intent that can only be sent
     93      * by the system.
     94      */
     95     public static final String ACTION_EMERGENCY_CALLBACK_MODE_CHANGED
     96             = "android.intent.action.EMERGENCY_CALLBACK_MODE_CHANGED";
     97     /**
     98      * Broadcast Action: The phone's signal strength has changed. The intent will have the
     99      * following extra values:</p>
    100      * <ul>
    101      *   <li><em>phoneName</em> - A string version of the phone name.</li>
    102      *   <li><em>asu</em> - A numeric value for the signal strength.
    103      *          An ASU is 0-31 or -1 if unknown (for GSM, dBm = -113 - 2 * asu).
    104      *          The following special values are defined:
    105      *          <ul><li>0 means "-113 dBm or less".</li><li>31 means "-51 dBm or greater".</li></ul>
    106      *   </li>
    107      * </ul>
    108      *
    109      * <p class="note">
    110      * You can <em>not</em> receive this through components declared
    111      * in manifests, only by exlicitly registering for it with
    112      * {@link android.content.Context#registerReceiver(android.content.BroadcastReceiver,
    113      * android.content.IntentFilter) Context.registerReceiver()}.
    114      *
    115      * <p class="note">
    116      * Requires the READ_PHONE_STATE permission.
    117      *
    118      * <p class="note">This is a protected intent that can only be sent
    119      * by the system.
    120      */
    121     public static final String ACTION_SIGNAL_STRENGTH_CHANGED = "android.intent.action.SIG_STR";
    122 
    123 
    124     /**
    125      * Broadcast Action: The data connection state has changed for any one of the
    126      * phone's mobile data connections (eg, default, MMS or GPS specific connection).
    127      * The intent will have the following extra values:</p>
    128      * <ul>
    129      *   <li><em>phoneName</em> - A string version of the phone name.</li>
    130      *   <li><em>state</em> - One of <code>"CONNECTED"</code>
    131      *      <code>"CONNECTING"</code> or <code>"DISCONNNECTED"</code></li>
    132      *   <li><em>apn</em> - A string that is the APN associated with this
    133      *      connection.</li>
    134      *   <li><em>apnType</em> - A string array of APN types associated with
    135      *      this connection.  The APN type <code>"*"</code> is a special
    136      *      type that means this APN services all types.</li>
    137      * </ul>
    138      *
    139      * <p class="note">
    140      * Requires the READ_PHONE_STATE permission.
    141      *
    142      * <p class="note">This is a protected intent that can only be sent
    143      * by the system.
    144      */
    145     public static final String ACTION_ANY_DATA_CONNECTION_STATE_CHANGED
    146             = "android.intent.action.ANY_DATA_STATE";
    147 
    148 
    149     /**
    150      * Broadcast Action: An attempt to establish a data connection has failed.
    151      * The intent will have the following extra values:</p>
    152      * <ul>
    153      *   <li><em>phoneName</em> &mdash A string version of the phone name.</li>
    154      *   <li><em>state</em> &mdash; One of <code>"CONNECTED"</code>
    155      *      <code>"CONNECTING"</code> or <code>"DISCONNNECTED"</code></li>
    156      * <li><em>reason</em> &mdash; A string indicating the reason for the failure, if available</li>
    157      * </ul>
    158      *
    159      * <p class="note">
    160      * Requires the READ_PHONE_STATE permission.
    161      *
    162      * <p class="note">This is a protected intent that can only be sent
    163      * by the system.
    164      */
    165     public static final String ACTION_DATA_CONNECTION_FAILED
    166             = "android.intent.action.DATA_CONNECTION_FAILED";
    167 
    168 
    169     /**
    170      * Broadcast Action: The sim card state has changed.
    171      * The intent will have the following extra values:</p>
    172      * <ul>
    173      *   <li><em>phoneName</em> - A string version of the phone name.</li>
    174      *   <li><em>ss</em> - The sim state.  One of
    175      *   <code>"ABSENT"</code> <code>"LOCKED"</code>
    176      *   <code>"READY"</code> <code>"ISMI"</code> <code>"LOADED"</code> </li>
    177      *   <li><em>reason</em> - The reason while ss is LOCKED, otherwise is null
    178      *   <code>"PIN"</code> locked on PIN1
    179      *   <code>"PUK"</code> locked on PUK1
    180      *   <code>"NETWORK"</code> locked on Network Personalization </li>
    181      * </ul>
    182      *
    183      * <p class="note">
    184      * Requires the READ_PHONE_STATE permission.
    185      *
    186      * <p class="note">This is a protected intent that can only be sent
    187      * by the system.
    188      */
    189     public static final String ACTION_SIM_STATE_CHANGED
    190             = "android.intent.action.SIM_STATE_CHANGED";
    191 
    192 
    193     /**
    194      * Broadcast Action: The time was set by the carrier (typically by the NITZ string).
    195      * This is a sticky broadcast.
    196      * The intent will have the following extra values:</p>
    197      * <ul>
    198      *   <li><em>time</em> - The time as a long in UTC milliseconds.</li>
    199      * </ul>
    200      *
    201      * <p class="note">
    202      * Requires the READ_PHONE_STATE permission.
    203      *
    204      * <p class="note">This is a protected intent that can only be sent
    205      * by the system.
    206      */
    207     public static final String ACTION_NETWORK_SET_TIME = "android.intent.action.NETWORK_SET_TIME";
    208 
    209 
    210     /**
    211      * Broadcast Action: The timezone was set by the carrier (typically by the NITZ string).
    212      * This is a sticky broadcast.
    213      * The intent will have the following extra values:</p>
    214      * <ul>
    215      *   <li><em>time-zone</em> - The java.util.TimeZone.getID() value identifying the new time
    216      *          zone.</li>
    217      * </ul>
    218      *
    219      * <p class="note">
    220      * Requires the READ_PHONE_STATE permission.
    221      *
    222      * <p class="note">This is a protected intent that can only be sent
    223      * by the system.
    224      */
    225     public static final String ACTION_NETWORK_SET_TIMEZONE
    226             = "android.intent.action.NETWORK_SET_TIMEZONE";
    227 
    228     /**
    229      * <p>Broadcast Action: It indicates the Emergency callback mode blocks datacall/sms
    230      * <p class="note">.
    231      * This is to pop up a notice to show user that the phone is in emergency callback mode
    232      * and atacalls and outgoing sms are blocked.
    233      *
    234      * <p class="note">This is a protected intent that can only be sent
    235      * by the system.
    236      */
    237     public static final String ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS
    238             = "android.intent.action.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS";
    239 
    240 
    241     /**
    242      * Broadcast Action: A "secret code" has been entered in the dialer. Secret codes are
    243      * of the form *#*#<code>#*#*. The intent will have the data URI:</p>
    244      *
    245      * <p><code>android_secret_code://&lt;code&gt;</code></p>
    246      */
    247     public static final String SECRET_CODE_ACTION =
    248             "android.provider.Telephony.SECRET_CODE";
    249 
    250     /**
    251      * Broadcast Action: The Service Provider string(s) have been updated.  Activities or
    252      * services that use these strings should update their display.
    253      * The intent will have the following extra values:</p>
    254      * <ul>
    255      *   <li><em>showPlmn</em> - Boolean that indicates whether the PLMN should be shown.</li>
    256      *   <li><em>plmn</em> - The operator name of the registered network, as a string.</li>
    257      *   <li><em>showSpn</em> - Boolean that indicates whether the SPN should be shown.</li>
    258      *   <li><em>spn</em> - The service provider name, as a string.</li>
    259      * </ul>
    260      * Note that <em>showPlmn</em> may indicate that <em>plmn</em> should be displayed, even
    261      * though the value for <em>plmn</em> is null.  This can happen, for example, if the phone
    262      * has not registered to a network yet.  In this case the receiver may substitute an
    263      * appropriate placeholder string (eg, "No service").
    264      *
    265      * It is recommended to display <em>plmn</em> before / above <em>spn</em> if
    266      * both are displayed.
    267      *
    268      * <p>Note this is a protected intent that can only be sent
    269      * by the system.
    270      */
    271     public static final String SPN_STRINGS_UPDATED_ACTION =
    272             "android.provider.Telephony.SPN_STRINGS_UPDATED";
    273 
    274     public static final String EXTRA_SHOW_PLMN  = "showPlmn";
    275     public static final String EXTRA_PLMN       = "plmn";
    276     public static final String EXTRA_SHOW_SPN   = "showSpn";
    277     public static final String EXTRA_SPN        = "spn";
    278 }
    279