/* * Copyright (C) 2008 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.internal.telephony; /** * 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. */ public class TelephonyIntents { /** * 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_SERVICE_STATE_CHANGED = "android.intent.action.SERVICE_STATE"; /** *

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_RADIO_TECHNOLOGY_CHANGED = "android.intent.action.RADIO_TECHNOLOGY"; /** *

Broadcast Action: The emergency callback mode is changed. *

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

* 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 = "android.intent.action.EMERGENCY_CALLBACK_MODE_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_SIGNAL_STRENGTH_CHANGED = "android.intent.action.SIG_STR"; /** * 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. * *

This is a protected intent that can only be sent * by the system. */ public static final String ACTION_ANY_DATA_CONNECTION_STATE_CHANGED = "android.intent.action.ANY_DATA_STATE"; /** * 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 "*" is a special * type that means this APN services all types.
linkProperties - The LinkProperties for this APN
linkCapabilities - The 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_CONNECTED_TO_PROVISIONING_APN = "android.intent.action.DATA_CONNECTION_CONNECTED_TO_PROVISIONING_APN"; /** * 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. * *

This is a protected intent that can only be sent * by the system. */ public static final String ACTION_DATA_CONNECTION_FAILED = "android.intent.action.DATA_CONNECTION_FAILED"; /** * 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. * *

This is a protected intent that can only be sent * by the system. */ public static final String ACTION_SIM_STATE_CHANGED = "android.intent.action.SIM_STATE_CHANGED"; /** * 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_TIME = "android.intent.action.NETWORK_SET_TIME"; /** * 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_NETWORK_SET_TIMEZONE = "android.intent.action.NETWORK_SET_TIMEZONE"; /** *

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_SHOW_NOTICE_ECM_BLOCK_OTHERS = "android.intent.action.ACTION_SHOW_NOTICE_ECM_BLOCK_OTHERS"; /** * Activity Action: Start this activity to invoke the carrier setup app. * To filter the intent, see {@link #CATEGORY_MCCMNC_PREFIX}. * *

Callers of this should hold the android.permission.INVOKE_CARRIER_SETUP * permission.

*/ public static final String ACTION_CARRIER_SETUP = "android.intent.action.ACTION_CARRIER_SETUP"; /** * A prefix for the MCC/MNC filtering used with {@link #ACTION_CARRIER_SETUP}. * The MCC/MNC will be concatenated (zero-padded to 3 digits each) to create a final * string of the form: *
* android.intent.category.MCCMNC_310260 */ public static final String CATEGORY_MCCMNC_PREFIX = "android.intent.category.MCCMNC_"; /** * Broadcast Action: A "secret code" has been entered in the dialer. Secret codes are * of the form *#*#

#*#*. The intent will have the data URI:
     *
     * android_secret_code://<code>
     */
    public static final String SECRET_CODE_ACTION =
            "android.provider.Telephony.SECRET_CODE";

    /**
     * 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 SPN_STRINGS_UPDATED_ACTION =
            "android.provider.Telephony.SPN_STRINGS_UPDATED";

    public static final String EXTRA_SHOW_PLMN  = "showPlmn";
    public static final String EXTRA_PLMN       = "plmn";
    public static final String EXTRA_SHOW_SPN   = "showSpn";
    public static final String EXTRA_SPN        = "spn";
}