/* * 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; import android.content.Intent; /** * 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 {@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_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 {@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_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: 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_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: *

{@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_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. * 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_CARRIER_SETUP = "android.intent.action.ACTION_CARRIER_SETUP"; /** * 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 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";

    /**
     * 
Broadcast Action: It indicates one column of a siminfo record has been changed
     * The intent will have the following extra values:
     * 
     *   columnName - The siminfo column that is updated.
     *   stringContent - The string value of the updated column.
     *   intContent - The int value of the updated column.
     * 
     * This is a protected intent that can only be sent
     * by the system.
     */
    public static final String ACTION_SIMINFO_CONTENT_CHANGE
            = "android.intent.action.ACTION_SIMINFO_CONTENT_CHANGE";

    /**
     * 
Broadcast Action: It indicates one column of a subinfo record has been changed
     * The intent will have the following extra values:
     * 
     *   columnName - The siminfo column that is updated.
     *   stringContent - The string value of the updated column.
     *   intContent - The int value of the updated column.
     * 
     * This is a protected intent that can only be sent
     * by the system.
     */
    public static final String ACTION_SUBINFO_CONTENT_CHANGE
            = "android.intent.action.ACTION_SUBINFO_CONTENT_CHANGE";

    /**
     * 
Broadcast Action: It indicates siminfo update is completed when SIM inserted state change
     * The intent will have the following extra values:
     * This is a protected intent that can only be sent
     * by the system.
     */
    public static final String ACTION_SIMINFO_UPDATED
            = "android.intent.action.ACTION_SIMINFO_UPDATED";

    /**
     * 
Broadcast Action: It indicates subinfo record update is completed
     * when SIM inserted state change
     * The intent will have the following extra values:
     * This is a protected intent that can only be sent
     * by the system.
     */
    public static final String ACTION_SUBINFO_RECORD_UPDATED
            = "android.intent.action.ACTION_SUBINFO_RECORD_UPDATED";

    public static final String EXTRA_COLUMN_NAME = "columnName";
    public static final String EXTRA_INT_CONTENT = "intContent";
    public static final String EXTRA_STRING_CONTENT = "stringContent";

    /**
     * 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_SUBSCRIPTION_CHANGED
            = "android.intent.action.ACTION_DEFAULT_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_DATA_SUBSCRIPTION_CHANGED
            = "android.intent.action.ACTION_DEFAULT_DATA_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_VOICE_SUBSCRIPTION_CHANGED
            = "android.intent.action.ACTION_DEFAULT_VOICE_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_DEFAULT_SMS_SUBSCRIPTION_CHANGED
            = "android.intent.action.ACTION_DEFAULT_SMS_SUBSCRIPTION_CHANGED";
}