com.android.internal.telephony.TelephonyIntents Maven / Gradle / Ivy
Show all versions of android-all Show documentation
/*
* 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
*
*
* 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_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: Indicates that the action is forbidden by network.
*
* This is for the OEM applications to understand about possible provisioning issues.
* Used in OMA-DM applications.
*/
public static final String ACTION_FORBIDDEN_NO_SERVICE_AUTHORIZATION
= "android.intent.action.ACTION_FORBIDDEN_NO_SERVICE_AUTHORIZATION";
/**
* 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";
public static final String EXTRA_DATA_SPN = "spnData";
/**
*
Broadcast Action: It indicates one column of a subinfo record has been changed
*
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 subinfo record update is completed
* when SIM inserted state change
*
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";
/**
* 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";
/*
* Broadcast Action: An attempt to set phone radio type and access technology has changed.
* This has the following extra values:
*
* - phones radio access family - A RadioAccessFamily
* array, contain phone ID and new radio access family for each phone.
*
*/
public static final String ACTION_SET_RADIO_CAPABILITY_DONE =
"android.intent.action.ACTION_SET_RADIO_CAPABILITY_DONE";
public static final String EXTRA_RADIO_ACCESS_FAMILY = "rafs";
/*
* Broadcast Action: An attempt to set phone radio access family has failed.
*/
public static final String ACTION_SET_RADIO_CAPABILITY_FAILED =
"android.intent.action.ACTION_SET_RADIO_CAPABILITY_FAILED";
}