2 * Copyright (C) 2015 The Android Open Source Project
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 package android.telephony;
19 import android.Manifest;
20 import android.annotation.NonNull;
21 import android.annotation.Nullable;
22 import android.annotation.RequiresPermission;
23 import android.annotation.SuppressLint;
24 import android.annotation.SystemApi;
25 import android.annotation.SystemService;
26 import android.annotation.TestApi;
27 import android.annotation.UnsupportedAppUsage;
28 import android.content.ComponentName;
29 import android.content.Context;
30 import android.os.PersistableBundle;
31 import android.os.RemoteException;
32 import android.os.ServiceManager;
33 import android.service.carrier.CarrierService;
34 import android.telecom.TelecomManager;
35 import android.telephony.ims.ImsReasonInfo;
37 import com.android.internal.telephony.ICarrierConfigLoader;
40 * Provides access to telephony configuration values that are carrier-specific.
42 @SystemService(Context.CARRIER_CONFIG_SERVICE)
43 public class CarrierConfigManager {
44 private final static String TAG = "CarrierConfigManager";
47 * Extra included in {@link #ACTION_CARRIER_CONFIG_CHANGED} to indicate the slot index that the
50 public static final String EXTRA_SLOT_INDEX = "android.telephony.extra.SLOT_INDEX";
53 * Optional extra included in {@link #ACTION_CARRIER_CONFIG_CHANGED} to indicate the
54 * subscription index that the broadcast is for, if a valid one is available.
56 public static final String EXTRA_SUBSCRIPTION_INDEX =
57 SubscriptionManager.EXTRA_SUBSCRIPTION_INDEX;
59 private final Context mContext;
64 public CarrierConfigManager(Context context) {
69 * This intent is broadcast by the system when carrier config changes. An int is specified in
70 * {@link #EXTRA_SLOT_INDEX} to indicate the slot index that this is for. An optional int extra
71 * {@link #EXTRA_SUBSCRIPTION_INDEX} is included to indicate the subscription index if a valid
72 * one is available for the slot index. An optional int extra
73 * {@link TelephonyManager#EXTRA_CARRIER_ID} is included to indicate the carrier id for the
74 * changed carrier configuration. An optional int extra
75 * {@link TelephonyManager#EXTRA_SPECIFIC_CARRIER_ID} is included to indicate the precise
76 * carrier id for the changed carrier configuration.
77 * @see TelephonyManager#getSimCarrierId()
78 * @see TelephonyManager#getSimSpecificCarrierId()
80 public static final String
81 ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";
83 // Below are the keys used in carrier config bundles. To add a new variable, define the key and
84 // give it a default value in sDefaults. If you need to ship a per-network override in the
85 // system image, that can be added in packages/apps/CarrierConfig.
88 * Specifies a value that identifies the version of the carrier configuration that is
89 * currently in use. This string is displayed on the UI.
90 * The format of the string is not specified.
92 public static final String KEY_CARRIER_CONFIG_VERSION_STRING =
93 "carrier_config_version_string";
96 * This flag specifies whether VoLTE availability is based on provisioning. By default this is
99 public static final String
100 KEY_CARRIER_VOLTE_PROVISIONED_BOOL = "carrier_volte_provisioned_bool";
103 * Boolean indicating if the "Call forwarding" item is visible in the Call Settings menu.
104 * true means visible. false means gone.
107 public static final String KEY_CALL_FORWARDING_VISIBILITY_BOOL =
108 "call_forwarding_visibility_bool";
111 * Boolean indicating if the "Caller ID" item is visible in the Additional Settings menu.
112 * true means visible. false means gone.
115 public static final String KEY_ADDITIONAL_SETTINGS_CALLER_ID_VISIBILITY_BOOL =
116 "additional_settings_caller_id_visibility_bool";
119 * Boolean indicating if the "Call Waiting" item is visible in the Additional Settings menu.
120 * true means visible. false means gone.
123 public static final String KEY_ADDITIONAL_SETTINGS_CALL_WAITING_VISIBILITY_BOOL =
124 "additional_settings_call_waiting_visibility_bool";
127 * Boolean indicating if the "Call barring" item is visible in the Call Settings menu.
128 * If true, the "Call Barring" menu will be visible. If false, the menu will be gone.
130 * Disabled by default.
132 public static final String KEY_CALL_BARRING_VISIBILITY_BOOL =
133 "call_barring_visibility_bool";
136 * Flag indicating whether or not changing the call barring password via the "Call Barring"
137 * settings menu is supported. If true, the option will be visible in the "Call
138 * Barring" settings menu. If false, the option will not be visible.
140 * Enabled by default.
142 public static final String KEY_CALL_BARRING_SUPPORTS_PASSWORD_CHANGE_BOOL =
143 "call_barring_supports_password_change_bool";
146 * Flag indicating whether or not deactivating all call barring features via the "Call Barring"
147 * settings menu is supported. If true, the option will be visible in the "Call
148 * Barring" settings menu. If false, the option will not be visible.
150 * Enabled by default.
152 public static final String KEY_CALL_BARRING_SUPPORTS_DEACTIVATE_ALL_BOOL =
153 "call_barring_supports_deactivate_all_bool";
156 * Flag indicating whether the Phone app should ignore EVENT_SIM_NETWORK_LOCKED
157 * events from the Sim.
158 * If true, this will prevent the IccNetworkDepersonalizationPanel from being shown, and
159 * effectively disable the "Sim network lock" feature.
161 public static final String
162 KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL = "ignore_sim_network_locked_events_bool";
165 * When checking if a given number is the voicemail number, if this flag is true
166 * then in addition to comparing the given number to the voicemail number, we also compare it
167 * to the mdn. If this flag is false, the given number is only compared to the voicemail number.
168 * By default this value is false.
170 public static final String KEY_MDN_IS_ADDITIONAL_VOICEMAIL_NUMBER_BOOL =
171 "mdn_is_additional_voicemail_number_bool";
174 * Flag indicating whether the Phone app should provide a "Dismiss" button on the SIM network
175 * unlock screen. The default value is true. If set to false, there will be *no way* to dismiss
176 * the SIM network unlock screen if you don't enter the correct unlock code. (One important
177 * consequence: there will be no way to make an Emergency Call if your SIM is network-locked and
178 * you don't know the PIN.)
180 public static final String
181 KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL = "sim_network_unlock_allow_dismiss_bool";
184 * Flag indicating whether or not sending emergency SMS messages over IMS
185 * is supported when in LTE/limited LTE (Emergency only) service mode..
188 public static final String
189 KEY_SUPPORT_EMERGENCY_SMS_OVER_IMS_BOOL = "support_emergency_sms_over_ims_bool";
191 /** Flag indicating if the phone is a world phone */
192 public static final String KEY_WORLD_PHONE_BOOL = "world_phone_bool";
195 * Flag to require or skip entitlement checks.
196 * If true, entitlement checks will be executed if device has been configured for it,
197 * If false, entitlement checks will be skipped.
199 public static final String
200 KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL = "require_entitlement_checks_bool";
203 * Flag indicating whether radio is to be restarted on error PDP_FAIL_REGULAR_DEACTIVATION
204 * This is false by default.
206 * @deprecated Use {@link #KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY} instead
209 public static final String KEY_RESTART_RADIO_ON_PDP_FAIL_REGULAR_DEACTIVATION_BOOL =
210 "restart_radio_on_pdp_fail_regular_deactivation_bool";
213 * A list of failure cause codes that will trigger a modem restart when telephony receiving
214 * one of those during data setup. The cause codes are defined in 3GPP TS 24.008 Annex I and
217 public static final String KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY =
218 "radio_restart_failure_causes_int_array";
221 * If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity.
222 * The pattern is set on a per-platform basis using config_virtualKeyVibePattern. To be
223 * consistent with the regular Dialer, this value should agree with the corresponding values
224 * from config.xml under apps/Contacts.
226 public static final String
227 KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL = "enable_dialer_key_vibration_bool";
229 /** Flag indicating if dtmf tone type is enabled */
230 public static final String KEY_DTMF_TYPE_ENABLED_BOOL = "dtmf_type_enabled_bool";
232 /** Flag indicating if auto retry is enabled */
233 public static final String KEY_AUTO_RETRY_ENABLED_BOOL = "auto_retry_enabled_bool";
236 * Determine whether we want to play local DTMF tones in a call, or just let the radio/BP handle
237 * playing of the tones.
239 public static final String KEY_ALLOW_LOCAL_DTMF_TONES_BOOL = "allow_local_dtmf_tones_bool";
242 * Determines if the carrier requires that a tone be played to the remote party when an app is
243 * recording audio during a call (e.g. using a call recording app).
245 * Note: This requires the Telephony config_supports_telephony_audio_device overlay to be true
249 public static final String KEY_PLAY_CALL_RECORDING_TONE_BOOL = "play_call_recording_tone_bool";
251 * Determines if the carrier requires converting the destination number before sending out an
252 * SMS. Certain networks and numbering plans require different formats.
254 public static final String KEY_SMS_REQUIRES_DESTINATION_NUMBER_CONVERSION_BOOL=
255 "sms_requires_destination_number_conversion_bool";
258 * If true, show an onscreen "Dial" button in the dialer. In practice this is used on all
259 * platforms, even the ones with hard SEND/END keys, but for maximum flexibility it's controlled
260 * by a flag here (which can be overridden on a per-product basis.)
262 public static final String KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL = "show_onscreen_dial_button_bool";
264 /** Determines if device implements a noise suppression device for in call audio. */
265 public static final String
266 KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL = "has_in_call_noise_suppression_bool";
269 * Determines if the current device should allow emergency numbers to be logged in the Call Log.
270 * (Some carriers require that emergency calls *not* be logged, presumably to avoid the risk of
271 * accidental redialing from the call log UI. This is a good idea, so the default here is
274 public static final String
275 KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL = "allow_emergency_numbers_in_call_log_bool";
278 * A string array containing numbers that shouldn't be included in the call log.
281 public static final String KEY_UNLOGGABLE_NUMBERS_STRING_ARRAY =
282 "unloggable_numbers_string_array";
284 /** If true, removes the Voice Privacy option from Call Settings */
285 public static final String KEY_VOICE_PRIVACY_DISABLE_UI_BOOL = "voice_privacy_disable_ui_bool";
287 /** Control whether users can reach the carrier portions of Cellular Network Settings. */
288 public static final String
289 KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL = "hide_carrier_network_settings_bool";
292 * Do only allow auto selection in Advanced Network Settings when in home network.
293 * Manual selection is allowed when in roaming network.
296 public static final String
297 KEY_ONLY_AUTO_SELECT_IN_HOME_NETWORK_BOOL = "only_auto_select_in_home_network";
300 * Control whether users receive a simplified network settings UI and improved network
303 public static final String
304 KEY_SIMPLIFIED_NETWORK_SETTINGS_BOOL = "simplified_network_settings_bool";
306 /** Control whether users can reach the SIM lock settings. */
307 public static final String
308 KEY_HIDE_SIM_LOCK_SETTINGS_BOOL = "hide_sim_lock_settings_bool";
310 /** Control whether users can edit APNs in Settings. */
311 public static final String KEY_APN_EXPAND_BOOL = "apn_expand_bool";
313 /** Control whether users can choose a network operator. */
314 public static final String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";
316 /** Used in Cellular Network Settings for preferred network type. */
317 public static final String KEY_PREFER_2G_BOOL = "prefer_2g_bool";
319 /** Show cdma network mode choices 1x, 3G, global etc. */
320 public static final String KEY_SHOW_CDMA_CHOICES_BOOL = "show_cdma_choices_bool";
322 /** CDMA activation goes through HFA */
323 public static final String KEY_USE_HFA_FOR_PROVISIONING_BOOL = "use_hfa_for_provisioning_bool";
326 * CDMA activation goes through OTASP.
328 * TODO: This should be combined with config_use_hfa_for_provisioning and implemented as an enum
329 * (NONE, HFA, OTASP).
331 public static final String KEY_USE_OTASP_FOR_PROVISIONING_BOOL = "use_otasp_for_provisioning_bool";
333 /** Display carrier settings menu if true */
334 public static final String KEY_CARRIER_SETTINGS_ENABLE_BOOL = "carrier_settings_enable_bool";
336 /** Does not display additional call setting for IMS phone based on GSM Phone */
337 public static final String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";
339 /** Show APN Settings for some CDMA carriers */
340 public static final String KEY_SHOW_APN_SETTING_CDMA_BOOL = "show_apn_setting_cdma_bool";
342 /** After a CDMA conference call is merged, the swap button should be displayed. */
343 public static final String KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL = "support_swap_after_merge_bool";
346 * Determine whether user can edit voicemail number in Settings.
348 public static final String KEY_EDITABLE_VOICEMAIL_NUMBER_SETTING_BOOL =
349 "editable_voicemail_number_setting_bool";
352 * Since the default voicemail number is empty, if a SIM card does not have a voicemail number
353 * available the user cannot use voicemail. This flag allows the user to edit the voicemail
354 * number in such cases, and is false by default.
356 public static final String KEY_EDITABLE_VOICEMAIL_NUMBER_BOOL= "editable_voicemail_number_bool";
359 * Determine whether the voicemail notification is persistent in the notification bar. If true,
360 * the voicemail notifications cannot be dismissed from the notification bar.
362 public static final String
363 KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL = "voicemail_notification_persistent_bool";
365 /** For IMS video over LTE calls, determines whether video pause signalling is supported. */
366 public static final String
367 KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL = "support_pause_ims_video_calls_bool";
370 * Disables dialing "*228" (OTASP provisioning) on CDMA carriers where it is not supported or is
371 * potentially harmful by locking the SIM to 3G.
373 public static final String
374 KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL = "disable_cdma_activation_code_bool";
377 * List of RIL radio technologies (See {@link ServiceState} {@code RIL_RADIO_TECHNOLOGY_*}
378 * constants) which support only a single data connection at a time. Some carriers do not
379 * support multiple pdp on UMTS.
381 public static final String
382 KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY = "only_single_dc_allowed_int_array";
385 * Override the platform's notion of a network operator being considered roaming.
386 * Value is string array of MCCMNCs to be considered roaming for 3GPP RATs.
388 public static final String
389 KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY = "gsm_roaming_networks_string_array";
392 * Override the platform's notion of a network operator being considered not roaming.
393 * Value is string array of MCCMNCs to be considered not roaming for 3GPP RATs.
395 public static final String
396 KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY = "gsm_nonroaming_networks_string_array";
399 * Override the device's configuration for the ImsService to use for this SIM card.
401 public static final String KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING =
402 "config_ims_package_override_string";
405 * Override the package that will manage {@link SubscriptionPlan}
406 * information instead of the {@link CarrierService} that defines this
409 * @see SubscriptionManager#getSubscriptionPlans(int)
410 * @see SubscriptionManager#setSubscriptionPlans(int, java.util.List)
412 public static final String KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING =
413 "config_plans_package_override_string";
416 * Override the platform's notion of a network operator being considered roaming.
417 * Value is string array of SIDs to be considered roaming for 3GPP2 RATs.
419 public static final String
420 KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY = "cdma_roaming_networks_string_array";
423 * Override the platform's notion of a network operator being considered non roaming.
424 * Value is string array of SIDs to be considered not roaming for 3GPP2 RATs.
426 public static final String
427 KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY = "cdma_nonroaming_networks_string_array";
430 * Override the platform's notion of a network operator being considered non roaming.
431 * If true all networks are considered as home network a.k.a non-roaming. When false,
432 * the 2 pairs of CMDA and GSM roaming/non-roaming arrays are consulted.
434 * @see #KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY
435 * @see #KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY
436 * @see #KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
437 * @see #KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY
439 public static final String
440 KEY_FORCE_HOME_NETWORK_BOOL = "force_home_network_bool";
443 * Flag specifying whether VoLTE should be available for carrier, independent of carrier
444 * provisioning. If false: hard disabled. If true: then depends on carrier provisioning,
447 public static final String KEY_CARRIER_VOLTE_AVAILABLE_BOOL = "carrier_volte_available_bool";
450 * Flag specifying whether video telephony is available for carrier. If false: hard disabled.
451 * If true: then depends on carrier provisioning, availability, etc.
453 public static final String KEY_CARRIER_VT_AVAILABLE_BOOL = "carrier_vt_available_bool";
456 * Flag specifying whether the carrier wants to notify the user when a VT call has been handed
457 * over from WIFI to LTE.
459 * The handover notification is sent as a
460 * {@link TelephonyManager#EVENT_HANDOVER_VIDEO_FROM_WIFI_TO_LTE}
461 * {@link android.telecom.Connection} event, which an {@link android.telecom.InCallService}
462 * should use to trigger the display of a user-facing message.
464 * The Connection event is sent to the InCallService only once, the first time it occurs.
467 public static final String KEY_NOTIFY_HANDOVER_VIDEO_FROM_WIFI_TO_LTE_BOOL =
468 "notify_handover_video_from_wifi_to_lte_bool";
471 * Flag specifying whether the carrier supports merging a RTT call with a voice call,
472 * downgrading the call in the process.
475 public static final String KEY_ALLOW_MERGING_RTT_CALLS_BOOL =
476 "allow_merging_rtt_calls_bool";
479 * Flag specifying whether the carrier wants to notify the user when a VT call has been handed
480 * over from LTE to WIFI.
482 * The handover notification is sent as a
483 * {@link TelephonyManager#EVENT_HANDOVER_VIDEO_FROM_LTE_TO_WIFI}
484 * {@link android.telecom.Connection} event, which an {@link android.telecom.InCallService}
485 * should use to trigger the display of a user-facing message.
488 public static final String KEY_NOTIFY_HANDOVER_VIDEO_FROM_LTE_TO_WIFI_BOOL =
489 "notify_handover_video_from_lte_to_wifi_bool";
492 * Flag specifying whether the carrier supports downgrading a video call (tx, rx or tx/rx)
493 * directly to an audio call.
496 public static final String KEY_SUPPORT_DOWNGRADE_VT_TO_AUDIO_BOOL =
497 "support_downgrade_vt_to_audio_bool";
500 * Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default
502 * When empty string, no default voicemail number is specified.
504 public static final String KEY_DEFAULT_VM_NUMBER_STRING = "default_vm_number_string";
507 * Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default
508 * voicemail number for roaming network.
509 * When empty string, no default voicemail number is specified for roaming network.
512 public static final String KEY_DEFAULT_VM_NUMBER_ROAMING_STRING =
513 "default_vm_number_roaming_string";
516 * Flag that specifies to use the user's own phone number as the voicemail number when there is
517 * no pre-loaded voicemail number on the SIM card.
519 * {@link #KEY_DEFAULT_VM_NUMBER_STRING} takes precedence over this flag.
521 * If false, the system default (*86) will be used instead.
523 public static final String KEY_CONFIG_TELEPHONY_USE_OWN_NUMBER_FOR_VOICEMAIL_BOOL =
524 "config_telephony_use_own_number_for_voicemail_bool";
527 * When {@code true}, changes to the mobile data enabled switch will not cause the VT
528 * registration state to change. That is, turning on or off mobile data will not cause VT to be
529 * enabled or disabled.
530 * When {@code false}, disabling mobile data will cause VT to be de-registered.
532 * See also {@link #KEY_VILTE_DATA_IS_METERED_BOOL}.
535 public static final String KEY_IGNORE_DATA_ENABLED_CHANGED_FOR_VIDEO_CALLS =
536 "ignore_data_enabled_changed_for_video_calls";
539 * Flag indicating whether data used for a video call over LTE is metered or not.
541 * When {@code true}, if the device hits the data limit or data is disabled during a ViLTE call,
542 * the call will be downgraded to audio-only (or paused if
543 * {@link #KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL} is {@code true}).
547 public static final String KEY_VILTE_DATA_IS_METERED_BOOL = "vilte_data_is_metered_bool";
550 * Flag specifying whether WFC over IMS should be available for carrier: independent of
551 * carrier provisioning. If false: hard disabled. If true: then depends on carrier
552 * provisioning, availability etc.
554 public static final String KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL = "carrier_wfc_ims_available_bool";
557 * Specifies a map from dialstrings to replacements for roaming network service numbers which
558 * cannot be replaced on the carrier side.
560 * Individual entries have the format:
561 * [dialstring to replace]:[replacement]
563 public static final String KEY_DIAL_STRING_REPLACE_STRING_ARRAY =
564 "dial_string_replace_string_array";
567 * Flag specifying whether WFC over IMS supports the "wifi only" option. If false, the wifi
568 * calling settings will not include an option for "wifi only". If true, the wifi calling
569 * settings will include an option for "wifi only"
571 * By default, it is assumed that WFC supports "wifi only".
573 public static final String KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL =
574 "carrier_wfc_supports_wifi_only_bool";
577 * Default mode for WFC over IMS on home network:
580 * <li>1: prefer mobile network
581 * <li>2: prefer Wi-Fi
584 public static final String KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT =
585 "carrier_default_wfc_ims_mode_int";
588 * Default mode for WFC over IMS on roaming network.
589 * See {@link #KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT} for meaning of values.
591 public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT =
592 "carrier_default_wfc_ims_roaming_mode_int";
595 * Default WFC_IMS_enabled: true VoWiFi by default is on
596 * false VoWiFi by default is off
599 public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL =
600 "carrier_default_wfc_ims_enabled_bool";
603 * Default WFC_IMS_roaming_enabled: true VoWiFi roaming by default is on
604 * false VoWiFi roaming by default is off
607 public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL =
608 "carrier_default_wfc_ims_roaming_enabled_bool";
611 * Flag indicating whether failed calls due to no service should prompt the user to enable
612 * WIFI calling. When {@code true}, if the user attempts to establish a call when there is no
613 * service available, they are connected to WIFI, and WIFI calling is disabled, a different
614 * call failure message will be used to encourage the user to enable WIFI calling.
617 public static final String KEY_CARRIER_PROMOTE_WFC_ON_CALL_FAIL_BOOL =
618 "carrier_promote_wfc_on_call_fail_bool";
621 * Flag specifying whether provisioning is required for VoLTE, Video Telephony, and WiFi
624 public static final String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
625 = "carrier_volte_provisioning_required_bool";
628 * Flag indicating whether or not the IMS MmTel UT capability requires carrier provisioning
629 * before it can be set as enabled.
631 * If true, the UT capability will be set to false for the newly loaded subscription
632 * and will require the carrier provisioning app to set the persistent provisioning result.
633 * If false, the platform will not wait for provisioning status updates for the UT capability
634 * and enable the UT over IMS capability for the subscription when the subscription is loaded.
636 * The default value for this key is {@code false}.
638 public static final String KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL =
639 "carrier_ut_provisioning_required_bool";
642 * Flag indicating whether or not the carrier supports Supplementary Services over the UT
643 * interface for this subscription.
645 * If true, the device will use Supplementary Services over UT when provisioned (see
646 * {@link #KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL}). If false, this device will fallback to
647 * circuit switch for supplementary services and will disable this capability for IMS entirely.
649 * The default value for this key is {@code true}.
651 public static final String KEY_CARRIER_SUPPORTS_SS_OVER_UT_BOOL =
652 "carrier_supports_ss_over_ut_bool";
655 * Flag specifying if WFC provisioning depends on VoLTE provisioning.
657 * {@code false}: default value; honor actual WFC provisioning state.
658 * {@code true}: when VoLTE is not provisioned, treat WFC as not provisioned; when VoLTE is
659 * provisioned, honor actual WFC provisioning state.
661 * As of now, Verizon is the only carrier enforcing this dependency in their
662 * WFC awareness and activation requirements.
666 public static final String KEY_CARRIER_VOLTE_OVERRIDE_WFC_PROVISIONING_BOOL
667 = "carrier_volte_override_wfc_provisioning_bool";
670 * Override the device's configuration for the cellular data service to use for this SIM card.
673 public static final String KEY_CARRIER_DATA_SERVICE_WWAN_PACKAGE_OVERRIDE_STRING
674 = "carrier_data_service_wwan_package_override_string";
677 * Override the device's configuration for the IWLAN data service to use for this SIM card.
680 public static final String KEY_CARRIER_DATA_SERVICE_WLAN_PACKAGE_OVERRIDE_STRING
681 = "carrier_data_service_wlan_package_override_string";
683 /** Flag specifying whether VoLTE TTY is supported. */
684 public static final String KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
685 = "carrier_volte_tty_supported_bool";
688 * Flag specifying whether IMS service can be turned off. If false then the service will not be
689 * turned-off completely, but individual features can be disabled.
691 public static final String KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL
692 = "carrier_allow_turnoff_ims_bool";
695 * Flag specifying whether Generic Bootstrapping Architecture capable SIM is required for IMS.
697 public static final String KEY_CARRIER_IMS_GBA_REQUIRED_BOOL
698 = "carrier_ims_gba_required_bool";
701 * Flag specifying whether IMS instant lettering is available for the carrier. {@code True} if
702 * instant lettering is available for the carrier, {@code false} otherwise.
704 public static final String KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL =
705 "carrier_instant_lettering_available_bool";
708 * Flag specifying whether IMS should be the first phone attempted for E911 even if the
709 * phone is not in service.
711 public static final String KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL
712 = "carrier_use_ims_first_for_emergency_bool";
715 * When IMS instant lettering is available for a carrier (see
716 * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines the list of characters
717 * which may not be contained in messages. Should be specified as a regular expression suitable
718 * for use with {@link String#matches(String)}.
720 public static final String KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING =
721 "carrier_instant_lettering_invalid_chars_string";
724 * When IMS instant lettering is available for a carrier (see
725 * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines a list of characters which
726 * must be escaped with a backslash '\' character. Should be specified as a string containing
727 * the characters to be escaped. For example to escape quote and backslash the string would be
728 * a quote and a backslash.
730 public static final String KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING =
731 "carrier_instant_lettering_escaped_chars_string";
734 * When IMS instant lettering is available for a carrier (see
735 * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines the character encoding
736 * which will be used when determining the length of messages. Used in the InCall UI to limit
737 * the number of characters the user may type. If empty-string, the instant lettering
738 * message size limit will be enforced on a 1:1 basis. That is, each character will count
739 * towards the messages size limit as a single bye. If a character encoding is specified, the
740 * message size limit will be based on the number of bytes in the message per the specified
743 public static final String KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING =
744 "carrier_instant_lettering_encoding_string";
747 * When IMS instant lettering is available for a carrier (see
748 * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), the length limit for messages. Used
749 * in the InCall UI to ensure the user cannot enter more characters than allowed by the carrier.
750 * See also {@link #KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING} for more information on how
751 * the length of the message is calculated.
753 public static final String KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT =
754 "carrier_instant_lettering_length_limit_int";
757 * If Voice Radio Technology is RIL_RADIO_TECHNOLOGY_LTE:14 or RIL_RADIO_TECHNOLOGY_UNKNOWN:0
758 * this is the value that should be used instead. A configuration value of
759 * RIL_RADIO_TECHNOLOGY_UNKNOWN:0 means there is no replacement value and that the default
760 * assumption for phone type (GSM) should be used.
762 public static final String KEY_VOLTE_REPLACEMENT_RAT_INT = "volte_replacement_rat_int";
765 * The default sim call manager to use when the default dialer doesn't implement one. A sim call
766 * manager can control and route outgoing and incoming phone calls, even if they're placed
767 * using another connection service (PSTN, for example).
769 public static final String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";
772 * The default flag specifying whether ETWS/CMAS test setting is forcibly disabled in
773 * Settings->More->Emergency broadcasts menu even though developer options is turned on.
775 public static final String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL =
776 "carrier_force_disable_etws_cmas_test_bool";
779 * The default flag specifying whether "Turn on Notifications" option will be always shown in
780 * Settings->More->Emergency broadcasts menu regardless developer options is turned on or not.
782 public static final String KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL =
783 "always_show_emergency_alert_onoff_bool";
786 * The flag to disable cell broadcast severe alert when extreme alert is disabled.
789 public static final String KEY_DISABLE_SEVERE_WHEN_EXTREME_DISABLED_BOOL =
790 "disable_severe_when_extreme_disabled_bool";
793 * The message expiration time in milliseconds for duplicate detection purposes.
796 public static final String KEY_MESSAGE_EXPIRATION_TIME_LONG =
797 "message_expiration_time_long";
800 * The data call retry configuration for different types of APN.
803 public static final String KEY_CARRIER_DATA_CALL_RETRY_CONFIG_STRINGS =
804 "carrier_data_call_retry_config_strings";
807 * Delay in milliseconds between trying APN from the pool
810 public static final String KEY_CARRIER_DATA_CALL_APN_DELAY_DEFAULT_LONG =
811 "carrier_data_call_apn_delay_default_long";
814 * Faster delay in milliseconds between trying APN from the pool
817 public static final String KEY_CARRIER_DATA_CALL_APN_DELAY_FASTER_LONG =
818 "carrier_data_call_apn_delay_faster_long";
821 * Delay in milliseconds for retrying APN after disconnect
824 public static final String KEY_CARRIER_DATA_CALL_APN_RETRY_AFTER_DISCONNECT_LONG =
825 "carrier_data_call_apn_retry_after_disconnect_long";
828 * Data call setup permanent failure causes by the carrier
830 public static final String KEY_CARRIER_DATA_CALL_PERMANENT_FAILURE_STRINGS =
831 "carrier_data_call_permanent_failure_strings";
834 * Default APN types that are metered by the carrier
837 public static final String KEY_CARRIER_METERED_APN_TYPES_STRINGS =
838 "carrier_metered_apn_types_strings";
840 * Default APN types that are roaming-metered by the carrier
843 public static final String KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS =
844 "carrier_metered_roaming_apn_types_strings";
847 * APN types that are not allowed on cellular
850 public static final String KEY_CARRIER_WWAN_DISALLOWED_APN_TYPES_STRING_ARRAY =
851 "carrier_wwan_disallowed_apn_types_string_array";
854 * APN types that are not allowed on IWLAN
857 public static final String KEY_CARRIER_WLAN_DISALLOWED_APN_TYPES_STRING_ARRAY =
858 "carrier_wlan_disallowed_apn_types_string_array";
860 * CDMA carrier ERI (Enhanced Roaming Indicator) file name
863 public static final String KEY_CARRIER_ERI_FILE_NAME_STRING =
864 "carrier_eri_file_name_string";
866 /* The following 3 fields are related to carrier visual voicemail. */
869 * The carrier number mobile outgoing (MO) sms messages are sent to.
871 public static final String KEY_VVM_DESTINATION_NUMBER_STRING = "vvm_destination_number_string";
874 * The port through which the mobile outgoing (MO) sms messages are sent through.
876 public static final String KEY_VVM_PORT_NUMBER_INT = "vvm_port_number_int";
879 * The type of visual voicemail protocol the carrier adheres to. See {@link TelephonyManager}
880 * for possible values. For example {@link TelephonyManager#VVM_TYPE_OMTP}.
882 public static final String KEY_VVM_TYPE_STRING = "vvm_type_string";
885 * Whether cellular data is required to access visual voicemail.
887 public static final String KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL =
888 "vvm_cellular_data_required_bool";
891 * The default OMTP visual voicemail client prefix to use. Defaulted to "//VVM"
893 public static final String KEY_VVM_CLIENT_PREFIX_STRING =
894 "vvm_client_prefix_string";
897 * Whether to use SSL to connect to the visual voicemail IMAP server. Defaulted to false.
899 public static final String KEY_VVM_SSL_ENABLED_BOOL = "vvm_ssl_enabled_bool";
902 * A set of capabilities that should not be used even if it is reported by the visual voicemail
903 * IMAP CAPABILITY command.
905 public static final String KEY_VVM_DISABLED_CAPABILITIES_STRING_ARRAY =
906 "vvm_disabled_capabilities_string_array";
909 * Whether legacy mode should be used when the visual voicemail client is disabled.
911 * <p>Legacy mode is a mode that on the carrier side visual voicemail is still activated, but on
912 * the client side all network operations are disabled. SMSs are still monitored so a new
913 * message SYNC SMS will be translated to show a message waiting indicator, like traditional
916 * <p>This is for carriers that does not support VVM deactivation so voicemail can continue to
917 * function without the data cost.
919 public static final String KEY_VVM_LEGACY_MODE_ENABLED_BOOL =
920 "vvm_legacy_mode_enabled_bool";
923 * Whether to prefetch audio data on new voicemail arrival, defaulted to true.
925 public static final String KEY_VVM_PREFETCH_BOOL = "vvm_prefetch_bool";
928 * The package name of the carrier's visual voicemail app to ensure that dialer visual voicemail
929 * and carrier visual voicemail are not active at the same time.
931 * @deprecated use {@link #KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY}.
934 public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING = "carrier_vvm_package_name_string";
937 * A list of the carrier's visual voicemail app package names to ensure that dialer visual
938 * voicemail and carrier visual voicemail are not active at the same time.
940 public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY =
941 "carrier_vvm_package_name_string_array";
944 * Flag specifying whether ICCID is showed in SIM Status screen, default to false.
946 public static final String KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL = "show_iccid_in_sim_status_bool";
949 * Flag specifying whether the {@link android.telephony.SignalStrength} is shown in the SIM
950 * Status screen. The default value is true.
952 public static final String KEY_SHOW_SIGNAL_STRENGTH_IN_SIM_STATUS_BOOL =
953 "show_signal_strength_in_sim_status_bool";
956 * Flag specifying whether an additional (client initiated) intent needs to be sent on System
959 public static final String KEY_CI_ACTION_ON_SYS_UPDATE_BOOL = "ci_action_on_sys_update_bool";
962 * Intent to be sent for the additional action on System update
964 public static final String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING =
965 "ci_action_on_sys_update_intent_string";
968 * Extra to be included in the intent sent for additional action on System update
970 public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING =
971 "ci_action_on_sys_update_extra_string";
974 * Value of extra included in intent sent for additional action on System update
976 public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING =
977 "ci_action_on_sys_update_extra_val_string";
980 * Specifies the amount of gap to be added in millis between postdial DTMF tones. When a
981 * non-zero value is specified, the UE shall wait for the specified amount of time before it
982 * sends out successive DTMF tones on the network.
984 public static final String KEY_GSM_DTMF_TONE_DELAY_INT = "gsm_dtmf_tone_delay_int";
987 * Specifies the amount of gap to be added in millis between DTMF tones. When a non-zero value
988 * is specified, the UE shall wait for the specified amount of time before it sends out
989 * successive DTMF tones on the network.
991 public static final String KEY_IMS_DTMF_TONE_DELAY_INT = "ims_dtmf_tone_delay_int";
994 * Specifies the amount of gap to be added in millis between postdial DTMF tones. When a
995 * non-zero value is specified, the UE shall wait for the specified amount of time before it
996 * sends out successive DTMF tones on the network.
998 public static final String KEY_CDMA_DTMF_TONE_DELAY_INT = "cdma_dtmf_tone_delay_int";
1001 * Some carriers will send call forwarding responses for voicemail in a format that is not 3gpp
1002 * compliant, which causes issues during parsing. This causes the
1003 * {@link com.android.internal.telephony.CallForwardInfo#number} to contain non-numerical
1004 * characters instead of a number.
1006 * If true, we will detect the non-numerical characters and replace them with "Voicemail".
1009 public static final String KEY_CALL_FORWARDING_MAP_NON_NUMBER_TO_VOICEMAIL_BOOL =
1010 "call_forwarding_map_non_number_to_voicemail_bool";
1013 * When {@code true}, the phone will always tell the IMS stack to keep RTT enabled and
1014 * determine on a per-call basis (based on extras from the dialer app) whether a call should be
1015 * an RTT call or not.
1017 * When {@code false}, the old behavior is used, where the toggle in accessibility settings is
1018 * used to set the IMS stack's RTT enabled state.
1021 public static final String KEY_IGNORE_RTT_MODE_SETTING_BOOL =
1022 "ignore_rtt_mode_setting_bool";
1025 * Determines whether conference calls are supported by a carrier. When {@code true},
1026 * conference calling is supported, {@code false otherwise}.
1028 public static final String KEY_SUPPORT_CONFERENCE_CALL_BOOL = "support_conference_call_bool";
1031 * Determines whether a maximum size limit for IMS conference calls is enforced on the device.
1032 * When {@code true}, IMS conference calls will be limited to at most
1033 * {@link #KEY_IMS_CONFERENCE_SIZE_LIMIT_INT} participants. When {@code false}, no attempt is made
1034 * to limit the number of participants in a conference (the carrier will raise an error when an
1035 * attempt is made to merge too many participants into a conference).
1037 public static final String KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL =
1038 "is_ims_conference_size_enforced_bool";
1041 * Determines the maximum number of participants the carrier supports for a conference call.
1042 * This number is exclusive of the current device. A conference between 3 devices, for example,
1043 * would have a size limit of 2 participants.
1044 * Enforced when {@link #KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL} is {@code true}.
1046 public static final String KEY_IMS_CONFERENCE_SIZE_LIMIT_INT = "ims_conference_size_limit_int";
1049 * Determines whether manage IMS conference calls is supported by a carrier. When {@code true},
1050 * manage IMS conference call is supported, {@code false otherwise}.
1053 public static final String KEY_SUPPORT_MANAGE_IMS_CONFERENCE_CALL_BOOL =
1054 "support_manage_ims_conference_call_bool";
1057 * Determines whether the IMS conference merge process supports and returns its participants
1058 * data. When {@code true}, on merge complete, conference call would have a list of its
1059 * participants returned in XML format, {@code false otherwise}.
1062 public static final String KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL =
1063 "support_ims_conference_event_package_bool";
1066 * Determines whether High Definition audio property is displayed in the dialer UI.
1067 * If {@code false}, remove the HD audio property from the connection so that HD audio related
1068 * UI is not displayed. If {@code true}, keep HD audio property as it is configured.
1070 public static final String KEY_DISPLAY_HD_AUDIO_PROPERTY_BOOL =
1071 "display_hd_audio_property_bool";
1074 * Determines whether IMS conference calls are supported by a carrier. When {@code true},
1075 * IMS conference calling is supported, {@code false} otherwise.
1078 public static final String KEY_SUPPORT_IMS_CONFERENCE_CALL_BOOL =
1079 "support_ims_conference_call_bool";
1082 * Determines whether video conference calls are supported by a carrier. When {@code true},
1083 * video calls can be merged into conference calls, {@code false} otherwiwse.
1085 * Note: even if video conference calls are not supported, audio calls may be merged into a
1086 * conference if {@link #KEY_SUPPORT_CONFERENCE_CALL_BOOL} is {@code true}.
1089 public static final String KEY_SUPPORT_VIDEO_CONFERENCE_CALL_BOOL =
1090 "support_video_conference_call_bool";
1093 * Determine whether user can toggle Enhanced 4G LTE Mode in Settings.
1095 public static final String KEY_EDITABLE_ENHANCED_4G_LTE_BOOL = "editable_enhanced_4g_lte_bool";
1098 * Determines whether the Enhanced 4G LTE toggle will be shown in the settings. When this
1099 * option is {@code true}, the toggle will be hidden regardless of whether the device and
1100 * carrier supports 4G LTE or not.
1102 public static final String KEY_HIDE_ENHANCED_4G_LTE_BOOL = "hide_enhanced_4g_lte_bool";
1105 * Sets the default state for the "Enhanced 4G LTE" or "Advanced Calling" mode toggle set by the
1106 * user. When this is {@code true}, this mode by default is on, otherwise if {@code false},
1107 * this mode by default is off.
1109 public static final String KEY_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL =
1110 "enhanced_4g_lte_on_by_default_bool";
1113 * Determine whether IMS apn can be shown.
1115 public static final String KEY_HIDE_IMS_APN_BOOL = "hide_ims_apn_bool";
1118 * Determine whether preferred network type can be shown.
1120 public static final String KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL = "hide_preferred_network_type_bool";
1123 * String array for package names that need to be enabled for this carrier.
1124 * If user has explicitly disabled some packages in the list, won't re-enable.
1125 * Other carrier specific apps which are not in this list may be disabled for current carrier,
1126 * and only be re-enabled when this config for another carrier includes it.
1130 public static final String KEY_ENABLE_APPS_STRING_ARRAY = "enable_apps_string_array";
1133 * Determine whether user can switch Wi-Fi preferred or Cellular preferred in calling preference.
1134 * Some operators support Wi-Fi Calling only, not VoLTE.
1135 * They don't need "Cellular preferred" option.
1136 * In this case, set uneditalbe attribute for preferred preference.
1139 public static final String KEY_EDITABLE_WFC_MODE_BOOL = "editable_wfc_mode_bool";
1142 * Flag to indicate if Wi-Fi needs to be disabled in ECBM
1145 public static final String
1146 KEY_CONFIG_WIFI_DISABLE_IN_ECBM = "config_wifi_disable_in_ecbm";
1149 * List operator-specific error codes and indices of corresponding error strings in
1150 * wfcOperatorErrorAlertMessages and wfcOperatorErrorNotificationMessages.
1152 * Example: "REG09|0" specifies error code "REG09" and index "0". This index will be
1153 * used to find alert and notification messages in wfcOperatorErrorAlertMessages and
1154 * wfcOperatorErrorNotificationMessages.
1158 public static final String KEY_WFC_OPERATOR_ERROR_CODES_STRING_ARRAY =
1159 "wfc_operator_error_codes_string_array";
1162 * Indexes of SPN format strings in wfcSpnFormats.
1164 * <p>Available options are:
1167 * <li> 1: %s Wi-Fi Calling</li>
1168 * <li> 2: WLAN Call</li>
1169 * <li> 3: %s WLAN Call</li>
1170 * <li> 4: %s Wi-Fi</li>
1171 * <li> 5: WiFi Calling | %s</li>
1172 * <li> 6: %s VoWifi</li>
1173 * <li> 7: Wi-Fi Calling</li>
1174 * <li> 8: Wi-Fi</li>
1175 * <li> 9: WiFi Calling</li>
1176 * <li> 10: VoWifi</li>
1177 * <li> 11: %s WiFi Calling</li>
1180 public static final String KEY_WFC_SPN_FORMAT_IDX_INT = "wfc_spn_format_idx_int";
1183 * Indexes of data SPN format strings in wfcSpnFormats.
1185 * @see KEY_WFC_SPN_FORMAT_IDX_INT for available options.
1188 public static final String KEY_WFC_DATA_SPN_FORMAT_IDX_INT = "wfc_data_spn_format_idx_int";
1191 * Indexes of SPN format strings in wfcSpnFormats used during flight mode.
1193 * Set to -1 to use the value from KEY_WFC_SPN_FORMAT_IDX_INT also in this case.
1194 * @see KEY_WFC_SPN_FORMAT_IDX_INT for other available options.
1197 public static final String KEY_WFC_FLIGHT_MODE_SPN_FORMAT_IDX_INT =
1198 "wfc_flight_mode_spn_format_idx_int";
1201 * Use root locale when reading wfcSpnFormats.
1203 * If true, then the root locale will always be used when reading wfcSpnFormats. This means the
1204 * non localized version of wfcSpnFormats will be used.
1207 public static final String KEY_WFC_SPN_USE_ROOT_LOCALE = "wfc_spn_use_root_locale";
1210 * The Component Name of the activity that can setup the emergency addrees for WiFi Calling
1211 * as per carrier requirement.
1214 public static final String KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING =
1215 "wfc_emergency_address_carrier_app_string";
1218 * Unconditionally override the carrier name string using #KEY_CARRIER_NAME_STRING.
1220 * If true, then the carrier name string will be #KEY_CARRIER_NAME_STRING, unconditionally.
1222 * <p>If false, then the override will be performed conditionally and the
1223 * #KEY_CARRIER_NAME_STRING will have the lowest-precedence; it will only be used in the event
1224 * that the name string would otherwise be empty, allowing it to serve as a last-resort. If
1225 * used, this value functions in place of the SPN on any/all ICC records for the corresponding
1228 public static final String KEY_CARRIER_NAME_OVERRIDE_BOOL = "carrier_name_override_bool";
1231 * String to identify carrier name in CarrierConfig app. This string overrides SPN if
1232 * #KEY_CARRIER_NAME_OVERRIDE_BOOL is true; otherwise, it will be used if its value is provided
1233 * and SPN is unavailable
1235 public static final String KEY_CARRIER_NAME_STRING = "carrier_name_string";
1238 * Override the SPN Display Condition 2 integer bits (lsb). B2, B1 is the last two bits of the
1239 * spn display condition coding.
1241 * The default value -1 mean this field is not set.
1243 * B1 = 0: display of registered PLMN name not required when registered PLMN is either HPLMN
1244 * or a PLMN in the service provider PLMN list (see EF_SPDI).
1245 * B1 = 1: display of registered PLMN name required when registered PLMN is either HPLMN or a
1246 * PLMN in the service provider PLMN list(see EF_SPDI).
1247 * B2 = 0: display of the service provider name is required when registered PLMN is neither
1248 * HPLMN nor a PLMN in the service provider PLMN list(see EF_SPDI).
1249 * B2 = 1: display of the service provider name is not required when registered PLMN is neither
1250 * HPLMN nor a PLMN in the service provider PLMN list(see EF_SPDI).
1252 * Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.12 EF_SPN.
1255 public static final String KEY_SPN_DISPLAY_CONDITION_OVERRIDE_INT =
1256 "spn_display_condition_override_int";
1259 * Override the SPDI - an array of PLMN(MCC + MNC) strings.
1261 * Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.66 EF_SPDI.
1264 public static final String KEY_SPDI_OVERRIDE_STRING_ARRAY = "spdi_override_string_array";
1267 * Override the EHPLMNs - an array of PLMN(MCC + MNC) strings.
1269 * To allow provision for multiple HPLMN codes, PLMN codes that are present within this list
1270 * shall replace the HPLMN code derived from the IMSI for PLMN selection purposes.
1272 * Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.84 EF_EHPLMN
1273 * Reference: 3GPP TS 23.122 v15.6.0 Section 1.2 Equivalent HPLMN list
1276 public static final String KEY_EHPLMN_OVERRIDE_STRING_ARRAY = "ehplmn_override_string_array";
1279 * Override the PNN - a string array of comma-separated alpha long and short names:
1280 * "alpha_long1,alpha_short1".
1282 * Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.58 EF_PNN.
1285 public static final String KEY_PNN_OVERRIDE_STRING_ARRAY = "pnn_override_string_array";
1288 * A string array of OPL records, each with comma-delimited data fields as follows:
1289 * "plmn1,lactac_start,lactac_end,index".
1291 * Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.59 EF_OPL.
1294 public static final String KEY_OPL_OVERRIDE_STRING_ARRAY = "opl_override_opl_string_array";
1297 * Allow ERI rules to select a carrier name display string when using 3gpp2 access technologies.
1298 * If this bit is not set, the carrier name display string will be selected from the carrier
1299 * display name resolver which doesn't apply the ERI rules.
1303 public static final String KEY_ALLOW_ERI_BOOL = "allow_cdma_eri_bool";
1306 * If true, use the carrier display name(SPN and PLMN) from the carrier display name resolver.
1310 public static final String KEY_ENABLE_CARRIER_DISPLAY_NAME_RESOLVER_BOOL =
1311 "enable_carrier_display_name_resolver_bool";
1314 * String to override sim country iso.
1315 * Sim country iso is based on sim MCC which is coarse and doesn't work with dual IMSI SIM where
1316 * a SIM can have multiple MCC from different countries.
1317 * Instead, each sim carrier should have a single country code, apply per carrier based iso
1318 * code as an override. The overridden value can be read from
1319 * {@link TelephonyManager#getSimCountryIso()} and {@link SubscriptionInfo#getCountryIso()}
1323 public static final String KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING =
1324 "sim_country_iso_override_string";
1327 * The Component Name of a carrier-provided CallScreeningService implementation. Telecom will
1328 * bind to {@link android.telecom.CallScreeningService} for ALL incoming calls and provide
1330 * CallScreeningService with the opportunity to allow or block calls.
1332 * The String includes the package name/the class name.
1334 * <item>com.android.carrier/com.android.carrier.callscreeningserviceimpl</item>
1336 * Using {@link ComponentName#flattenToString()} to convert a ComponentName object to String.
1337 * Using {@link ComponentName#unflattenFromString(String)} to convert a String object to a
1340 public static final String KEY_CARRIER_CALL_SCREENING_APP_STRING = "call_screening_app";
1343 * Override the registered PLMN name using #KEY_CDMA_HOME_REGISTERED_PLMN_NAME_STRING.
1345 * If true, then the registered PLMN name (only for CDMA/CDMA-LTE and only when not roaming)
1346 * will be #KEY_CDMA_HOME_REGISTERED_PLMN_NAME_STRING. If false, or if phone type is not
1347 * CDMA/CDMA-LTE or if roaming, then #KEY_CDMA_HOME_REGISTERED_PLMN_NAME_STRING will be ignored.
1350 public static final String KEY_CDMA_HOME_REGISTERED_PLMN_NAME_OVERRIDE_BOOL =
1351 "cdma_home_registered_plmn_name_override_bool";
1354 * String to identify registered PLMN name in CarrierConfig app. This string overrides
1355 * registered PLMN name if #KEY_CDMA_HOME_REGISTERED_PLMN_NAME_OVERRIDE_BOOL is true, phone type
1356 * is CDMA/CDMA-LTE and device is not in roaming state; otherwise, it will be ignored.
1359 public static final String KEY_CDMA_HOME_REGISTERED_PLMN_NAME_STRING =
1360 "cdma_home_registered_plmn_name_string";
1363 * If this is true, the SIM card (through Customer Service Profile EF file) will be able to
1364 * prevent manual operator selection. If false, this SIM setting will be ignored and manual
1365 * operator selection will always be available. See CPHS4_2.WW6, CPHS B.4.7.1 for more
1368 public static final String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";
1371 * Allow user to add APNs
1373 public static final String KEY_ALLOW_ADDING_APNS_BOOL = "allow_adding_apns_bool";
1376 * APN types that user is not allowed to modify
1379 public static final String KEY_READ_ONLY_APN_TYPES_STRING_ARRAY =
1380 "read_only_apn_types_string_array";
1383 * APN fields that user is not allowed to modify
1386 public static final String KEY_READ_ONLY_APN_FIELDS_STRING_ARRAY =
1387 "read_only_apn_fields_string_array";
1390 * Boolean indicating if intent for emergency call state changes should be broadcast
1393 public static final String KEY_BROADCAST_EMERGENCY_CALL_STATE_CHANGES_BOOL =
1394 "broadcast_emergency_call_state_changes_bool";
1397 * Indicates whether STK LAUNCH_BROWSER command is disabled.
1398 * If {@code true}, then the browser will not be launched
1399 * on UI for the LAUNCH_BROWSER STK command.
1402 public static final String KEY_STK_DISABLE_LAUNCH_BROWSER_BOOL =
1403 "stk_disable_launch_browser_bool";
1406 * Boolean indicating if show data RAT icon on status bar even when data is disabled
1409 public static final String KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL =
1410 "always_show_data_rat_icon_bool";
1413 * Boolean indicating if default data account should show LTE or 4G icon
1416 public static final String KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL =
1417 "show_4g_for_lte_data_icon_bool";
1420 * Boolean indicating if default data account should show 4G icon when in 3G.
1423 public static final String KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL =
1424 "show_4g_for_3g_data_icon_bool";
1427 * Boolean indicating if lte+ icon should be shown if available
1430 public static final String KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL =
1431 "hide_lte_plus_data_icon_bool";
1434 * The string is used to filter redundant string from PLMN Network Name that's supplied by
1439 public static final String KEY_OPERATOR_NAME_FILTER_PATTERN_STRING =
1440 "operator_name_filter_pattern_string";
1443 * The string is used to compare with operator name. If it matches the pattern then show
1444 * specific data icon.
1448 public static final String KEY_SHOW_CARRIER_DATA_ICON_PATTERN_STRING =
1449 "show_carrier_data_icon_pattern_string";
1452 * Boolean to decide whether to show precise call failed cause to user
1455 public static final String KEY_SHOW_PRECISE_FAILED_CAUSE_BOOL =
1456 "show_precise_failed_cause_bool";
1459 * Boolean to decide whether lte is enabled.
1462 public static final String KEY_LTE_ENABLED_BOOL = "lte_enabled_bool";
1465 * Boolean to decide whether TD-SCDMA is supported.
1468 public static final String KEY_SUPPORT_TDSCDMA_BOOL = "support_tdscdma_bool";
1471 * A list of mcc/mnc that support TD-SCDMA for device when connect to the roaming network.
1474 public static final String KEY_SUPPORT_TDSCDMA_ROAMING_NETWORKS_STRING_ARRAY =
1475 "support_tdscdma_roaming_networks_string_array";
1478 * Boolean to decide whether world mode is enabled.
1481 public static final String KEY_WORLD_MODE_ENABLED_BOOL = "world_mode_enabled_bool";
1484 * Flatten {@link android.content.ComponentName} of the carrier's settings activity.
1487 public static final String KEY_CARRIER_SETTINGS_ACTIVITY_COMPONENT_NAME_STRING =
1488 "carrier_settings_activity_component_name_string";
1490 // These variables are used by the MMS service and exposed through another API,
1491 // SmsManager. The variable names and string values are copied from there.
1492 public static final String KEY_MMS_ALIAS_ENABLED_BOOL = "aliasEnabled";
1493 public static final String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL = "allowAttachAudio";
1494 public static final String KEY_MMS_APPEND_TRANSACTION_ID_BOOL = "enabledTransID";
1495 public static final String KEY_MMS_GROUP_MMS_ENABLED_BOOL = "enableGroupMms";
1496 public static final String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL = "enableMMSDeliveryReports";
1497 public static final String KEY_MMS_MMS_ENABLED_BOOL = "enabledMMS";
1498 public static final String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL = "enableMMSReadReports";
1499 public static final String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL = "enableMultipartSMS";
1500 public static final String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL = "enabledNotifyWapMMSC";
1501 public static final String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL = "sendMultipartSmsAsSeparateMessages";
1502 public static final String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL = "config_cellBroadcastAppLinks";
1503 public static final String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL = "enableSMSDeliveryReports";
1504 public static final String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL = "supportHttpCharsetHeader";
1505 public static final String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL = "supportMmsContentDisposition";
1506 public static final String KEY_MMS_ALIAS_MAX_CHARS_INT = "aliasMaxChars";
1507 public static final String KEY_MMS_ALIAS_MIN_CHARS_INT = "aliasMinChars";
1508 public static final String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT = "httpSocketTimeout";
1509 public static final String KEY_MMS_MAX_IMAGE_HEIGHT_INT = "maxImageHeight";
1510 public static final String KEY_MMS_MAX_IMAGE_WIDTH_INT = "maxImageWidth";
1511 public static final String KEY_MMS_MAX_MESSAGE_SIZE_INT = "maxMessageSize";
1512 public static final String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT = "maxMessageTextSize";
1513 public static final String KEY_MMS_RECIPIENT_LIMIT_INT = "recipientLimit";
1514 public static final String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT = "smsToMmsTextLengthThreshold";
1515 public static final String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT = "smsToMmsTextThreshold";
1516 public static final String KEY_MMS_SUBJECT_MAX_LENGTH_INT = "maxSubjectLength";
1517 public static final String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING = "emailGatewayNumber";
1518 public static final String KEY_MMS_HTTP_PARAMS_STRING = "httpParams";
1519 public static final String KEY_MMS_NAI_SUFFIX_STRING = "naiSuffix";
1520 public static final String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";
1521 public static final String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";
1522 public static final String KEY_MMS_USER_AGENT_STRING = "userAgent";
1524 public static final String KEY_MMS_CLOSE_CONNECTION_BOOL = "mmsCloseConnection";
1527 * The flatten {@link android.content.ComponentName componentName} of the activity that can
1528 * setup the device and activate with the network per carrier requirements.
1530 * e.g, com.google.android.carrierPackageName/.CarrierActivityName
1534 public static final String KEY_CARRIER_SETUP_APP_STRING = "carrier_setup_app_string";
1537 * Defines carrier-specific actions which act upon
1538 * com.android.internal.telephony.CARRIER_SIGNAL_REDIRECTED, used for customization of the
1539 * default carrier app
1540 * Format: "CARRIER_ACTION_IDX, ..."
1541 * Where {@code CARRIER_ACTION_IDX} is an integer defined in
1542 * {@link com.android.carrierdefaultapp.CarrierActionUtils CarrierActionUtils}
1544 * {@link com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_DISABLE_METERED_APNS
1545 * disable_metered_apns}
1548 @UnsupportedAppUsage
1549 public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_REDIRECTION_STRING_ARRAY =
1550 "carrier_default_actions_on_redirection_string_array";
1553 * Defines carrier-specific actions which act upon
1554 * com.android.internal.telephony.CARRIER_SIGNAL_REQUEST_NETWORK_FAILED
1555 * and configured signal args:
1556 * {@link com.android.internal.telephony.TelephonyIntents#EXTRA_APN_TYPE_KEY apnType},
1557 * {@link com.android.internal.telephony.TelephonyIntents#EXTRA_ERROR_CODE_KEY errorCode}
1558 * used for customization of the default carrier app
1561 * "APN_1, ERROR_CODE_1 : CARRIER_ACTION_IDX_1, CARRIER_ACTION_IDX_2...",
1562 * "APN_1, ERROR_CODE_2 : CARRIER_ACTION_IDX_1 "
1564 * Where {@code APN_1} is a string defined in
1565 * {@link com.android.internal.telephony.PhoneConstants PhoneConstants}
1566 * Example: "default"
1568 * {@code ERROR_CODE_1} is an integer defined in
1569 * {@link DataFailCause DcFailure}
1571 * {@link DataFailCause#MISSING_UNKNOWN_APN}
1573 * {@code CARRIER_ACTION_IDX_1} is an integer defined in
1574 * {@link com.android.carrierdefaultapp.CarrierActionUtils CarrierActionUtils}
1576 * {@link com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_DISABLE_METERED_APNS}
1579 public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_DCFAILURE_STRING_ARRAY =
1580 "carrier_default_actions_on_dcfailure_string_array";
1583 * Defines carrier-specific actions which act upon
1584 * com.android.internal.telephony.CARRIER_SIGNAL_RESET, used for customization of the
1585 * default carrier app
1586 * Format: "CARRIER_ACTION_IDX, ..."
1587 * Where {@code CARRIER_ACTION_IDX} is an integer defined in
1588 * {@link com.android.carrierdefaultapp.CarrierActionUtils CarrierActionUtils}
1590 * {@link com.android.carrierdefaultapp.CarrierActionUtils
1591 * #CARRIER_ACTION_CANCEL_ALL_NOTIFICATIONS clear all notifications on reset}
1594 public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_RESET =
1595 "carrier_default_actions_on_reset_string_array";
1598 * Defines carrier-specific actions which act upon
1599 * com.android.internal.telephony.CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE,
1600 * used for customization of the default carrier app
1603 * "true : CARRIER_ACTION_IDX_1",
1604 * "false: CARRIER_ACTION_IDX_2"
1606 * Where {@code true} is a boolean indicates default network available/unavailable
1607 * Where {@code CARRIER_ACTION_IDX} is an integer defined in
1608 * {@link com.android.carrierdefaultapp.CarrierActionUtils CarrierActionUtils}
1610 * {@link com.android.carrierdefaultapp.CarrierActionUtils
1611 * #CARRIER_ACTION_ENABLE_DEFAULT_URL_HANDLER enable the app as the default URL handler}
1614 public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_DEFAULT_NETWORK_AVAILABLE =
1615 "carrier_default_actions_on_default_network_available_string_array";
1617 * Defines a list of acceptable redirection url for default carrier app
1620 public static final String KEY_CARRIER_DEFAULT_REDIRECTION_URL_STRING_ARRAY =
1621 "carrier_default_redirection_url_string_array";
1624 * Each config includes the componentName of the carrier app, followed by a list of interesting
1625 * signals(declared in the manifest) which could wake up the app.
1626 * @see com.android.internal.telephony.TelephonyIntents
1628 * <item>com.google.android.carrierAPK/.CarrierSignalReceiverA:
1629 * com.android.internal.telephony.CARRIER_SIGNAL_REDIRECTED,
1630 * com.android.internal.telephony.CARRIER_SIGNAL_PCO_VALUE
1632 * <item>com.google.android.carrierAPK/.CarrierSignalReceiverB:
1633 * com.android.internal.telephony.CARRIER_SIGNAL_PCO_VALUE
1637 public static final String KEY_CARRIER_APP_WAKE_SIGNAL_CONFIG_STRING_ARRAY =
1638 "carrier_app_wake_signal_config";
1641 * Each config includes the componentName of the carrier app, followed by a list of interesting
1642 * signals for the app during run-time. The list of signals(intents) are targeting on run-time
1643 * broadcast receivers only, aiming to avoid unnecessary wake-ups and should not be declared in
1644 * the app's manifest.
1645 * @see com.android.internal.telephony.TelephonyIntents
1647 * <item>com.google.android.carrierAPK/.CarrierSignalReceiverA:
1648 * com.android.internal.telephony.CARRIER_SIGNAL_REQUEST_NETWORK_FAILED,
1649 * com.android.internal.telephony.CARRIER_SIGNAL_PCO_VALUE
1651 * <item>com.google.android.carrierAPK/.CarrierSignalReceiverB:
1652 * com.android.internal.telephony.CARRIER_SIGNAL_REQUEST_NETWORK_FAILED
1656 public static final String KEY_CARRIER_APP_NO_WAKE_SIGNAL_CONFIG_STRING_ARRAY =
1657 "carrier_app_no_wake_signal_config";
1660 * Determines whether the carrier app needed to be involved when users try to finish setting up
1661 * the SIM card to get network service.
1664 public static final String KEY_CARRIER_APP_REQUIRED_DURING_SIM_SETUP_BOOL =
1665 "carrier_app_required_during_setup_bool";
1668 * Default value for {@link Settings.Global#DATA_ROAMING}
1671 public static final String KEY_CARRIER_DEFAULT_DATA_ROAMING_ENABLED_BOOL =
1672 "carrier_default_data_roaming_enabled_bool";
1675 * Determines whether the carrier supports making non-emergency phone calls while the phone is
1676 * in emergency callback mode. Default value is {@code true}, meaning that non-emergency calls
1677 * are allowed in emergency callback mode.
1679 public static final String KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL =
1680 "allow_non_emergency_calls_in_ecm_bool";
1683 * Time that the telephony framework stays in "emergency SMS mode" after an emergency SMS is
1684 * sent to the network. This is used by carriers to configure the time
1685 * {@link TelephonyManager#isInEmergencySmsMode()} will be true after an emergency SMS is sent.
1686 * This is used by GNSS to override user location permissions so that the carrier network can
1687 * get the user's location for emergency services.
1689 * The default is 0, which means that this feature is disabled. The maximum value for this timer
1690 * is 300000 mS (5 minutes).
1694 public static final String KEY_EMERGENCY_SMS_MODE_TIMER_MS_INT =
1695 "emergency_sms_mode_timer_ms_int";
1698 * Flag indicating whether to allow carrier video calls to emergency numbers.
1699 * When {@code true}, video calls to emergency numbers will be allowed. When {@code false},
1700 * video calls to emergency numbers will be initiated as audio-only calls instead.
1702 public static final String KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL =
1703 "allow_emergency_video_calls_bool";
1706 * Flag indicating whether the carrier supports RCS presence indication for video calls. When
1707 * {@code true}, the carrier supports RCS presence indication for video calls. When presence
1708 * is supported, the device should use the
1709 * {@link android.provider.ContactsContract.Data#CARRIER_PRESENCE} bit mask and set the
1710 * {@link android.provider.ContactsContract.Data#CARRIER_PRESENCE_VT_CAPABLE} bit to indicate
1711 * whether each contact supports video calling. The UI is made aware that presence is enabled
1712 * via {@link android.telecom.PhoneAccount#CAPABILITY_VIDEO_CALLING_RELIES_ON_PRESENCE}
1713 * and can choose to hide or show the video calling icon based on whether a contact supports
1716 public static final String KEY_USE_RCS_PRESENCE_BOOL = "use_rcs_presence_bool";
1719 * The duration in seconds that platform call and message blocking is disabled after the user
1720 * contacts emergency services. Platform considers values for below cases:
1721 * 1) 0 <= VALUE <= 604800(one week): the value will be used as the duration directly.
1722 * 2) VALUE > 604800(one week): will use the default value as duration instead.
1723 * 3) VALUE < 0: block will be disabled forever until user re-eanble block manually,
1724 * the suggested value to disable forever is -1.
1725 * See {@code android.provider.BlockedNumberContract#notifyEmergencyContact(Context)}
1726 * See {@code android.provider.BlockedNumberContract#isBlocked(Context, String)}.
1728 public static final String KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT =
1729 "duration_blocking_disabled_after_emergency_int";
1732 * Determines whether to enable enhanced call blocking feature on the device.
1733 * @see SystemContract#ENHANCED_SETTING_KEY_BLOCK_UNREGISTERED
1734 * @see SystemContract#ENHANCED_SETTING_KEY_BLOCK_PRIVATE
1735 * @see SystemContract#ENHANCED_SETTING_KEY_BLOCK_PAYPHONE
1736 * @see SystemContract#ENHANCED_SETTING_KEY_BLOCK_UNKNOWN
1739 * 1. For Single SIM(SS) device, it can be customized in both carrier_config_mccmnc.xml
1742 * 2. For Dual SIM(DS) device, it should be customized in vendor.xml, since call blocking
1743 * function is used regardless of SIM.
1745 * If {@code true} enable enhanced call blocking feature on the device, {@code false} otherwise.
1748 public static final String KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL =
1749 "support_enhanced_call_blocking_bool";
1752 * For carriers which require an empty flash to be sent before sending the normal 3-way calling
1753 * flash, the duration in milliseconds of the empty flash to send. When {@code 0}, no empty
1756 public static final String KEY_CDMA_3WAYCALL_FLASH_DELAY_INT = "cdma_3waycall_flash_delay_int";
1759 * The CDMA roaming mode (aka CDMA system select).
1761 * <p>The value should be one of the CDMA_ROAMING_MODE_ constants in {@link TelephonyManager}.
1762 * Values other than {@link TelephonyManager#CDMA_ROAMING_MODE_RADIO_DEFAULT} (which is the
1763 * default) will take precedence over user selection.
1765 * @see TelephonyManager#CDMA_ROAMING_MODE_RADIO_DEFAULT
1766 * @see TelephonyManager#CDMA_ROAMING_MODE_HOME
1767 * @see TelephonyManager#CDMA_ROAMING_MODE_AFFILIATED
1768 * @see TelephonyManager#CDMA_ROAMING_MODE_ANY
1770 public static final String KEY_CDMA_ROAMING_MODE_INT = "cdma_roaming_mode_int";
1774 * Boolean indicating if support is provided for directly dialing FDN number from FDN list.
1775 * If false, this feature is not supported.
1778 public static final String KEY_SUPPORT_DIRECT_FDN_DIALING_BOOL =
1779 "support_direct_fdn_dialing_bool";
1782 * Report IMEI as device id even if it's a CDMA/LTE phone.
1786 public static final String KEY_FORCE_IMEI_BOOL = "force_imei_bool";
1789 * The families of Radio Access Technologies that will get clustered and ratcheted,
1790 * ie, we will report transitions up within the family, but not down until we change
1791 * cells. This prevents flapping between base technologies and higher techs that are
1792 * granted on demand within the cell.
1795 public static final String KEY_RATCHET_RAT_FAMILIES =
1796 "ratchet_rat_families";
1799 * Flag indicating whether some telephony logic will treat a call which was formerly a video
1800 * call as if it is still a video call. When {@code true}:
1802 * Logic which will automatically drop a video call which takes place over WIFI when a
1803 * voice call is answered (see {@link #KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL}.
1805 * Logic which determines whether the user can use TTY calling.
1807 public static final String KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL =
1808 "treat_downgraded_video_calls_as_video_calls_bool";
1811 * When {@code true}, if the user is in an ongoing video call over WIFI and answers an incoming
1812 * audio call, the video call will be disconnected before the audio call is answered. This is
1813 * in contrast to the usual expected behavior where a foreground video call would be put into
1814 * the background and held when an incoming audio call is answered.
1816 public static final String KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL =
1817 "drop_video_call_when_answering_audio_call_bool";
1820 * Flag indicating whether the carrier supports merging wifi calls when VoWIFI is disabled.
1821 * This can happen in the case of a carrier which allows offloading video calls to WIFI
1822 * separately of whether voice over wifi is enabled. In such a scenario when two video calls
1823 * are downgraded to voice, they remain over wifi. However, if VoWIFI is disabled, these calls
1826 public static final String KEY_ALLOW_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL =
1827 "allow_merge_wifi_calls_when_vowifi_off_bool";
1830 * Flag indicating whether the carrier supports the Hold command while in an IMS call.
1832 * The device configuration value {@code config_device_respects_hold_carrier_config} ultimately
1833 * controls whether this carrier configuration option is used. Where
1834 * {@code config_device_respects_hold_carrier_config} is false, the value of the
1835 * {@link #KEY_ALLOW_HOLD_IN_IMS_CALL_BOOL} carrier configuration option is ignored.
1838 public static final String KEY_ALLOW_HOLD_IN_IMS_CALL_BOOL = "allow_hold_in_ims_call";
1841 * Flag indicating whether the carrier supports call deflection for an incoming IMS call.
1844 public static final String KEY_CARRIER_ALLOW_DEFLECT_IMS_CALL_BOOL =
1845 "carrier_allow_deflect_ims_call_bool";
1848 * Flag indicating whether the carrier always wants to play an "on-hold" tone when a call has
1849 * been remotely held.
1851 * When {@code true}, if the IMS stack indicates that the call session has been held, a signal
1852 * will be sent from Telephony to play an audible "on-hold" tone played to the user.
1853 * When {@code false}, a hold tone will only be played if the audio session becomes inactive.
1856 public static final String KEY_ALWAYS_PLAY_REMOTE_HOLD_TONE_BOOL =
1857 "always_play_remote_hold_tone_bool";
1860 * When true, the Telephony stack will automatically turn off airplane mode and retry a wifi
1861 * emergency call over the cell network if the initial attempt at dialing was met with a SIP 308
1865 public static final String KEY_AUTO_RETRY_FAILED_WIFI_EMERGENCY_CALL =
1866 "auto_retry_failed_wifi_emergency_call";
1869 * When true, indicates that adding a call is disabled when there is an ongoing video call
1870 * or when there is an ongoing call on wifi which was downgraded from video and VoWifi is
1873 public static final String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL =
1874 "allow_add_call_during_video_call";
1877 * When true, indicates that the HD audio icon in the in-call screen should not be shown for
1881 public static final String KEY_WIFI_CALLS_CAN_BE_HD_AUDIO = "wifi_calls_can_be_hd_audio";
1884 * When true, indicates that the HD audio icon in the in-call screen should not be shown for
1888 public static final String KEY_VIDEO_CALLS_CAN_BE_HD_AUDIO = "video_calls_can_be_hd_audio";
1891 * When true, indicates that the HD audio icon in the in-call screen should be shown for
1895 public static final String KEY_GSM_CDMA_CALLS_CAN_BE_HD_AUDIO =
1896 "gsm_cdma_calls_can_be_hd_audio";
1899 * Whether system apps are allowed to use fallback if carrier video call is not available.
1900 * Defaults to {@code true}.
1904 public static final String KEY_ALLOW_VIDEO_CALLING_FALLBACK_BOOL =
1905 "allow_video_calling_fallback_bool";
1908 * Defines operator-specific {@link ImsReasonInfo} mappings.
1910 * Format: "ORIGINAL_CODE|MESSAGE|NEW_CODE"
1911 * Where {@code ORIGINAL_CODE} corresponds to a {@link ImsReasonInfo#getCode()} code,
1912 * {@code MESSAGE} corresponds to an expected {@link ImsReasonInfo#getExtraMessage()} string,
1913 * and {@code NEW_CODE} is the new {@code ImsReasonInfo#CODE_*} which this combination of
1914 * original code and message shall be remapped to.
1916 * Note: If {@code *} is specified for the original code, any ImsReasonInfo with the matching
1917 * {@code MESSAGE} will be remapped to {@code NEW_CODE}.
1919 * Example: "501|call completion elsewhere|1014"
1920 * When the {@link ImsReasonInfo#getCode()} is {@link ImsReasonInfo#CODE_USER_TERMINATED} and
1921 * the {@link ImsReasonInfo#getExtraMessage()} is {@code "call completion elsewhere"},
1922 * {@link ImsReasonInfo#CODE_ANSWERED_ELSEWHERE} shall be used as the {@link ImsReasonInfo}
1926 public static final String KEY_IMS_REASONINFO_MAPPING_STRING_ARRAY =
1927 "ims_reasoninfo_mapping_string_array";
1930 * When {@code false}, use default title for Enhanced 4G LTE Mode settings.
1931 * When {@code true}, use the variant.
1933 * @deprecated use {@link #KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT}.
1936 public static final String KEY_ENHANCED_4G_LTE_TITLE_VARIANT_BOOL =
1937 "enhanced_4g_lte_title_variant_bool";
1940 * The index indicates the carrier specified title string of Enahnce 4G LTE Mode settings.
1941 * Default value is 0, which indicates the default title string.
1944 public static final String KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT =
1945 "enhanced_4g_lte_title_variant_int";
1948 * Indicates whether the carrier wants to notify the user when handover of an LTE video call to
1951 * When {@code true}, if a video call starts on LTE and the modem reports a failure to handover
1952 * the call to WIFI or if no handover success is reported within 60 seconds of call initiation,
1953 * the {@link android.telephony.TelephonyManager#EVENT_HANDOVER_TO_WIFI_FAILED} event is raised
1954 * on the connection.
1957 public static final String KEY_NOTIFY_VT_HANDOVER_TO_WIFI_FAILURE_BOOL =
1958 "notify_vt_handover_to_wifi_failure_bool";
1961 * A upper case list of CNAP names that are unhelpful to the user for distinguising calls and
1962 * should be filtered out of the CNAP information. This includes CNAP names such as "WIRELESS
1963 * CALLER" or "UNKNOWN NAME". By default, if there are no filtered names for this carrier, null
1967 public static final String KEY_FILTERED_CNAP_NAMES_STRING_ARRAY = "filtered_cnap_names_string_array";
1970 * The RCS configuration server URL. This URL is used to initiate RCS provisioning.
1972 public static final String KEY_RCS_CONFIG_SERVER_URL_STRING = "rcs_config_server_url_string";
1975 * Determine whether user can change Wi-Fi Calling preference in roaming.
1976 * {@code false} - roaming preference cannot be changed by user independently. If
1977 * {@link #KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL} is false,
1978 * {@link #KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT} is used as the default
1979 * value. If {@link #KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL} is
1980 * true, roaming preference is the same as home preference and
1981 * {@link #KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT} is used as the default value.
1982 * {@code true} - roaming preference can be changed by user independently if
1983 * {@link #KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL} is false. If
1984 * {@link #KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL} is true, this
1985 * configuration is ignored and roaming preference cannot be changed.
1988 public static final String KEY_EDITABLE_WFC_ROAMING_MODE_BOOL =
1989 "editable_wfc_roaming_mode_bool";
1992 * Flag specifying wether to show blocking pay phone option in blocked numbers screen. Only show
1993 * the option if payphone call presentation represents in the carrier's region.
1996 public static final java.lang.String KEY_SHOW_BLOCKING_PAY_PHONE_OPTION_BOOL =
1997 "show_blocking_pay_phone_option_bool";
2000 * Flag specifying whether the carrier will use the WFC home network mode in roaming network.
2001 * {@code false} - roaming preference can be selected separately from the home preference.
2002 * {@code true} - roaming preference is the same as home preference and
2003 * {@link #KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT} is used as the default value.
2006 public static final String KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL =
2007 "use_wfc_home_network_mode_in_roaming_network_bool";
2010 * Flag specifying whether the carrier is allowed to use metered network to download a
2011 * certificate of Carrier-WiFi.
2012 * {@code false} - default value.
2016 public static final String KEY_ALLOW_METERED_NETWORK_FOR_CERT_DOWNLOAD_BOOL =
2017 "allow_metered_network_for_cert_download_bool";
2020 * Carrier specified WiFi networks.
2023 public static final String KEY_CARRIER_WIFI_STRING_ARRAY = "carrier_wifi_string_array";
2026 * Time delay (in ms) after which we show the notification to switch the preferred
2030 public static final String KEY_PREF_NETWORK_NOTIFICATION_DELAY_INT =
2031 "network_notification_delay_int";
2034 * Time delay (in ms) after which we show the notification for emergency calls,
2035 * while the device is registered over WFC. Default value is -1, which indicates
2036 * that this notification is not pertinent for a particular carrier. We've added a delay
2037 * to prevent false positives.
2040 public static final String KEY_EMERGENCY_NOTIFICATION_DELAY_INT =
2041 "emergency_notification_delay_int";
2044 * When {@code true}, the carrier allows the user of the
2045 * {@link TelephonyManager#sendUssdRequest(String, TelephonyManager.UssdResponseCallback,
2046 * Handler)} API to perform USSD requests. {@code True} by default.
2049 public static final String KEY_ALLOW_USSD_REQUESTS_VIA_TELEPHONY_MANAGER_BOOL =
2050 "allow_ussd_requests_via_telephony_manager_bool";
2053 * Indicates whether the carrier supports 3gpp call forwarding MMI codes while roaming. If
2054 * false, the user will be notified that call forwarding is not available when the MMI code
2057 public static final String KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL =
2058 "support_3gpp_call_forwarding_while_roaming_bool";
2061 * Boolean indicating whether to display voicemail number as default call forwarding number in
2062 * call forwarding settings.
2063 * If true, display vm number when cf number is null.
2064 * If false, display the cf number from network.
2065 * By default this value is false.
2068 public static final String KEY_DISPLAY_VOICEMAIL_NUMBER_AS_DEFAULT_CALL_FORWARDING_NUMBER_BOOL =
2069 "display_voicemail_number_as_default_call_forwarding_number";
2072 * When {@code true}, the user will be notified when they attempt to place an international call
2073 * when the call is placed using wifi calling.
2076 public static final String KEY_NOTIFY_INTERNATIONAL_CALL_ON_WFC_BOOL =
2077 "notify_international_call_on_wfc_bool";
2080 * Flag to hide Preset APN details. If true, user cannot enter ApnEditor view of Preset APN,
2081 * and cannot view details of the APN. If false, user can enter ApnEditor view of Preset APN.
2082 * Default value is false.
2084 public static final String KEY_HIDE_PRESET_APN_DETAILS_BOOL = "hide_preset_apn_details_bool";
2087 * Flag specifying whether to show an alert dialog for video call charges.
2088 * By default this value is {@code false}.
2091 public static final String KEY_SHOW_VIDEO_CALL_CHARGES_ALERT_DIALOG_BOOL =
2092 "show_video_call_charges_alert_dialog_bool";
2095 * An array containing custom call forwarding number prefixes that will be blocked while the
2096 * device is reporting that it is roaming. By default, there are no custom call
2097 * forwarding prefixes and none of these numbers will be filtered. If one or more entries are
2098 * present, the system will not complete the call and display an error message.
2100 * To display a message to the user when call forwarding fails for 3gpp MMI codes while roaming,
2101 * use the {@link #KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL} option instead.
2103 public static final String KEY_CALL_FORWARDING_BLOCKS_WHILE_ROAMING_STRING_ARRAY =
2104 "call_forwarding_blocks_while_roaming_string_array";
2107 * The day of the month (1-31) on which the data cycle rolls over.
2109 * If the current month does not have this day, the cycle will roll over at
2110 * the start of the next month.
2112 * This setting may be still overridden by explicit user choice. By default,
2113 * the platform value will be used.
2115 public static final String KEY_MONTHLY_DATA_CYCLE_DAY_INT =
2116 "monthly_data_cycle_day_int";
2119 * When {@link #KEY_MONTHLY_DATA_CYCLE_DAY_INT}, {@link #KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG},
2120 * or {@link #KEY_DATA_WARNING_THRESHOLD_BYTES_LONG} are set to this value, the platform default
2121 * value will be used for that key.
2126 public static final int DATA_CYCLE_USE_PLATFORM_DEFAULT = -1;
2129 * Flag indicating that a data cycle threshold should be disabled.
2131 * If {@link #KEY_DATA_WARNING_THRESHOLD_BYTES_LONG} is set to this value, the platform's
2132 * default data warning, if one exists, will be disabled. A user selected data warning will not
2135 * If {@link #KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG} is set to this value, the platform's
2136 * default data limit, if one exists, will be disabled. A user selected data limit will not be
2139 public static final int DATA_CYCLE_THRESHOLD_DISABLED = -2;
2142 * Controls the data usage warning.
2144 * If the user uses more than this amount of data in their billing cycle, as defined by
2145 * {@link #KEY_MONTHLY_DATA_CYCLE_DAY_INT}, the user will be alerted about the usage.
2146 * If the value is set to {@link #DATA_CYCLE_THRESHOLD_DISABLED}, the data usage warning will
2149 * This setting may be overridden by explicit user choice. By default, the platform value
2152 public static final String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG =
2153 "data_warning_threshold_bytes_long";
2156 * Controls if the device should automatically notify the user as they reach
2157 * their cellular data warning. When set to {@code false} the carrier is
2158 * expected to have implemented their own notification mechanism.
2161 public static final String KEY_DATA_WARNING_NOTIFICATION_BOOL =
2162 "data_warning_notification_bool";
2165 * Controls if the device should automatically warn the user that sim voice & data function
2166 * might be limited due to dual sim scenario. When set to {@true} display the notification,
2167 * {@code false} otherwise.
2170 public static final String KEY_LIMITED_SIM_FUNCTION_NOTIFICATION_FOR_DSDS_BOOL =
2171 "limited_sim_function_notification_for_dsds_bool";
2174 * Controls the cellular data limit.
2176 * If the user uses more than this amount of data in their billing cycle, as defined by
2177 * {@link #KEY_MONTHLY_DATA_CYCLE_DAY_INT}, cellular data will be turned off by the user's
2178 * phone. If the value is set to {@link #DATA_CYCLE_THRESHOLD_DISABLED}, the data limit will be
2181 * This setting may be overridden by explicit user choice. By default, the platform value
2184 public static final String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG =
2185 "data_limit_threshold_bytes_long";
2188 * Controls if the device should automatically notify the user as they reach
2189 * their cellular data limit. When set to {@code false} the carrier is
2190 * expected to have implemented their own notification mechanism.
2193 public static final String KEY_DATA_LIMIT_NOTIFICATION_BOOL =
2194 "data_limit_notification_bool";
2197 * Controls if the device should automatically notify the user when rapid
2198 * cellular data usage is observed. When set to {@code false} the carrier is
2199 * expected to have implemented their own notification mechanism.
2202 public static final String KEY_DATA_RAPID_NOTIFICATION_BOOL =
2203 "data_rapid_notification_bool";
2206 * Offset to be reduced from rsrp threshold while calculating signal strength level.
2209 public static final String KEY_LTE_EARFCNS_RSRP_BOOST_INT = "lte_earfcns_rsrp_boost_int";
2212 * List of EARFCN (E-UTRA Absolute Radio Frequency Channel Number,
2213 * Reference: 3GPP TS 36.104 5.4.3) inclusive ranges on which lte_rsrp_boost_int
2214 * will be applied. Format of the String array is expected to be {"erafcn1_start-earfcn1_end",
2215 * "earfcn2_start-earfcn2_end" ... }
2218 public static final String KEY_BOOSTED_LTE_EARFCNS_STRING_ARRAY =
2219 "boosted_lte_earfcns_string_array";
2222 * Determine whether to use only RSRP for the number of LTE signal bars.
2225 // FIXME: this key and related keys must not be exposed without a consistent philosophy for
2227 public static final String KEY_USE_ONLY_RSRP_FOR_LTE_SIGNAL_BAR_BOOL =
2228 "use_only_rsrp_for_lte_signal_bar_bool";
2231 * Key identifying if voice call barring notification is required to be shown to the user.
2234 @UnsupportedAppUsage
2235 public static final String KEY_DISABLE_VOICE_BARRING_NOTIFICATION_BOOL =
2236 "disable_voice_barring_notification_bool";
2239 * List of operators considered non-roaming which won't show roaming icon.
2241 * Can use mcc or mcc+mnc as item. For example, 302 or 21407.
2242 * If operators, 21404 and 21407, make roaming agreements, users of 21404 should not see
2243 * the roaming icon as using 21407 network.
2246 public static final String KEY_NON_ROAMING_OPERATOR_STRING_ARRAY =
2247 "non_roaming_operator_string_array";
2250 * List of operators considered roaming with the roaming icon.
2252 * Can use mcc or mcc+mnc as item. For example, 302 or 21407.
2253 * If operators, 21404 and 21407, make roaming agreements, users of 21404 should see
2254 * the roaming icon as using 21407 network.
2256 * A match on this supersedes a match on {@link #KEY_NON_ROAMING_OPERATOR_STRING_ARRAY}.
2259 public static final String KEY_ROAMING_OPERATOR_STRING_ARRAY =
2260 "roaming_operator_string_array";
2263 * URL from which the proto containing the public key of the Carrier used for
2264 * IMSI encryption will be downloaded.
2267 public static final String IMSI_KEY_DOWNLOAD_URL_STRING = "imsi_key_download_url_string";
2270 * Identifies if the key is available for WLAN or EPDG or both. The value is a bitmask.
2271 * 0 indicates that neither EPDG or WLAN is enabled.
2272 * 1 indicates that key type {@link TelephonyManager#KEY_TYPE_EPDG} is enabled.
2273 * 2 indicates that key type {@link TelephonyManager#KEY_TYPE_WLAN} is enabled.
2274 * 3 indicates that both are enabled.
2277 public static final String IMSI_KEY_AVAILABILITY_INT = "imsi_key_availability_int";
2281 * Key identifying if the CDMA Caller ID presentation and suppression MMI codes
2282 * should be converted to 3GPP CLIR codes when a multimode (CDMA+UMTS+LTE) device is roaming
2283 * on a 3GPP network. Specifically *67<number> will be converted to #31#<number> and
2284 * *82<number> will be converted to *31#<number> before dialing a call when this key is
2285 * set TRUE and device is roaming on a 3GPP network.
2288 public static final String KEY_CONVERT_CDMA_CALLER_ID_MMI_CODES_WHILE_ROAMING_ON_3GPP_BOOL =
2289 "convert_cdma_caller_id_mmi_codes_while_roaming_on_3gpp_bool";
2292 * Flag specifying whether IMS registration state menu is shown in Status Info setting,
2296 public static final String KEY_SHOW_IMS_REGISTRATION_STATUS_BOOL =
2297 "show_ims_registration_status_bool";
2300 * Flag indicating whether the carrier supports RTT over IMS.
2302 public static final String KEY_RTT_SUPPORTED_BOOL = "rtt_supported_bool";
2305 * Boolean flag indicating whether the carrier supports TTY.
2307 * Note that {@link #KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL} controls availability of TTY over
2308 * VoLTE; if {@link #KEY_TTY_SUPPORTED_BOOL} is disabled, then
2309 * {@link #KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL} is also implicitly disabled.
2311 * {@link TelecomManager#isTtySupported()} should be used to determine if a device supports TTY,
2312 * and this carrier config key should be used to see if the current carrier supports it.
2314 public static final String KEY_TTY_SUPPORTED_BOOL = "tty_supported_bool";
2317 * Indicates if the carrier supports auto-upgrading a call to RTT when receiving a call from a
2318 * RTT-supported device.
2321 public static final String KEY_RTT_AUTO_UPGRADE_BOOL = "rtt_auto_upgrade_bool";
2324 * Indicates if the carrier supports RTT during a video call.
2327 public static final String KEY_RTT_SUPPORTED_FOR_VT_BOOL = "rtt_supported_for_vt_bool";
2330 * Indicates if the carrier supports upgrading a voice call to an RTT call during the call.
2333 public static final String KEY_RTT_UPGRADE_SUPPORTED_BOOL = "rtt_upgrade_supported_bool";
2336 * Indicates if the carrier supports downgrading a RTT call to a voice call during the call.
2339 public static final String KEY_RTT_DOWNGRADE_SUPPORTED_BOOL = "rtt_downgrade_supported_bool";
2342 * Indicates if the TTY HCO and VCO options should be hidden in the accessibility menu
2343 * if the device is capable of RTT.
2346 public static final String KEY_HIDE_TTY_HCO_VCO_WITH_RTT_BOOL = "hide_tty_hco_vco_with_rtt";
2349 * The flag to disable the popup dialog which warns the user of data charges.
2352 public static final String KEY_DISABLE_CHARGE_INDICATION_BOOL =
2353 "disable_charge_indication_bool";
2356 * Boolean indicating whether to skip the call forwarding (CF) fail-to-disable dialog.
2357 * The logic used to determine whether we succeeded in disabling is carrier specific,
2358 * so the dialog may not always be accurate.
2359 * {@code false} - show CF fail-to-disable dialog.
2360 * {@code true} - skip showing CF fail-to-disable dialog.
2364 public static final String KEY_SKIP_CF_FAIL_TO_DISABLE_DIALOG_BOOL =
2365 "skip_cf_fail_to_disable_dialog_bool";
2368 * Flag specifying whether operator supports including no reply condition timer option on
2369 * CFNRy (3GPP TS 24.082 3: Call Forwarding on No Reply) in the call forwarding settings UI.
2370 * {@code true} - include no reply condition timer option on CFNRy
2371 * {@code false} - don't include no reply condition timer option on CFNRy
2375 public static final String KEY_SUPPORT_NO_REPLY_TIMER_FOR_CFNRY_BOOL =
2376 "support_no_reply_timer_for_cfnry_bool";
2379 * List of the FAC (feature access codes) to dial as a normal call.
2382 public static final String KEY_FEATURE_ACCESS_CODES_STRING_ARRAY =
2383 "feature_access_codes_string_array";
2386 * Determines if the carrier wants to identify high definition calls in the call log.
2389 public static final String KEY_IDENTIFY_HIGH_DEFINITION_CALLS_IN_CALL_LOG_BOOL =
2390 "identify_high_definition_calls_in_call_log_bool";
2393 * Flag specifying whether to use the {@link ServiceState} roaming status, which can be
2394 * affected by other carrier configs (e.g.
2395 * {@link #KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY}), when setting the SPN display.
2397 * If {@code true}, the SPN display uses {@link ServiceState#getRoaming}.
2398 * If {@code false} the SPN display checks if the current MCC/MNC is different from the
2399 * SIM card's MCC/MNC.
2401 * @see KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY
2402 * @see KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY
2403 * @see KEY_NON_ROAMING_OPERATOR_STRING_ARRAY
2404 * @see KEY_ROAMING_OPERATOR_STRING_ARRAY
2405 * @see KEY_FORCE_HOME_NETWORK_BOOL
2409 public static final String KEY_SPN_DISPLAY_RULE_USE_ROAMING_FROM_SERVICE_STATE_BOOL =
2410 "spn_display_rule_use_roaming_from_service_state_bool";
2413 * Determines whether any carrier has been identified and its specific config has been applied,
2417 public static final String KEY_CARRIER_CONFIG_APPLIED_BOOL = "carrier_config_applied_bool";
2420 * Determines whether we should show a warning asking the user to check with their carrier
2421 * on pricing when the user enabled data roaming.
2425 public static final String KEY_CHECK_PRICING_WITH_CARRIER_FOR_DATA_ROAMING_BOOL =
2426 "check_pricing_with_carrier_data_roaming_bool";
2429 * Determines whether we should show a notification when the phone established a data
2430 * connection in roaming network, to warn users about possible roaming charges.
2433 public static final String KEY_SHOW_DATA_CONNECTED_ROAMING_NOTIFICATION_BOOL =
2434 "show_data_connected_roaming_notification";
2437 * A list of 4 LTE RSRP thresholds above which a signal level is considered POOR,
2438 * MODERATE, GOOD, or EXCELLENT, to be used in SignalStrength reporting.
2440 * Note that the min and max thresholds are fixed at -140 and -44, as explained in
2441 * TS 136.133 9.1.4 - RSRP Measurement Report Mapping.
2443 * See SignalStrength#MAX_LTE_RSRP and SignalStrength#MIN_LTE_RSRP. Any signal level outside
2444 * these boundaries is considered invalid.
2447 public static final String KEY_LTE_RSRP_THRESHOLDS_INT_ARRAY =
2448 "lte_rsrp_thresholds_int_array";
2451 * Decides when clients try to bind to iwlan network service, which package name will
2452 * the binding intent go to.
2455 public static final String KEY_CARRIER_NETWORK_SERVICE_WLAN_PACKAGE_OVERRIDE_STRING =
2456 "carrier_network_service_wlan_package_override_string";
2459 * Decides when clients try to bind to wwan (cellular) network service, which package name will
2460 * the binding intent go to.
2463 public static final String KEY_CARRIER_NETWORK_SERVICE_WWAN_PACKAGE_OVERRIDE_STRING =
2464 "carrier_network_service_wwan_package_override_string";
2467 * The package name of qualified networks service that telephony binds to.
2471 public static final String KEY_CARRIER_QUALIFIED_NETWORKS_SERVICE_PACKAGE_OVERRIDE_STRING =
2472 "carrier_qualified_networks_service_package_override_string";
2474 * A list of 4 LTE RSCP thresholds above which a signal level is considered POOR,
2475 * MODERATE, GOOD, or EXCELLENT, to be used in SignalStrength reporting.
2477 * Note that the min and max thresholds are fixed at -120 and -24, as set in 3GPP TS 27.007
2480 * See SignalStrength#MAX_WCDMA_RSCP and SignalStrength#MIN_WDCMA_RSCP. Any signal level outside
2481 * these boundaries is considered invalid.
2484 public static final String KEY_WCDMA_RSCP_THRESHOLDS_INT_ARRAY =
2485 "wcdma_rscp_thresholds_int_array";
2488 * The default measurement to use for signal strength reporting. If this is not specified, the
2491 * e.g.) To use RSCP by default, set the value to "rscp". The signal strength level will
2492 * then be determined by #KEY_WCDMA_RSCP_THRESHOLDS_INT_ARRAY
2494 * Currently this supports the value "rscp" and "rssi".
2497 // FIXME: this key and related keys must not be exposed without a consistent philosophy for
2499 public static final String KEY_WCDMA_DEFAULT_SIGNAL_STRENGTH_MEASUREMENT_STRING =
2500 "wcdma_default_signal_strength_measurement_string";
2503 * When a partial sms / mms message stay in raw table for too long without being completed,
2504 * we expire them and delete them from the raw table. This carrier config defines the
2508 public static final String KEY_UNDELIVERED_SMS_MESSAGE_EXPIRATION_TIME =
2509 "undelivered_sms_message_expiration_time";
2512 * Specifies a carrier-defined {@link android.telecom.CallRedirectionService} which Telecom
2513 * will bind to for outgoing calls. An empty string indicates that no carrier-defined
2514 * {@link android.telecom.CallRedirectionService} is specified.
2517 public static final String KEY_CALL_REDIRECTION_SERVICE_COMPONENT_NAME_STRING =
2518 "call_redirection_service_component_name_string";
2520 * Support for the original string display of CDMA MO call.
2521 * By default, it is disabled.
2524 public static final String KEY_CONFIG_SHOW_ORIG_DIAL_STRING_FOR_CDMA_BOOL =
2525 "config_show_orig_dial_string_for_cdma";
2528 * Flag specifying whether to show notification(call blocking disabled) when Enhanced Call
2529 * Blocking(KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL) is enabled and making emergency call.
2530 * When true, notification is shown always.
2531 * When false, notification is shown only when any setting of "Enhanced Blocked number" is
2534 public static final String KEY_SHOW_CALL_BLOCKING_DISABLED_NOTIFICATION_ALWAYS_BOOL =
2535 "show_call_blocking_disabled_notification_always_bool";
2538 * Some carriers only support SS over UT via INTERNET PDN.
2539 * When mobile data is OFF or data roaming OFF during roaming,
2540 * UI should block the call forwarding operation and notify the user
2541 * that the function only works if data is available.
2544 public static final String KEY_CALL_FORWARDING_OVER_UT_WARNING_BOOL =
2545 "call_forwarding_over_ut_warning_bool";
2548 * Some carriers only support SS over UT via INTERNET PDN.
2549 * When mobile data is OFF or data roaming OFF during roaming,
2550 * UI should block the call barring operation and notify the user
2551 * that the function only works if data is available.
2554 public static final String KEY_CALL_BARRING_OVER_UT_WARNING_BOOL =
2555 "call_barring_over_ut_warning_bool";
2558 * Some carriers only support SS over UT via INTERNET PDN.
2559 * When mobile data is OFF or data roaming OFF during roaming,
2560 * UI should block the caller id operation and notify the user
2561 * that the function only works if data is available.
2564 public static final String KEY_CALLER_ID_OVER_UT_WARNING_BOOL =
2565 "caller_id_over_ut_warning_bool";
2568 * Some carriers only support SS over UT via INTERNET PDN.
2569 * When mobile data is OFF or data roaming OFF during roaming,
2570 * UI should block the call waiting operation and notify the user
2571 * that the function only works if data is available.
2574 public static final String KEY_CALL_WAITING_OVER_UT_WARNING_BOOL =
2575 "call_waiting_over_ut_warning_bool";
2578 * Flag indicating whether to support "Network default" option in Caller ID settings for Calling
2579 * Line Identification Restriction (CLIR).
2581 public static final String KEY_SUPPORT_CLIR_NETWORK_DEFAULT_BOOL =
2582 "support_clir_network_default_bool";
2585 * Determines whether the carrier want to support emergency dialer shortcut.
2588 public static final String KEY_SUPPORT_EMERGENCY_DIALER_SHORTCUT_BOOL =
2589 "support_emergency_dialer_shortcut_bool";
2592 * Call forwarding uses USSD command without SS command.
2593 * When {@code true}, the call forwarding query/set by ussd command and UI only display Call
2594 * Forwarding when unanswered.
2595 * When {@code false}, don't use USSD to query/set call forwarding.
2598 public static final String KEY_USE_CALL_FORWARDING_USSD_BOOL = "use_call_forwarding_ussd_bool";
2601 * This flag specifies whether to support for the caller id set command by ussd.
2602 * When {@code true}, device shall sync caller id ussd result to ss command.
2603 * When {@code false}, caller id don't support ussd command.
2606 public static final String KEY_USE_CALLER_ID_USSD_BOOL = "use_caller_id_ussd_bool";
2609 * Specifies the service class for call waiting service.
2611 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_VOICE}.
2613 * See 27.007 +CCFC or +CLCK.
2614 * The value set as below:
2615 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_NONE}
2616 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_VOICE}
2617 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_DATA}
2618 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_FAX}
2619 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_SMS}
2620 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_DATA_SYNC}
2621 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_DATA_ASYNC}
2622 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_PACKET}
2623 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_PAD}
2624 * {@link com.android.internal.telephony.CommandsInterface#SERVICE_CLASS_MAX}
2627 public static final String KEY_CALL_WAITING_SERVICE_CLASS_INT =
2628 "call_waiting_service_class_int";
2631 * This configuration allow the system UI to display different 5G icon for different 5G status.
2633 * There are four 5G status:
2634 * 1. connected_mmwave: device currently connected to 5G cell as the secondary cell and using
2636 * 2. connected: device currently connected to 5G cell as the secondary cell but not using
2638 * 3. not_restricted: device camped on a network that has 5G capability(not necessary to connect
2639 * a 5G cell as a secondary cell) and the use of 5G is not restricted.
2640 * 4. restricted: device camped on a network that has 5G capability(not necessary to connect a
2641 * 5G cell as a secondary cell) but the use of 5G is restricted.
2643 * The configured string contains multiple key-value pairs separated by comma. For each pair,
2644 * the key and value is separated by a colon. The key is corresponded to a 5G status above and
2645 * the value is the icon name. Use "None" as the icon name if no icon should be shown in a
2646 * specific 5G status.
2648 * Here is an example of the configuration:
2649 * "connected_mmwave:5GPlus,connected:5G,not_restricted:None,restricted:None"
2653 public static final String KEY_5G_ICON_CONFIGURATION_STRING =
2654 "5g_icon_configuration_string";
2657 * Support ASCII 7-BIT encoding for long SMS. This carrier config is used to enable
2661 public static final String KEY_ASCII_7_BIT_SUPPORT_FOR_LONG_MESSAGE_BOOL =
2662 "ascii_7_bit_support_for_long_message_bool";
2665 * Controls RSRP threshold at which OpportunisticNetworkService will decide whether
2666 * the opportunistic network is good enough for internet data.
2668 public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSRP_INT =
2669 "opportunistic_network_entry_threshold_rsrp_int";
2672 * Controls RSSNR threshold at which OpportunisticNetworkService will decide whether
2673 * the opportunistic network is good enough for internet data.
2675 public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSSNR_INT =
2676 "opportunistic_network_entry_threshold_rssnr_int";
2679 * Controls RSRP threshold below which OpportunisticNetworkService will decide whether
2680 * the opportunistic network available is not good enough for internet data.
2682 public static final String KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT =
2683 "opportunistic_network_exit_threshold_rsrp_int";
2686 * Controls RSSNR threshold below which OpportunisticNetworkService will decide whether
2687 * the opportunistic network available is not good enough for internet data.
2689 public static final String KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT =
2690 "opportunistic_network_exit_threshold_rssnr_int";
2693 * Controls bandwidth threshold in Kbps at which OpportunisticNetworkService will decide whether
2694 * the opportunistic network is good enough for internet data.
2696 public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_BANDWIDTH_INT =
2697 "opportunistic_network_entry_threshold_bandwidth_int";
2700 * Controls hysteresis time in milli seconds for which OpportunisticNetworkService
2701 * will wait before attaching to a network.
2703 public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_OR_EXIT_HYSTERESIS_TIME_LONG =
2704 "opportunistic_network_entry_or_exit_hysteresis_time_long";
2707 * Controls hysteresis time in milli seconds for which OpportunisticNetworkService
2708 * will wait before switching data to a network.
2710 public static final String KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG =
2711 "opportunistic_network_data_switch_hysteresis_time_long";
2714 * Indicates zero or more emergency number prefix(es), because some carrier requires
2715 * if users dial an emergency number address with a specific prefix, the combination of the
2716 * prefix and the address is also a valid emergency number to dial. For example, an emergency
2717 * number prefix is 318, and the emergency number is 911. Both 318911 and 911 can be dialed by
2718 * users for emergency call. An empty array of string indicates that current carrier does not
2719 * have this requirement.
2721 public static final String KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY =
2722 "emergency_number_prefix_string_array";
2725 * Smart forwarding config. Smart forwarding is a feature to configure call forwarding to a
2726 * different SIM in the device when one SIM is not reachable. The config here specifies a smart
2727 * forwarding component that will launch UI for changing the configuration. An empty string
2728 * indicates that no smart forwarding component is specified.
2730 * Currently, only one non-empty configuration of smart forwarding component within system will
2731 * be used when multiple SIMs are inserted.
2733 * Empty string by default.
2737 public static final String KEY_SMART_FORWARDING_CONFIG_COMPONENT_NAME_STRING =
2738 "smart_forwarding_config_component_name_string";
2741 * Indicates when a carrier has a primary subscription and an opportunistic subscription active,
2742 * and when Internet data is switched to opportunistic network, whether to still show
2743 * signal bar of primary network. By default it will be false, meaning whenever data
2744 * is going over opportunistic network, signal bar will reflect signal strength and rat
2745 * icon of that network.
2749 public static final String KEY_ALWAYS_SHOW_PRIMARY_SIGNAL_BAR_IN_OPPORTUNISTIC_NETWORK_BOOLEAN =
2750 "always_show_primary_signal_bar_in_opportunistic_network_boolean";
2753 * GPS configs. See android.hardware.gnss@1.0 IGnssConfiguration.
2756 public static final class Gps {
2757 /** Prefix of all Gps.KEY_* constants. */
2758 public static final String KEY_PREFIX = "gps.";
2761 * Location information during (and after) an emergency call is only provided over control
2762 * plane signaling from the network.
2765 public static final int SUPL_EMERGENCY_MODE_TYPE_CP_ONLY = 0;
2768 * Location information during (and after) an emergency call is provided over the data
2769 * plane and serviced by the framework GNSS service, but if it fails, the carrier also
2770 * supports control plane backup signaling.
2773 public static final int SUPL_EMERGENCY_MODE_TYPE_CP_FALLBACK = 1;
2776 * Location information during (and after) an emergency call is provided over the data plane
2777 * and serviced by the framework GNSS service only. There is no backup signalling over the
2778 * control plane if it fails.
2781 public static final int SUPL_EMERGENCY_MODE_TYPE_DP_ONLY = 2;
2785 * Determine whether current lpp_mode used for E-911 needs to be kept persistently.
2786 * {@code false} - not keeping the lpp_mode means using default configuration of gps.conf
2787 * when sim is not presented.
2788 * {@code true} - current lpp_profile of carrier will be kepted persistently
2789 * even after sim is removed. This is default.
2791 public static final String KEY_PERSIST_LPP_MODE_BOOL = KEY_PREFIX + "persist_lpp_mode_bool";
2794 * SUPL server host for SET Initiated & non-ES Network-Initiated SUPL requests.
2795 * Default to supl.google.com
2797 public static final String KEY_SUPL_HOST_STRING = KEY_PREFIX + "supl_host";
2799 /** SUPL server port. Default to 7275. */
2800 public static final String KEY_SUPL_PORT_STRING = KEY_PREFIX + "supl_port";
2803 * The SUPL version requested by Carrier. This is a bit mask
2804 * with bits 0:7 representing a service indicator field, bits 8:15
2805 * representing the minor version and bits 16:23 representing the
2806 * major version. Default to 0x20000.
2808 public static final String KEY_SUPL_VER_STRING = KEY_PREFIX + "supl_ver";
2811 * SUPL_MODE configuration bit mask
2812 * 1 - Mobile Station Based. This is default.
2813 * 2 - Mobile Station Assisted.
2815 public static final String KEY_SUPL_MODE_STRING = KEY_PREFIX + "supl_mode";
2818 * Whether to limit responses to SUPL ES mode requests only during user emergency sessions
2819 * (e.g. E911), and SUPL non-ES requests to only outside of non user emergency sessions.
2821 * 1 - yes. This is default.
2823 // TODO(b/119567985): name this key properly
2824 public static final String KEY_SUPL_ES_STRING = KEY_PREFIX + "supl_es";
2827 * LTE Positioning Profile settings bit mask.
2828 * 0 - Radio Resource Location Protocol in user plane and control plane. This is default.
2829 * 1 - Enable LTE Positioning Protocol in user plane.
2830 * 2 - Enable LTE Positioning Protocol in control plane.
2832 public static final String KEY_LPP_PROFILE_STRING = KEY_PREFIX + "lpp_profile";
2835 * Determine whether to use emergency PDN for emergency SUPL.
2837 * 1 - yes. This is default.
2839 public static final String KEY_USE_EMERGENCY_PDN_FOR_EMERGENCY_SUPL_STRING =
2840 KEY_PREFIX + "use_emergency_pdn_for_emergency_supl";
2843 * A_GLONASS_POS_PROTOCOL_SELECT bit mask.
2844 * 0 - Don't use A-GLONASS. This is default.
2845 * 1 - Use A-GLONASS in Radio Resource Control(RRC) control-plane.
2846 * 2 - Use A-GLONASS in Radio Resource Location user-plane.
2847 * 4 - Use A-GLONASS in LTE Positioning Protocol User plane.
2849 public static final String KEY_A_GLONASS_POS_PROTOCOL_SELECT_STRING =
2850 KEY_PREFIX + "a_glonass_pos_protocol_select";
2853 * GPS_LOCK configuration bit mask to specify GPS device behavior toward other services,
2854 * when Location Settings are off.
2856 * "1" - Lock Mobile Originated GPS functionalities.
2857 * "2" - Lock Network initiated GPS functionalities.
2858 * "3" - Lock both. This is default.
2860 public static final String KEY_GPS_LOCK_STRING = KEY_PREFIX + "gps_lock";
2863 * Control Plane / SUPL NI emergency extension time in seconds. Default to "0".
2865 public static final String KEY_ES_EXTENSION_SEC_STRING = KEY_PREFIX + "es_extension_sec";
2868 * Space separated list of Android package names of proxy applications representing
2869 * the non-framework entities requesting location directly from GNSS without involving
2870 * the framework, as managed by IGnssVisibilityControl.hal. For example,
2871 * "com.example.mdt com.example.ims".
2873 public static final String KEY_NFW_PROXY_APPS_STRING = KEY_PREFIX + "nfw_proxy_apps";
2876 * Determines whether or not SUPL ES mode supports a control-plane mechanism to get a user's
2877 * location in the event that data plane SUPL fails or is otherwise unavailable.
2879 * An integer value determines the support type of this carrier. If this carrier only
2880 * supports data plane SUPL ES, then the value will be
2881 * {@link #SUPL_EMERGENCY_MODE_TYPE_DP_ONLY}. If the carrier supports control plane fallback
2882 * for emergency SUPL, the value will be {@link #SUPL_EMERGENCY_MODE_TYPE_CP_FALLBACK}.
2883 * If the carrier does not support data plane SUPL using the framework, the value will be
2884 * {@link #SUPL_EMERGENCY_MODE_TYPE_CP_ONLY}.
2886 * The default value for this configuration is {@link #SUPL_EMERGENCY_MODE_TYPE_CP_ONLY}.
2889 public static final String KEY_ES_SUPL_CONTROL_PLANE_SUPPORT_INT = KEY_PREFIX
2890 + "es_supl_control_plane_support_int";
2892 private static PersistableBundle getDefaults() {
2893 PersistableBundle defaults = new PersistableBundle();
2894 defaults.putBoolean(KEY_PERSIST_LPP_MODE_BOOL, true);
2895 defaults.putString(KEY_SUPL_HOST_STRING, "supl.google.com");
2896 defaults.putString(KEY_SUPL_PORT_STRING, "7275");
2897 defaults.putString(KEY_SUPL_VER_STRING, "0x20000");
2898 defaults.putString(KEY_SUPL_MODE_STRING, "1");
2899 defaults.putString(KEY_SUPL_ES_STRING, "1");
2900 defaults.putString(KEY_LPP_PROFILE_STRING, "0");
2901 defaults.putString(KEY_USE_EMERGENCY_PDN_FOR_EMERGENCY_SUPL_STRING, "1");
2902 defaults.putString(KEY_A_GLONASS_POS_PROTOCOL_SELECT_STRING, "0");
2903 defaults.putString(KEY_GPS_LOCK_STRING, "3");
2904 defaults.putString(KEY_ES_EXTENSION_SEC_STRING, "0");
2905 defaults.putString(KEY_NFW_PROXY_APPS_STRING, "");
2906 defaults.putInt(KEY_ES_SUPL_CONTROL_PLANE_SUPPORT_INT,
2907 SUPL_EMERGENCY_MODE_TYPE_CP_ONLY);
2913 * Wi-Fi configs used in Carrier Wi-Fi application.
2914 * TODO(b/132059890): Expose it in a future release as systemapi.
2918 public static final class Wifi {
2919 /** Prefix of all Wifi.KEY_* constants. */
2920 public static final String KEY_PREFIX = "wifi.";
2923 * Whenever any information under wifi namespace is changed, the version should be
2924 * incremented by 1 so that the device is able to figure out the latest profiles based on
2927 public static final String KEY_CARRIER_PROFILES_VERSION_INT =
2928 KEY_PREFIX + "carrier_profiles_version_int";
2931 * It contains the package name of connection manager that the carrier owns.
2933 * <P>Once it is installed, the profiles installed by Carrier Wi-Fi Application
2935 * Once it is uninstalled, Carrier Wi-Fi Application will re-install the latest profiles.
2937 public static final String KEY_CARRIER_CONNECTION_MANAGER_PACKAGE_STRING =
2938 KEY_PREFIX + "carrier_connection_manager_package_string";
2940 * It is to have the list of wifi networks profiles which contain the information about
2941 * the wifi-networks to which carrier wants the device to connect.
2943 public static final String KEY_NETWORK_PROFILES_STRING_ARRAY =
2944 KEY_PREFIX + "network_profiles_string_array";
2947 * It is to have the list of Passpoint profiles which contain the information about
2948 * the Passpoint networks to which carrier wants the device to connect.
2950 public static final String KEY_PASSPOINT_PROFILES_STRING_ARRAY =
2951 KEY_PREFIX + "passpoint_profiles_string_array";
2953 private static PersistableBundle getDefaults() {
2954 PersistableBundle defaults = new PersistableBundle();
2955 defaults.putInt(KEY_CARRIER_PROFILES_VERSION_INT, -1);
2956 defaults.putString(KEY_CARRIER_CONNECTION_MANAGER_PACKAGE_STRING, null);
2957 defaults.putStringArray(KEY_NETWORK_PROFILES_STRING_ARRAY, null);
2958 defaults.putStringArray(KEY_PASSPOINT_PROFILES_STRING_ARRAY, null);
2966 * An int array containing CDMA enhanced roaming indicator values for Home (non-roaming) network.
2967 * The default values come from 3GPP2 C.R1001 table 8.1-1.
2968 * Enhanced Roaming Indicator Number Assignments
2972 public static final String KEY_CDMA_ENHANCED_ROAMING_INDICATOR_FOR_HOME_NETWORK_INT_ARRAY =
2973 "cdma_enhanced_roaming_indicator_for_home_network_int_array";
2976 * Determines whether wifi calling location privacy policy is shown.
2980 public static final String KEY_SHOW_WFC_LOCATION_PRIVACY_POLICY_BOOL =
2981 "show_wfc_location_privacy_policy_bool";
2984 * Indicates use 3GPP application to replace 3GPP2 application even if it's a CDMA/CDMA-LTE
2985 * phone, becasue some carriers's CSIM application is present but not supported.
2988 public static final String KEY_USE_USIM_BOOL = "use_usim_bool";
2991 * Determines whether the carrier wants to cancel the cs reject notification automatically
2992 * when the voice registration state changes.
2993 * If true, the notification will be automatically removed
2994 * when the voice registration state changes.
2995 * If false, the notification will persist until the user dismisses it,
2996 * the SIM is removed, or the device is rebooted.
2999 public static final String KEY_AUTO_CANCEL_CS_REJECT_NOTIFICATION =
3000 "carrier_auto_cancel_cs_notification";
3003 * Passing this value as {@link KEY_SUBSCRIPTION_GROUP_UUID_STRING} will remove the
3004 * subscription from a group instead of adding it to a group.
3006 * TODO: Expose in a future release.
3010 public static final String REMOVE_GROUP_UUID_STRING = "00000000-0000-0000-0000-000000000000";
3013 * The UUID of a Group of related subscriptions in which to place the current subscription.
3015 * A grouped subscription will behave for billing purposes and other UI purposes as though it
3016 * is a transparent extension of other subscriptions in the group.
3018 * <p>If set to {@link #REMOVE_GROUP_UUID_STRING}, then the subscription will be removed from
3019 * its current group.
3021 * TODO: unhide this key.
3025 public static final String KEY_SUBSCRIPTION_GROUP_UUID_STRING =
3026 "subscription_group_uuid_string";
3029 * A boolean property indicating whether this subscription should be managed as an opportunistic
3032 * If true, then this subscription will be selected based on available coverage and will not be
3033 * available for a user in settings menus for selecting macro network providers. If unset,
3034 * defaults to “false”.
3036 * TODO: unhide this key.
3040 public static final String KEY_IS_OPPORTUNISTIC_SUBSCRIPTION_BOOL =
3041 "is_opportunistic_subscription_bool";
3044 * A list of 4 GSM RSSI thresholds above which a signal level is considered POOR,
3045 * MODERATE, GOOD, or EXCELLENT, to be used in SignalStrength reporting.
3047 * Note that the min and max thresholds are fixed at -113 and -51, as set in 3GPP TS 27.007
3050 * See CellSignalStrengthGsm#GSM_RSSI_MAX and CellSignalStrengthGsm#GSM_RSSI_MIN. Any signal
3051 * level outside these boundaries is considered invalid.
3054 public static final String KEY_GSM_RSSI_THRESHOLDS_INT_ARRAY =
3055 "gsm_rssi_thresholds_int_array";
3058 * Determines whether Wireless Priority Service call is supported over IMS.
3060 * See Wireless Priority Service from https://www.fcc.gov/general/wireless-priority-service-wps
3063 public static final String KEY_SUPPORT_WPS_OVER_IMS_BOOL =
3064 "support_wps_over_ims_bool";
3066 /** The default value for every variable. */
3067 private final static PersistableBundle sDefaults;
3070 sDefaults = new PersistableBundle();
3071 sDefaults.putString(KEY_CARRIER_CONFIG_VERSION_STRING, "");
3072 sDefaults.putBoolean(KEY_ALLOW_HOLD_IN_IMS_CALL_BOOL, true);
3073 sDefaults.putBoolean(KEY_CARRIER_ALLOW_DEFLECT_IMS_CALL_BOOL, false);
3074 sDefaults.putBoolean(KEY_ALWAYS_PLAY_REMOTE_HOLD_TONE_BOOL, false);
3075 sDefaults.putBoolean(KEY_AUTO_RETRY_FAILED_WIFI_EMERGENCY_CALL, false);
3076 sDefaults.putBoolean(KEY_ADDITIONAL_CALL_SETTING_BOOL, true);
3077 sDefaults.putBoolean(KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL, false);
3078 sDefaults.putStringArray(KEY_UNLOGGABLE_NUMBERS_STRING_ARRAY, null);
3079 sDefaults.putBoolean(KEY_ALLOW_LOCAL_DTMF_TONES_BOOL, true);
3080 sDefaults.putBoolean(KEY_PLAY_CALL_RECORDING_TONE_BOOL, false);
3081 sDefaults.putBoolean(KEY_APN_EXPAND_BOOL, true);
3082 sDefaults.putBoolean(KEY_AUTO_RETRY_ENABLED_BOOL, false);
3083 sDefaults.putBoolean(KEY_CARRIER_SETTINGS_ENABLE_BOOL, false);
3084 sDefaults.putBoolean(KEY_CARRIER_VOLTE_AVAILABLE_BOOL, false);
3085 sDefaults.putBoolean(KEY_CARRIER_VT_AVAILABLE_BOOL, false);
3086 sDefaults.putBoolean(KEY_NOTIFY_HANDOVER_VIDEO_FROM_WIFI_TO_LTE_BOOL, false);
3087 sDefaults.putBoolean(KEY_ALLOW_MERGING_RTT_CALLS_BOOL, false);
3088 sDefaults.putBoolean(KEY_NOTIFY_HANDOVER_VIDEO_FROM_LTE_TO_WIFI_BOOL, false);
3089 sDefaults.putBoolean(KEY_SUPPORT_DOWNGRADE_VT_TO_AUDIO_BOOL, true);
3090 sDefaults.putString(KEY_DEFAULT_VM_NUMBER_STRING, "");
3091 sDefaults.putString(KEY_DEFAULT_VM_NUMBER_ROAMING_STRING, "");
3092 sDefaults.putBoolean(KEY_CONFIG_TELEPHONY_USE_OWN_NUMBER_FOR_VOICEMAIL_BOOL, false);
3093 sDefaults.putBoolean(KEY_IGNORE_DATA_ENABLED_CHANGED_FOR_VIDEO_CALLS, true);
3094 sDefaults.putBoolean(KEY_VILTE_DATA_IS_METERED_BOOL, true);
3095 sDefaults.putBoolean(KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL, false);
3096 sDefaults.putBoolean(KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL, false);
3097 sDefaults.putBoolean(KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL, false);
3098 sDefaults.putBoolean(KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL, false);
3099 sDefaults.putBoolean(KEY_CARRIER_PROMOTE_WFC_ON_CALL_FAIL_BOOL, false);
3100 sDefaults.putInt(KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT, 2);
3101 sDefaults.putInt(KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT, 2);
3102 sDefaults.putBoolean(KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL, false);
3103 sDefaults.putBoolean(KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL, false);
3104 sDefaults.putBoolean(KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL, false);
3105 sDefaults.putBoolean(KEY_CARRIER_SUPPORTS_SS_OVER_UT_BOOL, false);
3106 sDefaults.putBoolean(KEY_CARRIER_VOLTE_OVERRIDE_WFC_PROVISIONING_BOOL, false);
3107 sDefaults.putBoolean(KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL, true);
3108 sDefaults.putBoolean(KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL, true);
3109 sDefaults.putBoolean(KEY_CARRIER_IMS_GBA_REQUIRED_BOOL, false);
3110 sDefaults.putBoolean(KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL, false);
3111 sDefaults.putBoolean(KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL, true);
3112 sDefaults.putString(KEY_CARRIER_NETWORK_SERVICE_WWAN_PACKAGE_OVERRIDE_STRING, "");
3113 sDefaults.putString(KEY_CARRIER_NETWORK_SERVICE_WLAN_PACKAGE_OVERRIDE_STRING, "");
3114 sDefaults.putString(KEY_CARRIER_QUALIFIED_NETWORKS_SERVICE_PACKAGE_OVERRIDE_STRING, "");
3115 sDefaults.putString(KEY_CARRIER_DATA_SERVICE_WWAN_PACKAGE_OVERRIDE_STRING, "");
3116 sDefaults.putString(KEY_CARRIER_DATA_SERVICE_WLAN_PACKAGE_OVERRIDE_STRING, "");
3117 sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING, "");
3118 sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING, "");
3119 sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING, "");
3120 sDefaults.putInt(KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT, 64);
3121 sDefaults.putBoolean(KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL, false);
3122 sDefaults.putBoolean(KEY_DTMF_TYPE_ENABLED_BOOL, false);
3123 sDefaults.putBoolean(KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL, true);
3124 sDefaults.putBoolean(KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL, false);
3125 sDefaults.putBoolean(KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL, false);
3126 sDefaults.putBoolean(KEY_ONLY_AUTO_SELECT_IN_HOME_NETWORK_BOOL, false);
3127 sDefaults.putBoolean(KEY_SIMPLIFIED_NETWORK_SETTINGS_BOOL, false);
3128 sDefaults.putBoolean(KEY_HIDE_SIM_LOCK_SETTINGS_BOOL, false);
3130 sDefaults.putBoolean(KEY_CARRIER_VOLTE_PROVISIONED_BOOL, false);
3131 sDefaults.putBoolean(KEY_CALL_BARRING_VISIBILITY_BOOL, false);
3132 sDefaults.putBoolean(KEY_CALL_BARRING_SUPPORTS_PASSWORD_CHANGE_BOOL, true);
3133 sDefaults.putBoolean(KEY_CALL_BARRING_SUPPORTS_DEACTIVATE_ALL_BOOL, true);
3134 sDefaults.putBoolean(KEY_CALL_FORWARDING_VISIBILITY_BOOL, true);
3135 sDefaults.putBoolean(KEY_ADDITIONAL_SETTINGS_CALLER_ID_VISIBILITY_BOOL, true);
3136 sDefaults.putBoolean(KEY_ADDITIONAL_SETTINGS_CALL_WAITING_VISIBILITY_BOOL, true);
3137 sDefaults.putBoolean(KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL, false);
3138 sDefaults.putBoolean(KEY_MDN_IS_ADDITIONAL_VOICEMAIL_NUMBER_BOOL, false);
3139 sDefaults.putBoolean(KEY_OPERATOR_SELECTION_EXPAND_BOOL, true);
3140 sDefaults.putBoolean(KEY_PREFER_2G_BOOL, true);
3141 sDefaults.putBoolean(KEY_SHOW_APN_SETTING_CDMA_BOOL, false);
3142 sDefaults.putBoolean(KEY_SHOW_CDMA_CHOICES_BOOL, false);
3143 sDefaults.putBoolean(KEY_SMS_REQUIRES_DESTINATION_NUMBER_CONVERSION_BOOL, false);
3144 sDefaults.putBoolean(KEY_SUPPORT_EMERGENCY_SMS_OVER_IMS_BOOL, false);
3145 sDefaults.putBoolean(KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL, true);
3146 sDefaults.putBoolean(KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL, true);
3147 sDefaults.putBoolean(KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL, false);
3148 sDefaults.putBoolean(KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL, true);
3149 sDefaults.putBoolean(KEY_USE_HFA_FOR_PROVISIONING_BOOL, false);
3150 sDefaults.putBoolean(KEY_EDITABLE_VOICEMAIL_NUMBER_SETTING_BOOL, true);
3151 sDefaults.putBoolean(KEY_EDITABLE_VOICEMAIL_NUMBER_BOOL, false);
3152 sDefaults.putBoolean(KEY_USE_OTASP_FOR_PROVISIONING_BOOL, false);
3153 sDefaults.putBoolean(KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL, false);
3154 sDefaults.putBoolean(KEY_VOICE_PRIVACY_DISABLE_UI_BOOL, false);
3155 sDefaults.putBoolean(KEY_WORLD_PHONE_BOOL, false);
3156 sDefaults.putBoolean(KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL, true);
3157 sDefaults.putBoolean(KEY_RESTART_RADIO_ON_PDP_FAIL_REGULAR_DEACTIVATION_BOOL, false);
3158 sDefaults.putIntArray(KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY, new int[]{});
3159 sDefaults.putInt(KEY_VOLTE_REPLACEMENT_RAT_INT, 0);
3160 sDefaults.putString(KEY_DEFAULT_SIM_CALL_MANAGER_STRING, "");
3161 sDefaults.putString(KEY_VVM_DESTINATION_NUMBER_STRING, "");
3162 sDefaults.putInt(KEY_VVM_PORT_NUMBER_INT, 0);
3163 sDefaults.putString(KEY_VVM_TYPE_STRING, "");
3164 sDefaults.putBoolean(KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL, false);
3165 sDefaults.putString(KEY_VVM_CLIENT_PREFIX_STRING,"//VVM");
3166 sDefaults.putBoolean(KEY_VVM_SSL_ENABLED_BOOL,false);
3167 sDefaults.putStringArray(KEY_VVM_DISABLED_CAPABILITIES_STRING_ARRAY, null);
3168 sDefaults.putBoolean(KEY_VVM_LEGACY_MODE_ENABLED_BOOL,false);
3169 sDefaults.putBoolean(KEY_VVM_PREFETCH_BOOL, true);
3170 sDefaults.putString(KEY_CARRIER_VVM_PACKAGE_NAME_STRING, "");
3171 sDefaults.putStringArray(KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY, null);
3172 sDefaults.putBoolean(KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL, false);
3173 sDefaults.putBoolean(KEY_SHOW_SIGNAL_STRENGTH_IN_SIM_STATUS_BOOL, true);
3174 sDefaults.putBoolean(KEY_CI_ACTION_ON_SYS_UPDATE_BOOL, false);
3175 sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING, "");
3176 sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING, "");
3177 sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING, "");
3178 sDefaults.putBoolean(KEY_CSP_ENABLED_BOOL, false);
3179 sDefaults.putBoolean(KEY_ALLOW_ADDING_APNS_BOOL, true);
3180 sDefaults.putStringArray(KEY_READ_ONLY_APN_TYPES_STRING_ARRAY, new String[] {"dun"});
3181 sDefaults.putStringArray(KEY_READ_ONLY_APN_FIELDS_STRING_ARRAY, null);
3182 sDefaults.putBoolean(KEY_BROADCAST_EMERGENCY_CALL_STATE_CHANGES_BOOL, false);
3183 sDefaults.putBoolean(KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL, false);
3184 sDefaults.putBoolean(KEY_DISABLE_SEVERE_WHEN_EXTREME_DISABLED_BOOL, true);
3185 sDefaults.putLong(KEY_MESSAGE_EXPIRATION_TIME_LONG, 86400000L);
3186 sDefaults.putStringArray(KEY_CARRIER_DATA_CALL_RETRY_CONFIG_STRINGS, new String[]{
3187 "default:default_randomization=2000,5000,10000,20000,40000,80000:5000,160000:5000,"
3188 + "320000:5000,640000:5000,1280000:5000,1800000:5000",
3189 "mms:default_randomization=2000,5000,10000,20000,40000,80000:5000,160000:5000,"
3190 + "320000:5000,640000:5000,1280000:5000,1800000:5000",
3191 "others:max_retries=3, 5000, 5000, 5000"});
3192 sDefaults.putLong(KEY_CARRIER_DATA_CALL_APN_DELAY_DEFAULT_LONG, 20000);
3193 sDefaults.putLong(KEY_CARRIER_DATA_CALL_APN_DELAY_FASTER_LONG, 3000);
3194 sDefaults.putLong(KEY_CARRIER_DATA_CALL_APN_RETRY_AFTER_DISCONNECT_LONG, 10000);
3195 sDefaults.putString(KEY_CARRIER_ERI_FILE_NAME_STRING, "eri.xml");
3196 sDefaults.putInt(KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT, 7200);
3197 sDefaults.putStringArray(KEY_CARRIER_METERED_APN_TYPES_STRINGS,
3198 new String[]{"default", "mms", "dun", "supl"});
3199 sDefaults.putStringArray(KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS,
3200 new String[]{"default", "mms", "dun", "supl"});
3201 sDefaults.putStringArray(KEY_CARRIER_WWAN_DISALLOWED_APN_TYPES_STRING_ARRAY,
3203 sDefaults.putStringArray(KEY_CARRIER_WLAN_DISALLOWED_APN_TYPES_STRING_ARRAY,
3205 sDefaults.putIntArray(KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY,
3214 sDefaults.putStringArray(KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY, null);
3215 sDefaults.putStringArray(KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY, null);
3216 sDefaults.putString(KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING, null);
3217 sDefaults.putStringArray(KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY, null);
3218 sDefaults.putStringArray(KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY, null);
3219 sDefaults.putStringArray(KEY_DIAL_STRING_REPLACE_STRING_ARRAY, null);
3220 sDefaults.putBoolean(KEY_FORCE_HOME_NETWORK_BOOL, false);
3221 sDefaults.putInt(KEY_GSM_DTMF_TONE_DELAY_INT, 0);
3222 sDefaults.putInt(KEY_IMS_DTMF_TONE_DELAY_INT, 0);
3223 sDefaults.putInt(KEY_CDMA_DTMF_TONE_DELAY_INT, 100);
3224 sDefaults.putBoolean(KEY_CALL_FORWARDING_MAP_NON_NUMBER_TO_VOICEMAIL_BOOL, false);
3225 sDefaults.putBoolean(KEY_IGNORE_RTT_MODE_SETTING_BOOL, false);
3226 sDefaults.putInt(KEY_CDMA_3WAYCALL_FLASH_DELAY_INT , 0);
3227 sDefaults.putBoolean(KEY_SUPPORT_CONFERENCE_CALL_BOOL, true);
3228 sDefaults.putBoolean(KEY_SUPPORT_IMS_CONFERENCE_CALL_BOOL, true);
3229 sDefaults.putBoolean(KEY_SUPPORT_MANAGE_IMS_CONFERENCE_CALL_BOOL, true);
3230 sDefaults.putBoolean(KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL, true);
3231 sDefaults.putBoolean(KEY_SUPPORT_VIDEO_CONFERENCE_CALL_BOOL, false);
3232 sDefaults.putBoolean(KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL, false);
3233 sDefaults.putInt(KEY_IMS_CONFERENCE_SIZE_LIMIT_INT, 5);
3234 sDefaults.putBoolean(KEY_DISPLAY_HD_AUDIO_PROPERTY_BOOL, true);
3235 sDefaults.putBoolean(KEY_EDITABLE_ENHANCED_4G_LTE_BOOL, true);
3236 sDefaults.putBoolean(KEY_HIDE_ENHANCED_4G_LTE_BOOL, false);
3237 sDefaults.putBoolean(KEY_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL, true);
3238 sDefaults.putBoolean(KEY_HIDE_IMS_APN_BOOL, false);
3239 sDefaults.putBoolean(KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL, false);
3240 sDefaults.putBoolean(KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL, false);
3241 sDefaults.putStringArray(KEY_ENABLE_APPS_STRING_ARRAY, null);
3242 sDefaults.putBoolean(KEY_EDITABLE_WFC_MODE_BOOL, true);
3243 sDefaults.putStringArray(KEY_WFC_OPERATOR_ERROR_CODES_STRING_ARRAY, null);
3244 sDefaults.putInt(KEY_WFC_SPN_FORMAT_IDX_INT, 0);
3245 sDefaults.putInt(KEY_WFC_DATA_SPN_FORMAT_IDX_INT, 0);
3246 sDefaults.putInt(KEY_WFC_FLIGHT_MODE_SPN_FORMAT_IDX_INT, -1);
3247 sDefaults.putBoolean(KEY_WFC_SPN_USE_ROOT_LOCALE, false);
3248 sDefaults.putString(KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING, "");
3249 sDefaults.putBoolean(KEY_CONFIG_WIFI_DISABLE_IN_ECBM, false);
3250 sDefaults.putBoolean(KEY_CARRIER_NAME_OVERRIDE_BOOL, false);
3251 sDefaults.putString(KEY_CARRIER_NAME_STRING, "");
3252 sDefaults.putInt(KEY_SPN_DISPLAY_CONDITION_OVERRIDE_INT, -1);
3253 sDefaults.putStringArray(KEY_SPDI_OVERRIDE_STRING_ARRAY, null);
3254 sDefaults.putStringArray(KEY_PNN_OVERRIDE_STRING_ARRAY, null);
3255 sDefaults.putStringArray(KEY_OPL_OVERRIDE_STRING_ARRAY, null);
3256 sDefaults.putStringArray(KEY_EHPLMN_OVERRIDE_STRING_ARRAY, null);
3257 sDefaults.putBoolean(KEY_ALLOW_ERI_BOOL, false);
3258 sDefaults.putBoolean(KEY_ENABLE_CARRIER_DISPLAY_NAME_RESOLVER_BOOL, false);
3259 sDefaults.putString(KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING, "");
3260 sDefaults.putString(KEY_CARRIER_CALL_SCREENING_APP_STRING, "");
3261 sDefaults.putString(KEY_CALL_REDIRECTION_SERVICE_COMPONENT_NAME_STRING, null);
3262 sDefaults.putBoolean(KEY_CDMA_HOME_REGISTERED_PLMN_NAME_OVERRIDE_BOOL, false);
3263 sDefaults.putString(KEY_CDMA_HOME_REGISTERED_PLMN_NAME_STRING, "");
3264 sDefaults.putBoolean(KEY_SUPPORT_DIRECT_FDN_DIALING_BOOL, false);
3265 sDefaults.putBoolean(KEY_CARRIER_DEFAULT_DATA_ROAMING_ENABLED_BOOL, false);
3266 sDefaults.putBoolean(KEY_SKIP_CF_FAIL_TO_DISABLE_DIALOG_BOOL, false);
3267 sDefaults.putBoolean(KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL, true);
3270 sDefaults.putBoolean(KEY_MMS_ALIAS_ENABLED_BOOL, false);
3271 sDefaults.putBoolean(KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL, true);
3272 sDefaults.putBoolean(KEY_MMS_APPEND_TRANSACTION_ID_BOOL, false);
3273 sDefaults.putBoolean(KEY_MMS_GROUP_MMS_ENABLED_BOOL, true);
3274 sDefaults.putBoolean(KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL, false);
3275 sDefaults.putBoolean(KEY_MMS_MMS_ENABLED_BOOL, true);
3276 sDefaults.putBoolean(KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL, false);
3277 sDefaults.putBoolean(KEY_MMS_MULTIPART_SMS_ENABLED_BOOL, true);
3278 sDefaults.putBoolean(KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL, false);
3279 sDefaults.putBoolean(KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL, false);
3280 sDefaults.putBoolean(KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL, true);
3281 sDefaults.putBoolean(KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL, true);
3282 sDefaults.putBoolean(KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL, false);
3283 sDefaults.putBoolean(KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL, true);
3284 sDefaults.putBoolean(KEY_MMS_CLOSE_CONNECTION_BOOL, false);
3285 sDefaults.putInt(KEY_MMS_ALIAS_MAX_CHARS_INT, 48);
3286 sDefaults.putInt(KEY_MMS_ALIAS_MIN_CHARS_INT, 2);
3287 sDefaults.putInt(KEY_MMS_HTTP_SOCKET_TIMEOUT_INT, 60 * 1000);
3288 sDefaults.putInt(KEY_MMS_MAX_IMAGE_HEIGHT_INT, 480);
3289 sDefaults.putInt(KEY_MMS_MAX_IMAGE_WIDTH_INT, 640);
3290 sDefaults.putInt(KEY_MMS_MAX_MESSAGE_SIZE_INT, 300 * 1024);
3291 sDefaults.putInt(KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT, -1);
3292 sDefaults.putInt(KEY_MMS_RECIPIENT_LIMIT_INT, Integer.MAX_VALUE);
3293 sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT, -1);
3294 sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT, -1);
3295 sDefaults.putInt(KEY_MMS_SUBJECT_MAX_LENGTH_INT, 40);
3296 sDefaults.putString(KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING, "");
3297 sDefaults.putString(KEY_MMS_HTTP_PARAMS_STRING, "");
3298 sDefaults.putString(KEY_MMS_NAI_SUFFIX_STRING, "");
3299 sDefaults.putString(KEY_MMS_UA_PROF_TAG_NAME_STRING, "x-wap-profile");
3300 sDefaults.putString(KEY_MMS_UA_PROF_URL_STRING, "");
3301 sDefaults.putString(KEY_MMS_USER_AGENT_STRING, "");
3302 sDefaults.putBoolean(KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL, true);
3303 sDefaults.putInt(KEY_EMERGENCY_SMS_MODE_TIMER_MS_INT, 0);
3304 sDefaults.putBoolean(KEY_USE_RCS_PRESENCE_BOOL, false);
3305 sDefaults.putBoolean(KEY_FORCE_IMEI_BOOL, false);
3307 KEY_CDMA_ROAMING_MODE_INT, TelephonyManager.CDMA_ROAMING_MODE_RADIO_DEFAULT);
3308 sDefaults.putString(KEY_RCS_CONFIG_SERVER_URL_STRING, "");
3310 // Carrier Signalling Receivers
3311 sDefaults.putString(KEY_CARRIER_SETUP_APP_STRING, "");
3312 sDefaults.putStringArray(KEY_CARRIER_APP_WAKE_SIGNAL_CONFIG_STRING_ARRAY,
3314 "com.android.carrierdefaultapp/.CarrierDefaultBroadcastReceiver:"
3315 + "com.android.internal.telephony.CARRIER_SIGNAL_RESET"
3317 sDefaults.putStringArray(KEY_CARRIER_APP_NO_WAKE_SIGNAL_CONFIG_STRING_ARRAY, null);
3318 sDefaults.putBoolean(KEY_CARRIER_APP_REQUIRED_DURING_SIM_SETUP_BOOL, false);
3321 // Default carrier app configurations
3322 sDefaults.putStringArray(KEY_CARRIER_DEFAULT_ACTIONS_ON_REDIRECTION_STRING_ARRAY,
3325 //9: CARRIER_ACTION_REGISTER_NETWORK_AVAIL
3326 //4: CARRIER_ACTION_DISABLE_METERED_APNS
3327 //1: CARRIER_ACTION_SHOW_PORTAL_NOTIFICATION
3329 sDefaults.putStringArray(KEY_CARRIER_DEFAULT_ACTIONS_ON_RESET, new String[]{
3331 //6: CARRIER_ACTION_CANCEL_ALL_NOTIFICATIONS
3332 //8: CARRIER_ACTION_DISABLE_DEFAULT_URL_HANDLER
3334 sDefaults.putStringArray(KEY_CARRIER_DEFAULT_ACTIONS_ON_DEFAULT_NETWORK_AVAILABLE, new String[] {
3335 String.valueOf(false) + ": 7", //7: CARRIER_ACTION_ENABLE_DEFAULT_URL_HANDLER
3336 String.valueOf(true) + ": 8" //8: CARRIER_ACTION_DISABLE_DEFAULT_URL_HANDLER
3338 sDefaults.putStringArray(KEY_CARRIER_DEFAULT_REDIRECTION_URL_STRING_ARRAY, null);
3340 sDefaults.putInt(KEY_MONTHLY_DATA_CYCLE_DAY_INT, DATA_CYCLE_USE_PLATFORM_DEFAULT);
3341 sDefaults.putLong(KEY_DATA_WARNING_THRESHOLD_BYTES_LONG, DATA_CYCLE_USE_PLATFORM_DEFAULT);
3342 sDefaults.putBoolean(KEY_DATA_WARNING_NOTIFICATION_BOOL, true);
3343 sDefaults.putBoolean(KEY_LIMITED_SIM_FUNCTION_NOTIFICATION_FOR_DSDS_BOOL, false);
3344 sDefaults.putLong(KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG, DATA_CYCLE_USE_PLATFORM_DEFAULT);
3345 sDefaults.putBoolean(KEY_DATA_LIMIT_NOTIFICATION_BOOL, true);
3346 sDefaults.putBoolean(KEY_DATA_RAPID_NOTIFICATION_BOOL, true);
3348 // Rat families: {GPRS, EDGE}, {EVDO, EVDO_A, EVDO_B}, {UMTS, HSPA, HSDPA, HSUPA, HSPAP},
3350 // Order is important - lowest precidence first
3351 sDefaults.putStringArray(KEY_RATCHET_RAT_FAMILIES,
3352 new String[]{"1,2","7,8,12","3,11,9,10,15","14,19"});
3353 sDefaults.putBoolean(KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL, false);
3354 sDefaults.putBoolean(KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL, false);
3355 sDefaults.putBoolean(KEY_ALLOW_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL, true);
3356 sDefaults.putBoolean(KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL, true);
3357 sDefaults.putBoolean(KEY_WIFI_CALLS_CAN_BE_HD_AUDIO, true);
3358 sDefaults.putBoolean(KEY_VIDEO_CALLS_CAN_BE_HD_AUDIO, true);
3359 sDefaults.putBoolean(KEY_GSM_CDMA_CALLS_CAN_BE_HD_AUDIO, false);
3360 sDefaults.putBoolean(KEY_ALLOW_VIDEO_CALLING_FALLBACK_BOOL, true);
3362 sDefaults.putStringArray(KEY_IMS_REASONINFO_MAPPING_STRING_ARRAY, null);
3363 sDefaults.putBoolean(KEY_ENHANCED_4G_LTE_TITLE_VARIANT_BOOL, false);
3364 sDefaults.putInt(KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT, 0);
3365 sDefaults.putBoolean(KEY_NOTIFY_VT_HANDOVER_TO_WIFI_FAILURE_BOOL, false);
3366 sDefaults.putStringArray(KEY_FILTERED_CNAP_NAMES_STRING_ARRAY, null);
3367 sDefaults.putBoolean(KEY_EDITABLE_WFC_ROAMING_MODE_BOOL, false);
3368 sDefaults.putBoolean(KEY_SHOW_BLOCKING_PAY_PHONE_OPTION_BOOL, false);
3369 sDefaults.putBoolean(KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL, false);
3370 sDefaults.putBoolean(KEY_STK_DISABLE_LAUNCH_BROWSER_BOOL, false);
3371 sDefaults.putBoolean(KEY_ALLOW_METERED_NETWORK_FOR_CERT_DOWNLOAD_BOOL, false);
3372 sDefaults.putStringArray(KEY_CARRIER_WIFI_STRING_ARRAY, null);
3373 sDefaults.putInt(KEY_PREF_NETWORK_NOTIFICATION_DELAY_INT, -1);
3374 sDefaults.putInt(KEY_EMERGENCY_NOTIFICATION_DELAY_INT, -1);
3375 sDefaults.putBoolean(KEY_ALLOW_USSD_REQUESTS_VIA_TELEPHONY_MANAGER_BOOL, true);
3376 sDefaults.putBoolean(KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL, true);
3377 sDefaults.putBoolean(KEY_DISPLAY_VOICEMAIL_NUMBER_AS_DEFAULT_CALL_FORWARDING_NUMBER_BOOL,
3379 sDefaults.putBoolean(KEY_NOTIFY_INTERNATIONAL_CALL_ON_WFC_BOOL, false);
3380 sDefaults.putBoolean(KEY_HIDE_PRESET_APN_DETAILS_BOOL, false);
3381 sDefaults.putBoolean(KEY_SHOW_VIDEO_CALL_CHARGES_ALERT_DIALOG_BOOL, false);
3382 sDefaults.putStringArray(KEY_CALL_FORWARDING_BLOCKS_WHILE_ROAMING_STRING_ARRAY,
3384 sDefaults.putInt(KEY_LTE_EARFCNS_RSRP_BOOST_INT, 0);
3385 sDefaults.putStringArray(KEY_BOOSTED_LTE_EARFCNS_STRING_ARRAY, null);
3386 sDefaults.putBoolean(KEY_USE_ONLY_RSRP_FOR_LTE_SIGNAL_BAR_BOOL, false);
3387 sDefaults.putBoolean(KEY_DISABLE_VOICE_BARRING_NOTIFICATION_BOOL, false);
3388 sDefaults.putInt(IMSI_KEY_AVAILABILITY_INT, 0);
3389 sDefaults.putString(IMSI_KEY_DOWNLOAD_URL_STRING, null);
3390 sDefaults.putBoolean(KEY_CONVERT_CDMA_CALLER_ID_MMI_CODES_WHILE_ROAMING_ON_3GPP_BOOL,
3392 sDefaults.putStringArray(KEY_NON_ROAMING_OPERATOR_STRING_ARRAY, null);
3393 sDefaults.putStringArray(KEY_ROAMING_OPERATOR_STRING_ARRAY, null);
3394 sDefaults.putBoolean(KEY_SHOW_IMS_REGISTRATION_STATUS_BOOL, false);
3395 sDefaults.putBoolean(KEY_RTT_SUPPORTED_BOOL, false);
3396 sDefaults.putBoolean(KEY_TTY_SUPPORTED_BOOL, true);
3397 sDefaults.putBoolean(KEY_HIDE_TTY_HCO_VCO_WITH_RTT_BOOL, false);
3398 sDefaults.putBoolean(KEY_DISABLE_CHARGE_INDICATION_BOOL, false);
3399 sDefaults.putBoolean(KEY_SUPPORT_NO_REPLY_TIMER_FOR_CFNRY_BOOL, true);
3400 sDefaults.putStringArray(KEY_FEATURE_ACCESS_CODES_STRING_ARRAY, null);
3401 sDefaults.putBoolean(KEY_IDENTIFY_HIGH_DEFINITION_CALLS_IN_CALL_LOG_BOOL, false);
3402 sDefaults.putBoolean(KEY_SHOW_PRECISE_FAILED_CAUSE_BOOL, false);
3403 sDefaults.putBoolean(KEY_SPN_DISPLAY_RULE_USE_ROAMING_FROM_SERVICE_STATE_BOOL, false);
3404 sDefaults.putBoolean(KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL, false);
3405 sDefaults.putBoolean(KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL, false);
3406 sDefaults.putBoolean(KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL, false);
3407 sDefaults.putString(KEY_OPERATOR_NAME_FILTER_PATTERN_STRING, "");
3408 sDefaults.putString(KEY_SHOW_CARRIER_DATA_ICON_PATTERN_STRING, "");
3409 sDefaults.putBoolean(KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL, true);
3410 sDefaults.putBoolean(KEY_LTE_ENABLED_BOOL, true);
3411 sDefaults.putBoolean(KEY_SUPPORT_TDSCDMA_BOOL, false);
3412 sDefaults.putStringArray(KEY_SUPPORT_TDSCDMA_ROAMING_NETWORKS_STRING_ARRAY, null);
3413 sDefaults.putBoolean(KEY_WORLD_MODE_ENABLED_BOOL, false);
3414 sDefaults.putString(KEY_CARRIER_SETTINGS_ACTIVITY_COMPONENT_NAME_STRING, "");
3415 sDefaults.putBoolean(KEY_CARRIER_CONFIG_APPLIED_BOOL, false);
3416 sDefaults.putBoolean(KEY_CHECK_PRICING_WITH_CARRIER_FOR_DATA_ROAMING_BOOL, false);
3417 sDefaults.putBoolean(KEY_SHOW_DATA_CONNECTED_ROAMING_NOTIFICATION_BOOL, false);
3418 sDefaults.putIntArray(KEY_LTE_RSRP_THRESHOLDS_INT_ARRAY,
3420 -128, /* SIGNAL_STRENGTH_POOR */
3421 -118, /* SIGNAL_STRENGTH_MODERATE */
3422 -108, /* SIGNAL_STRENGTH_GOOD */
3423 -98, /* SIGNAL_STRENGTH_GREAT */
3425 sDefaults.putIntArray(KEY_WCDMA_RSCP_THRESHOLDS_INT_ARRAY,
3427 -115, /* SIGNAL_STRENGTH_POOR */
3428 -105, /* SIGNAL_STRENGTH_MODERATE */
3429 -95, /* SIGNAL_STRENGTH_GOOD */
3430 -85 /* SIGNAL_STRENGTH_GREAT */
3432 sDefaults.putString(KEY_WCDMA_DEFAULT_SIGNAL_STRENGTH_MEASUREMENT_STRING, "rssi");
3433 sDefaults.putBoolean(KEY_CONFIG_SHOW_ORIG_DIAL_STRING_FOR_CDMA_BOOL, false);
3434 sDefaults.putBoolean(KEY_SHOW_CALL_BLOCKING_DISABLED_NOTIFICATION_ALWAYS_BOOL, false);
3435 sDefaults.putBoolean(KEY_CALL_FORWARDING_OVER_UT_WARNING_BOOL, false);
3436 sDefaults.putBoolean(KEY_CALL_BARRING_OVER_UT_WARNING_BOOL, false);
3437 sDefaults.putBoolean(KEY_CALLER_ID_OVER_UT_WARNING_BOOL, false);
3438 sDefaults.putBoolean(KEY_CALL_WAITING_OVER_UT_WARNING_BOOL, false);
3439 sDefaults.putBoolean(KEY_SUPPORT_CLIR_NETWORK_DEFAULT_BOOL, true);
3440 sDefaults.putBoolean(KEY_SUPPORT_EMERGENCY_DIALER_SHORTCUT_BOOL, true);
3441 sDefaults.putBoolean(KEY_USE_CALL_FORWARDING_USSD_BOOL, false);
3442 sDefaults.putBoolean(KEY_USE_CALLER_ID_USSD_BOOL, false);
3443 sDefaults.putInt(KEY_CALL_WAITING_SERVICE_CLASS_INT, 1 /* SERVICE_CLASS_VOICE */);
3444 sDefaults.putString(KEY_5G_ICON_CONFIGURATION_STRING,
3445 "connected_mmwave:None,connected:5G,not_restricted:None,restricted:None");
3446 sDefaults.putBoolean(KEY_ASCII_7_BIT_SUPPORT_FOR_LONG_MESSAGE_BOOL, false);
3447 /* Default value is minimum RSRP level needed for SIGNAL_STRENGTH_GOOD */
3448 sDefaults.putInt(KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSRP_INT, -108);
3449 /* Default value is minimum RSRP level needed for SIGNAL_STRENGTH_MODERATE */
3450 sDefaults.putInt(KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT, -118);
3451 /* Default value is minimum RSSNR level needed for SIGNAL_STRENGTH_GOOD */
3452 sDefaults.putInt(KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSSNR_INT, 45);
3453 /* Default value is minimum RSSNR level needed for SIGNAL_STRENGTH_MODERATE */
3454 sDefaults.putInt(KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT, 10);
3455 /* Default value is 1024 kbps */
3456 sDefaults.putInt(KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_BANDWIDTH_INT, 1024);
3457 /* Default value is 10 seconds */
3458 sDefaults.putLong(KEY_OPPORTUNISTIC_NETWORK_ENTRY_OR_EXIT_HYSTERESIS_TIME_LONG, 10000);
3459 /* Default value is 10 seconds. */
3460 sDefaults.putLong(KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG, 10000);
3461 sDefaults.putAll(Gps.getDefaults());
3462 sDefaults.putAll(Wifi.getDefaults());
3463 sDefaults.putIntArray(KEY_CDMA_ENHANCED_ROAMING_INDICATOR_FOR_HOME_NETWORK_INT_ARRAY,
3465 1 /* Roaming Indicator Off */
3467 sDefaults.putStringArray(KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY, new String[0]);
3468 sDefaults.putBoolean(KEY_USE_USIM_BOOL, false);
3469 sDefaults.putBoolean(KEY_SHOW_WFC_LOCATION_PRIVACY_POLICY_BOOL, false);
3470 sDefaults.putBoolean(KEY_AUTO_CANCEL_CS_REJECT_NOTIFICATION, false);
3471 sDefaults.putString(KEY_SMART_FORWARDING_CONFIG_COMPONENT_NAME_STRING, "");
3472 sDefaults.putBoolean(KEY_ALWAYS_SHOW_PRIMARY_SIGNAL_BAR_IN_OPPORTUNISTIC_NETWORK_BOOLEAN,
3474 sDefaults.putString(KEY_SUBSCRIPTION_GROUP_UUID_STRING, "");
3475 sDefaults.putBoolean(KEY_IS_OPPORTUNISTIC_SUBSCRIPTION_BOOL, false);
3476 sDefaults.putIntArray(KEY_GSM_RSSI_THRESHOLDS_INT_ARRAY,
3478 -107, /* SIGNAL_STRENGTH_POOR */
3479 -103, /* SIGNAL_STRENGTH_MODERATE */
3480 -97, /* SIGNAL_STRENGTH_GOOD */
3481 -89, /* SIGNAL_STRENGTH_GREAT */
3483 sDefaults.putBoolean(KEY_SUPPORT_WPS_OVER_IMS_BOOL, true);
3487 * Gets the configuration values for a particular subscription, which is associated with a
3488 * specific SIM card. If an invalid subId is used, the returned config will contain default
3489 * values. After using this method to get the configuration bundle,
3490 * {@link #isConfigForIdentifiedCarrier(PersistableBundle)} should be called to confirm whether
3491 * any carrier specific configuration has been applied.
3493 * <p>Requires Permission:
3494 * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
3496 * @param subId the subscription ID, normally obtained from {@link SubscriptionManager}.
3497 * @return A {@link PersistableBundle} containing the config for the given subId, or default
3498 * values for an invalid subId.
3501 public PersistableBundle getConfigForSubId(int subId) {
3503 ICarrierConfigLoader loader = getICarrierConfigLoader();
3504 if (loader == null) {
3505 Rlog.w(TAG, "Error getting config for subId " + subId
3506 + " ICarrierConfigLoader is null");
3509 return loader.getConfigForSubId(subId, mContext.getOpPackageName());
3510 } catch (RemoteException ex) {
3511 Rlog.e(TAG, "Error getting config for subId " + subId + ": "
3518 * Overrides the carrier config of the provided subscription ID with the provided values.
3520 * Any further queries to carrier config from any process will return the overridden values
3521 * after this method returns. The overrides are effective for the lifetime of the phone process
3522 * until the user passes in {@code null} for {@code overrideValues}. This removes all previous
3523 * overrides and sets the carrier config back to production values.
3525 * May throw an {@link IllegalArgumentException} if {@code overrideValues} contains invalid
3526 * values for the specified config keys.
3528 * NOTE: This API is meant for testing purposes only.
3530 * @param subscriptionId The subscription ID for which the override should be done.
3531 * @param overrideValues Key-value pairs of the values that are to be overridden. If set to
3532 * {@code null}, this will remove all previous overrides and set the
3533 * carrier configuration back to production values.
3536 @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)
3539 public void overrideConfig(int subscriptionId, @Nullable PersistableBundle overrideValues) {
3541 ICarrierConfigLoader loader = getICarrierConfigLoader();
3542 if (loader == null) {
3543 Rlog.w(TAG, "Error setting config for subId " + subscriptionId
3544 + " ICarrierConfigLoader is null");
3547 loader.overrideConfig(subscriptionId, overrideValues);
3548 } catch (RemoteException ex) {
3549 Rlog.e(TAG, "Error setting config for subId " + subscriptionId + ": "
3555 * Gets the configuration values for the default subscription. After using this method to get
3556 * the configuration bundle, {@link #isConfigForIdentifiedCarrier(PersistableBundle)} should be
3557 * called to confirm whether any carrier specific configuration has been applied.
3559 * <p>Requires Permission:
3560 * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
3562 * @see #getConfigForSubId
3565 public PersistableBundle getConfig() {
3566 return getConfigForSubId(SubscriptionManager.getDefaultSubscriptionId());
3570 * Determines whether a configuration {@link PersistableBundle} obtained from
3571 * {@link #getConfig()} or {@link #getConfigForSubId(int)} corresponds to an identified carrier.
3573 * When an app receives the {@link CarrierConfigManager#ACTION_CARRIER_CONFIG_CHANGED}
3574 * broadcast which informs it that the carrier configuration has changed, it is possible
3575 * that another reload of the carrier configuration has begun since the intent was sent.
3576 * In this case, the carrier configuration the app fetches (e.g. via {@link #getConfig()})
3577 * may not represent the configuration for the current carrier. It should be noted that it
3578 * does not necessarily mean the configuration belongs to current carrier when this function
3579 * return true because it may belong to another previous identified carrier. Users should
3580 * always call {@link #getConfig()} or {@link #getConfigForSubId(int)} after receiving the
3581 * broadcast {@link #ACTION_CARRIER_CONFIG_CHANGED}.
3584 * After using {@link #getConfig()} or {@link #getConfigForSubId(int)} an app should always
3585 * use this method to confirm whether any carrier specific configuration has been applied.
3586 * Especially when an app misses the broadcast {@link #ACTION_CARRIER_CONFIG_CHANGED} but it
3587 * still needs to get the current configuration, it must use this method to verify whether the
3588 * configuration is default or carrier overridden.
3591 * @param bundle the configuration bundle to be checked.
3592 * @return boolean true if any carrier specific configuration bundle has been applied, false
3593 * otherwise or the bundle is null.
3595 public static boolean isConfigForIdentifiedCarrier(PersistableBundle bundle) {
3596 return bundle != null && bundle.getBoolean(KEY_CARRIER_CONFIG_APPLIED_BOOL);
3600 * Calling this method triggers telephony services to fetch the current carrier configuration.
3602 * Normally this does not need to be called because the platform reloads config on its own.
3603 * This should be called by a carrier service app if it wants to update config at an arbitrary
3606 * <p>Requires that the calling app has carrier privileges.
3608 * This method returns before the reload has completed, and
3609 * {@link android.service.carrier.CarrierService#onLoadConfig} will be called from an
3612 * @see TelephonyManager#hasCarrierPrivileges
3614 public void notifyConfigChangedForSubId(int subId) {
3616 ICarrierConfigLoader loader = getICarrierConfigLoader();
3617 if (loader == null) {
3618 Rlog.w(TAG, "Error reloading config for subId=" + subId
3619 + " ICarrierConfigLoader is null");
3622 loader.notifyConfigChangedForSubId(subId);
3623 } catch (RemoteException ex) {
3624 Rlog.e(TAG, "Error reloading config for subId=" + subId + ": " + ex.toString());
3629 * Request the carrier config loader to update the cofig for phoneId.
3631 * Depending on simState, the config may be cleared or loaded from config app. This is only used
3632 * by SubscriptionInfoUpdater.
3638 @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)
3639 public void updateConfigForPhoneId(int phoneId, String simState) {
3641 ICarrierConfigLoader loader = getICarrierConfigLoader();
3642 if (loader == null) {
3643 Rlog.w(TAG, "Error updating config for phoneId=" + phoneId
3644 + " ICarrierConfigLoader is null");
3647 loader.updateConfigForPhoneId(phoneId, simState);
3648 } catch (RemoteException ex) {
3649 Rlog.e(TAG, "Error updating config for phoneId=" + phoneId + ": " + ex.toString());
3654 public String getDefaultCarrierServicePackageName() {
3656 return getICarrierConfigLoader().getDefaultCarrierServicePackageName();
3657 } catch (Throwable t) {
3663 * Returns a new bundle with the default value for every supported configuration variable.
3669 @SuppressLint("Doclava125")
3670 public static PersistableBundle getDefaultConfig() {
3671 return new PersistableBundle(sDefaults);
3676 private ICarrierConfigLoader getICarrierConfigLoader() {
3677 return ICarrierConfigLoader.Stub
3678 .asInterface(ServiceManager.getService(Context.CARRIER_CONFIG_SERVICE));