Home | History | Annotate | Download | only in telephony
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package android.telephony;
     18 
     19 import android.annotation.NonNull;
     20 import android.annotation.Nullable;
     21 import android.annotation.SystemApi;
     22 import android.content.Context;
     23 import android.os.PersistableBundle;
     24 import android.os.RemoteException;
     25 import android.os.ServiceManager;
     26 
     27 import com.android.ims.ImsReasonInfo;
     28 import com.android.internal.telephony.ICarrierConfigLoader;
     29 
     30 /**
     31  * Provides access to telephony configuration values that are carrier-specific.
     32  * <p>
     33  * Users should obtain an instance of this class by calling
     34  * {@code mContext.getSystemService(Context.CARRIER_CONFIG_SERVICE);}
     35  * </p>
     36  *
     37  * @see Context#getSystemService
     38  * @see Context#CARRIER_CONFIG_SERVICE
     39  */
     40 public class CarrierConfigManager {
     41     private final static String TAG = "CarrierConfigManager";
     42 
     43     /**
     44      * @hide
     45      */
     46     public CarrierConfigManager() {
     47     }
     48 
     49     /**
     50      * This intent is broadcast by the system when carrier config changes.
     51      */
     52     public static final String
     53             ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";
     54 
     55     // Below are the keys used in carrier config bundles. To add a new variable, define the key and
     56     // give it a default value in sDefaults. If you need to ship a per-network override in the
     57     // system image, that can be added in packages/apps/CarrierConfig.
     58 
     59     /**
     60      * Flag indicating whether the Phone app should ignore EVENT_SIM_NETWORK_LOCKED
     61      * events from the Sim.
     62      * If true, this will prevent the IccNetworkDepersonalizationPanel from being shown, and
     63      * effectively disable the "Sim network lock" feature.
     64      */
     65     public static final String
     66             KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL = "ignore_sim_network_locked_events_bool";
     67 
     68     /**
     69      * Flag indicating whether the Phone app should provide a "Dismiss" button on the SIM network
     70      * unlock screen. The default value is true. If set to false, there will be *no way* to dismiss
     71      * the SIM network unlock screen if you don't enter the correct unlock code. (One important
     72      * consequence: there will be no way to make an Emergency Call if your SIM is network-locked and
     73      * you don't know the PIN.)
     74      */
     75     public static final String
     76             KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL = "sim_network_unlock_allow_dismiss_bool";
     77 
     78     /** Flag indicating if the phone is a world phone */
     79     public static final String KEY_WORLD_PHONE_BOOL = "world_phone_bool";
     80 
     81     /**
     82      * Flag to require or skip entitlement checks.
     83      * If true, entitlement checks will be executed if device has been configured for it,
     84      * If false, entitlement checks will be skipped.
     85      */
     86     public static final String
     87             KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL = "require_entitlement_checks_bool";
     88 
     89     /**
     90      * If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity.
     91      * The pattern is set on a per-platform basis using config_virtualKeyVibePattern. To be
     92      * consistent with the regular Dialer, this value should agree with the corresponding values
     93      * from config.xml under apps/Contacts.
     94      */
     95     public static final String
     96             KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL = "enable_dialer_key_vibration_bool";
     97 
     98     /** Flag indicating if dtmf tone type is enabled */
     99     public static final String KEY_DTMF_TYPE_ENABLED_BOOL = "dtmf_type_enabled_bool";
    100 
    101     /** Flag indicating if auto retry is enabled */
    102     public static final String KEY_AUTO_RETRY_ENABLED_BOOL = "auto_retry_enabled_bool";
    103 
    104     /**
    105      * Determine whether we want to play local DTMF tones in a call, or just let the radio/BP handle
    106      * playing of the tones.
    107      */
    108     public static final String KEY_ALLOW_LOCAL_DTMF_TONES_BOOL = "allow_local_dtmf_tones_bool";
    109 
    110     /**
    111      * If true, show an onscreen "Dial" button in the dialer. In practice this is used on all
    112      * platforms, even the ones with hard SEND/END keys, but for maximum flexibility it's controlled
    113      * by a flag here (which can be overridden on a per-product basis.)
    114      */
    115     public static final String KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL = "show_onscreen_dial_button_bool";
    116 
    117     /** Determines if device implements a noise suppression device for in call audio. */
    118     public static final String
    119             KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL = "has_in_call_noise_suppression_bool";
    120 
    121     /**
    122      * Determines if the current device should allow emergency numbers to be logged in the Call Log.
    123      * (Some carriers require that emergency calls *not* be logged, presumably to avoid the risk of
    124      * accidental redialing from the call log UI. This is a good idea, so the default here is
    125      * false.)
    126      */
    127     public static final String
    128             KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL = "allow_emergency_numbers_in_call_log_bool";
    129 
    130     /** If true, removes the Voice Privacy option from Call Settings */
    131     public static final String KEY_VOICE_PRIVACY_DISABLE_UI_BOOL = "voice_privacy_disable_ui_bool";
    132 
    133     /** Control whether users can reach the carrier portions of Cellular Network Settings. */
    134     public static final String
    135             KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL = "hide_carrier_network_settings_bool";
    136 
    137     /** Control whether users can reach the SIM lock settings. */
    138     public static final String
    139             KEY_HIDE_SIM_LOCK_SETTINGS_BOOL = "hide_sim_lock_settings_bool";
    140 
    141     /** Control whether users can edit APNs in Settings. */
    142     public static final String KEY_APN_EXPAND_BOOL = "apn_expand_bool";
    143 
    144     /** Control whether users can choose a network operator. */
    145     public static final String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";
    146 
    147     /** Used in Cellular Network Settings for preferred network type. */
    148     public static final String KEY_PREFER_2G_BOOL = "prefer_2g_bool";
    149 
    150     /** Show cdma network mode choices 1x, 3G, global etc. */
    151     public static final String KEY_SHOW_CDMA_CHOICES_BOOL = "show_cdma_choices_bool";
    152 
    153     /** CDMA activation goes through HFA */
    154     public static final String KEY_USE_HFA_FOR_PROVISIONING_BOOL = "use_hfa_for_provisioning_bool";
    155 
    156     /**
    157      * CDMA activation goes through OTASP.
    158      * <p>
    159      * TODO: This should be combined with config_use_hfa_for_provisioning and implemented as an enum
    160      * (NONE, HFA, OTASP).
    161      */
    162     public static final String KEY_USE_OTASP_FOR_PROVISIONING_BOOL = "use_otasp_for_provisioning_bool";
    163 
    164     /** Display carrier settings menu if true */
    165     public static final String KEY_CARRIER_SETTINGS_ENABLE_BOOL = "carrier_settings_enable_bool";
    166 
    167     /** Does not display additional call seting for IMS phone based on GSM Phone */
    168     public static final String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";
    169 
    170     /** Show APN Settings for some CDMA carriers */
    171     public static final String KEY_SHOW_APN_SETTING_CDMA_BOOL = "show_apn_setting_cdma_bool";
    172 
    173     /** After a CDMA conference call is merged, the swap button should be displayed. */
    174     public static final String KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL = "support_swap_after_merge_bool";
    175 
    176     /**
    177      * Determine whether the voicemail notification is persistent in the notification bar. If true,
    178      * the voicemail notifications cannot be dismissed from the notification bar.
    179      */
    180     public static final String
    181             KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL = "voicemail_notification_persistent_bool";
    182 
    183     /** For IMS video over LTE calls, determines whether video pause signalling is supported. */
    184     public static final String
    185             KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL = "support_pause_ims_video_calls_bool";
    186 
    187     /**
    188      * Disables dialing "*228" (OTASP provisioning) on CDMA carriers where it is not supported or is
    189      * potentially harmful by locking the SIM to 3G.
    190      */
    191     public static final String
    192             KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL = "disable_cdma_activation_code_bool";
    193 
    194     /**
    195      * Override the platform's notion of a network operator being considered roaming.
    196      * Value is string array of MCCMNCs to be considered roaming for 3GPP RATs.
    197      */
    198     public static final String
    199             KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY = "gsm_roaming_networks_string_array";
    200 
    201     /**
    202      * Override the platform's notion of a network operator being considered not roaming.
    203      * Value is string array of MCCMNCs to be considered not roaming for 3GPP RATs.
    204      */
    205     public static final String
    206             KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY = "gsm_nonroaming_networks_string_array";
    207 
    208     /**
    209      * Override the platform's notion of a network operator being considered roaming.
    210      * Value is string array of SIDs to be considered roaming for 3GPP2 RATs.
    211      */
    212     public static final String
    213             KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY = "cdma_roaming_networks_string_array";
    214 
    215     /**
    216      * Override the platform's notion of a network operator being considered non roaming.
    217      * Value is string array of SIDs to be considered not roaming for 3GPP2 RATs.
    218      */
    219     public static final String
    220             KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY = "cdma_nonroaming_networks_string_array";
    221 
    222     /**
    223      * Override the platform's notion of a network operator being considered non roaming.
    224      * If true all networks are considered as home network a.k.a non-roaming.  When false,
    225      * the 2 pairs of CMDA and GSM roaming/non-roaming arrays are consulted.
    226      *
    227      * @see KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY
    228      * @see KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY
    229      * @see KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
    230      * @see KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY
    231      */
    232     public static final String
    233             KEY_FORCE_HOME_NETWORK_BOOL = "force_home_network_bool";
    234 
    235     /**
    236      * Flag specifying whether VoLTE should be available for carrier, independent of carrier
    237      * provisioning. If false: hard disabled. If true: then depends on carrier provisioning,
    238      * availability, etc.
    239      */
    240     public static final String KEY_CARRIER_VOLTE_AVAILABLE_BOOL = "carrier_volte_available_bool";
    241 
    242     /**
    243      * Flag specifying whether video telephony is available for carrier. If false: hard disabled.
    244      * If true: then depends on carrier provisioning, availability, etc.
    245      */
    246     public static final String KEY_CARRIER_VT_AVAILABLE_BOOL = "carrier_vt_available_bool";
    247 
    248     /**
    249      * Flag specifying whether the carrier wants to notify the user when a VT call has been handed
    250      * over from WIFI to LTE.
    251      * <p>
    252      * The handover notification is sent as a
    253      * {@link TelephonyManager#EVENT_HANDOVER_VIDEO_FROM_WIFI_TO_LTE}
    254      * {@link android.telecom.Connection} event, which an {@link android.telecom.InCallService}
    255      * should use to trigger the display of a user-facing message.
    256      * <p>
    257      * The Connection event is sent to the InCallService only once, the first time it occurs.
    258      * @hide
    259      */
    260     public static final String KEY_NOTIFY_HANDOVER_VIDEO_FROM_WIFI_TO_LTE_BOOL =
    261             "notify_handover_video_from_wifi_to_lte_bool";
    262 
    263     /**
    264      * Flag specifying whether the carrier supports downgrading a video call (tx, rx or tx/rx)
    265      * directly to an audio call.
    266      * @hide
    267      */
    268     public static final String KEY_SUPPORT_DOWNGRADE_VT_TO_AUDIO_BOOL =
    269             "support_downgrade_vt_to_audio_bool";
    270 
    271     /**
    272      * Flag specifying whether WFC over IMS should be available for carrier: independent of
    273      * carrier provisioning. If false: hard disabled. If true: then depends on carrier
    274      * provisioning, availability etc.
    275      */
    276     public static final String KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL = "carrier_wfc_ims_available_bool";
    277 
    278     /**
    279      * Flag specifying whether WFC over IMS supports the "wifi only" option.  If false, the wifi
    280      * calling settings will not include an option for "wifi only".  If true, the wifi calling
    281      * settings will include an option for "wifi only"
    282      * <p>
    283      * By default, it is assumed that WFC supports "wifi only".
    284      */
    285     public static final String KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL =
    286             "carrier_wfc_supports_wifi_only_bool";
    287 
    288     /**
    289      * Default WFC_IMS_mode 0: WIFI_ONLY
    290      *                      1: CELLULAR_PREFERRED
    291      *                      2: WIFI_PREFERRED
    292      * @hide
    293      */
    294     public static final String KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT =
    295             "carrier_default_wfc_ims_mode_int";
    296     /**
    297      * Default WFC_IMS_enabled: true VoWiFi by default is on
    298      *                          false VoWiFi by default is off
    299      * @hide
    300      */
    301     public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL =
    302             "carrier_default_wfc_ims_enabled_bool";
    303 
    304     /**
    305      * Default WFC_IMS_roaming_enabled: true VoWiFi roaming by default is on
    306      *                                  false VoWiFi roaming by default is off
    307      * @hide
    308      */
    309     public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL =
    310             "carrier_default_wfc_ims_roaming_enabled_bool";
    311 
    312     /**
    313      * Flag indicating whether failed calls due to no service should prompt the user to enable
    314      * WIFI calling.  When {@code true}, if the user attempts to establish a call when there is no
    315      * service available, they are connected to WIFI, and WIFI calling is disabled, a different
    316      * call failure message will be used to encourage the user to enable WIFI calling.
    317      * @hide
    318      */
    319     public static final String KEY_CARRIER_PROMOTE_WFC_ON_CALL_FAIL_BOOL =
    320             "carrier_promote_wfc_on_call_fail_bool";
    321 
    322     /** Flag specifying whether provisioning is required for VOLTE. */
    323     public static final String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
    324             = "carrier_volte_provisioning_required_bool";
    325 
    326     /** Flag specifying whether VoLTE TTY is supported. */
    327     public static final String KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
    328             = "carrier_volte_tty_supported_bool";
    329 
    330     /**
    331      * Flag specifying whether IMS service can be turned off. If false then the service will not be
    332      * turned-off completely, but individual features can be disabled.
    333      */
    334     public static final String KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL
    335             = "carrier_allow_turnoff_ims_bool";
    336 
    337     /**
    338      * Flag specifying whether Generic Bootstrapping Architecture capable SIM is required for IMS.
    339      */
    340     public static final String KEY_CARRIER_IMS_GBA_REQUIRED_BOOL
    341             = "carrier_ims_gba_required_bool";
    342 
    343     /**
    344      * Flag specifying whether IMS instant lettering is available for the carrier.  {@code True} if
    345      * instant lettering is available for the carrier, {@code false} otherwise.
    346      */
    347     public static final String KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL =
    348             "carrier_instant_lettering_available_bool";
    349 
    350     /*
    351      * Flag specifying whether IMS should be the first phone attempted for E911 even if the
    352      * phone is not in service.
    353      */
    354     public static final String KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL
    355             = "carrier_use_ims_first_for_emergency_bool";
    356 
    357     /**
    358      * When IMS instant lettering is available for a carrier (see
    359      * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines the list of characters
    360      * which may not be contained in messages.  Should be specified as a regular expression suitable
    361      * for use with {@link String#matches(String)}.
    362      */
    363     public static final String KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING =
    364             "carrier_instant_lettering_invalid_chars_string";
    365 
    366     /**
    367      * When IMS instant lettering is available for a carrier (see
    368      * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines a list of characters which
    369      * must be escaped with a backslash '\' character.  Should be specified as a string containing
    370      * the characters to be escaped.  For example to escape quote and backslash the string would be
    371      * a quote and a backslash.
    372      */
    373     public static final String KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING =
    374             "carrier_instant_lettering_escaped_chars_string";
    375 
    376     /**
    377      * When IMS instant lettering is available for a carrier (see
    378      * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), determines the character encoding
    379      * which will be used when determining the length of messages.  Used in the InCall UI to limit
    380      * the number of characters the user may type.  If empty-string, the instant lettering
    381      * message size limit will be enforced on a 1:1 basis.  That is, each character will count
    382      * towards the messages size limit as a single bye.  If a character encoding is specified, the
    383      * message size limit will be based on the number of bytes in the message per the specified
    384      * encoding.
    385      */
    386     public static final String KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING =
    387             "carrier_instant_lettering_encoding_string";
    388 
    389     /**
    390      * When IMS instant lettering is available for a carrier (see
    391      * {@link #KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL}), the length limit for messages.  Used
    392      * in the InCall UI to ensure the user cannot enter more characters than allowed by the carrier.
    393      * See also {@link #KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING} for more information on how
    394      * the length of the message is calculated.
    395      */
    396     public static final String KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT =
    397             "carrier_instant_lettering_length_limit_int";
    398 
    399     /**
    400      * If Voice Radio Technology is RIL_RADIO_TECHNOLOGY_LTE:14 or RIL_RADIO_TECHNOLOGY_UNKNOWN:0
    401      * this is the value that should be used instead. A configuration value of
    402      * RIL_RADIO_TECHNOLOGY_UNKNOWN:0 means there is no replacement value and that the default
    403      * assumption for phone type (GSM) should be used.
    404      */
    405     public static final String KEY_VOLTE_REPLACEMENT_RAT_INT = "volte_replacement_rat_int";
    406 
    407     /**
    408      * The default sim call manager to use when the default dialer doesn't implement one. A sim call
    409      * manager can control and route outgoing and incoming phone calls, even if they're placed
    410      * using another connection service (PSTN, for example).
    411      */
    412     public static final String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";
    413 
    414     /**
    415      * The default flag specifying whether ETWS/CMAS test setting is forcibly disabled in
    416      * Settings->More->Emergency broadcasts menu even though developer options is turned on.
    417      */
    418     public static final String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL =
    419             "carrier_force_disable_etws_cmas_test_bool";
    420 
    421     /**
    422      * The default flag specifying whether "Turn on Notifications" option will be always shown in
    423      * Settings->More->Emergency broadcasts menu regardless developer options is turned on or not.
    424      */
    425     public static final String KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL =
    426             "always_show_emergency_alert_onoff_bool";
    427 
    428     /**
    429      * The flag to disable cell broadcast severe alert when extreme alert is disabled.
    430      * @hide
    431      */
    432     public static final String KEY_DISABLE_SEVERE_WHEN_EXTREME_DISABLED_BOOL =
    433             "disable_severe_when_extreme_disabled_bool";
    434 
    435     /**
    436      * The data call APN retry configuration for default type APN.
    437      * @hide
    438      */
    439     public static final String KEY_CARRIER_DATA_CALL_RETRY_CONFIG_DEFAULT_STRING =
    440             "carrier_data_call_retry_config_default_string";
    441 
    442     /**
    443      * The data call APN retry configuration for other type APNs.
    444      * @hide
    445      */
    446     public static final String KEY_CARRIER_DATA_CALL_RETRY_CONFIG_OTHERS_STRING =
    447             "carrier_data_call_retry_config_others_string";
    448 
    449     /**
    450      * Delay between trying APN from the pool
    451      * @hide
    452      */
    453     public static final String KEY_CARRIER_DATA_CALL_APN_DELAY_DEFAULT_LONG =
    454             "carrier_data_call_apn_delay_default_long";
    455 
    456     /**
    457      * Faster delay between trying APN from the pool
    458      * @hide
    459      */
    460     public static final String KEY_CARRIER_DATA_CALL_APN_DELAY_FASTER_LONG =
    461             "carrier_data_call_apn_delay_faster_long";
    462 
    463     /**
    464      * Default APN types that are metered by the carrier
    465      * @hide
    466      */
    467     public static final String KEY_CARRIER_METERED_APN_TYPES_STRINGS =
    468             "carrier_metered_apn_types_strings";
    469     /**
    470      * Default APN types that are roamig-metered by the carrier
    471      * @hide
    472      */
    473     public static final String KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS =
    474             "carrier_metered_roaming_apn_types_strings";
    475     /**
    476      * CDMA carrier ERI (Enhanced Roaming Indicator) file name
    477      * @hide
    478      */
    479     public static final String KEY_CARRIER_ERI_FILE_NAME_STRING =
    480             "carrier_eri_file_name_string";
    481 
    482     /* The following 3 fields are related to carrier visual voicemail. */
    483 
    484     /**
    485      * The carrier number mobile outgoing (MO) sms messages are sent to.
    486      */
    487     public static final String KEY_VVM_DESTINATION_NUMBER_STRING = "vvm_destination_number_string";
    488 
    489     /**
    490      * The port through which the mobile outgoing (MO) sms messages are sent through.
    491      */
    492     public static final String KEY_VVM_PORT_NUMBER_INT = "vvm_port_number_int";
    493 
    494     /**
    495      * The type of visual voicemail protocol the carrier adheres to. See {@link TelephonyManager}
    496      * for possible values. For example {@link TelephonyManager#VVM_TYPE_OMTP}.
    497      */
    498     public static final String KEY_VVM_TYPE_STRING = "vvm_type_string";
    499 
    500     /**
    501      * Whether cellular data is required to access visual voicemail.
    502      */
    503     public static final String KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL =
    504         "vvm_cellular_data_required_bool";
    505 
    506     /**
    507      * Whether to prefetch audio data on new voicemail arrival, defaulted to true.
    508      */
    509     public static final String KEY_VVM_PREFETCH_BOOL = "vvm_prefetch_bool";
    510 
    511     /**
    512      * The package name of the carrier's visual voicemail app to ensure that dialer visual voicemail
    513      * and carrier visual voicemail are not active at the same time.
    514      */
    515     public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING = "carrier_vvm_package_name_string";
    516 
    517     /**
    518      * Flag specifying whether ICCID is showed in SIM Status screen, default to false.
    519      */
    520     public static final String KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL = "show_iccid_in_sim_status_bool";
    521 
    522     /**
    523      * Flag specifying whether an additional (client initiated) intent needs to be sent on System
    524      * update
    525      */
    526     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_BOOL = "ci_action_on_sys_update_bool";
    527 
    528     /**
    529      * Intent to be sent for the additional action on System update
    530      */
    531     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING =
    532             "ci_action_on_sys_update_intent_string";
    533 
    534     /**
    535      * Extra to be included in the intent sent for additional action on System update
    536      */
    537     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING =
    538             "ci_action_on_sys_update_extra_string";
    539 
    540     /**
    541      * Value of extra included in intent sent for additional action on System update
    542      */
    543     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING =
    544             "ci_action_on_sys_update_extra_val_string";
    545 
    546     /**
    547      * Specifies the amount of gap to be added in millis between postdial DTMF tones. When a
    548      * non-zero value is specified, the UE shall wait for the specified amount of time before it
    549      * sends out successive DTMF tones on the network.
    550      */
    551     public static final String KEY_GSM_DTMF_TONE_DELAY_INT = "gsm_dtmf_tone_delay_int";
    552 
    553     /**
    554      * Specifies the amount of gap to be added in millis between DTMF tones. When a non-zero value
    555      * is specified, the UE shall wait for the specified amount of time before it sends out
    556      * successive DTMF tones on the network.
    557      */
    558     public static final String KEY_IMS_DTMF_TONE_DELAY_INT = "ims_dtmf_tone_delay_int";
    559 
    560     /**
    561      * Specifies the amount of gap to be added in millis between postdial DTMF tones. When a
    562      * non-zero value is specified, the UE shall wait for the specified amount of time before it
    563      * sends out successive DTMF tones on the network.
    564      */
    565     public static final String KEY_CDMA_DTMF_TONE_DELAY_INT = "cdma_dtmf_tone_delay_int";
    566 
    567     /**
    568      * Determines whether conference calls are supported by a carrier.  When {@code true},
    569      * conference calling is supported, {@code false otherwise}.
    570      */
    571     public static final String KEY_SUPPORT_CONFERENCE_CALL_BOOL = "support_conference_call_bool";
    572 
    573     /**
    574      * Determines whether video conference calls are supported by a carrier.  When {@code true},
    575      * video calls can be merged into conference calls, {@code false} otherwiwse.
    576      * <p>
    577      * Note: even if video conference calls are not supported, audio calls may be merged into a
    578      * conference if {@link #KEY_SUPPORT_CONFERENCE_CALL_BOOL} is {@code true}.
    579      * @hide
    580      */
    581     public static final String KEY_SUPPORT_VIDEO_CONFERENCE_CALL_BOOL =
    582             "support_video_conference_call_bool";
    583 
    584     /**
    585      * Determine whether user can toggle Enhanced 4G LTE Mode in Settings.
    586      */
    587     public static final String KEY_EDITABLE_ENHANCED_4G_LTE_BOOL = "editable_enhanced_4g_lte_bool";
    588 
    589     /**
    590      * Determine whether IMS apn can be shown.
    591      */
    592     public static final String KEY_HIDE_IMS_APN_BOOL = "hide_ims_apn_bool";
    593 
    594     /**
    595      * Determine whether preferred network type can be shown.
    596      */
    597     public static final String KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL = "hide_preferred_network_type_bool";
    598 
    599     /**
    600      * Determine whether user can switch Wi-Fi preferred or Cellular preferred in calling preference.
    601      * Some operators support Wi-Fi Calling only, not VoLTE.
    602      * They don't need "Cellular preferred" option.
    603      * In this case, set uneditalbe attribute for preferred preference.
    604      * @hide
    605      */
    606     public static final String KEY_EDITABLE_WFC_MODE_BOOL = "editable_wfc_mode_bool";
    607 
    608      /**
    609       * Flag to indicate if Wi-Fi needs to be disabled in ECBM
    610       * @hide
    611       **/
    612      public static final String
    613               KEY_CONFIG_WIFI_DISABLE_IN_ECBM = "config_wifi_disable_in_ecbm";
    614 
    615     /**
    616      * List operator-specific error codes and indices of corresponding error strings in
    617      * wfcOperatorErrorAlertMessages and wfcOperatorErrorNotificationMessages.
    618      *
    619      * Example: "REG09|0" specifies error code "REG09" and index "0". This index will be
    620      * used to find alert and notification messages in wfcOperatorErrorAlertMessages and
    621      * wfcOperatorErrorNotificationMessages.
    622      *
    623      * @hide
    624      */
    625     public static final String KEY_WFC_OPERATOR_ERROR_CODES_STRING_ARRAY =
    626             "wfc_operator_error_codes_string_array";
    627 
    628     /**
    629      * Indexes of SPN format strings in wfcSpnFormats and wfcDataSpnFormats.
    630      * @hide
    631      */
    632     public static final String KEY_WFC_SPN_FORMAT_IDX_INT = "wfc_spn_format_idx_int";
    633     /** @hide */
    634     public static final String KEY_WFC_DATA_SPN_FORMAT_IDX_INT = "wfc_data_spn_format_idx_int";
    635 
    636     /**
    637      * The Component Name of the activity that can setup the emergency addrees for WiFi Calling
    638      * as per carrier requirement.
    639      * @hide
    640      */
    641      public static final String KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING =
    642             "wfc_emergency_address_carrier_app_string";
    643 
    644     /**
    645      * Boolean to decide whether to use #KEY_CARRIER_NAME_STRING from CarrierConfig app.
    646      * @hide
    647      */
    648     public static final String KEY_CARRIER_NAME_OVERRIDE_BOOL = "carrier_name_override_bool";
    649 
    650     /**
    651      * String to identify carrier name in CarrierConfig app. This string is used only if
    652      * #KEY_CARRIER_NAME_OVERRIDE_BOOL is true
    653      * @hide
    654      */
    655     public static final String KEY_CARRIER_NAME_STRING = "carrier_name_string";
    656 
    657     /**
    658      * If this is true, the SIM card (through Customer Service Profile EF file) will be able to
    659      * prevent manual operator selection. If false, this SIM setting will be ignored and manual
    660      * operator selection will always be available. See CPHS4_2.WW6, CPHS B.4.7.1 for more
    661      * information
    662      */
    663     public static final String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";
    664 
    665     /**
    666      * Allow user to add APNs
    667      */
    668     public static final String KEY_ALLOW_ADDING_APNS_BOOL = "allow_adding_apns_bool";
    669 
    670     /**
    671      * Boolean indicating if intent for emergency call state changes should be broadcast
    672      * @hide
    673      */
    674     public static final String KEY_BROADCAST_EMERGENCY_CALL_STATE_CHANGES_BOOL =
    675             "broadcast_emergency_call_state_changes_bool";
    676 
    677     /**
    678      * Cell broadcast additional channels enbled by the carrier
    679      * @hide
    680      */
    681     public static final String KEY_CARRIER_ADDITIONAL_CBS_CHANNELS_STRINGS =
    682             "carrier_additional_cbs_channels_strings";
    683 
    684     // These variables are used by the MMS service and exposed through another API, {@link
    685     // SmsManager}. The variable names and string values are copied from there.
    686     public static final String KEY_MMS_ALIAS_ENABLED_BOOL = "aliasEnabled";
    687     public static final String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL = "allowAttachAudio";
    688     public static final String KEY_MMS_APPEND_TRANSACTION_ID_BOOL = "enabledTransID";
    689     public static final String KEY_MMS_GROUP_MMS_ENABLED_BOOL = "enableGroupMms";
    690     public static final String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL = "enableMMSDeliveryReports";
    691     public static final String KEY_MMS_MMS_ENABLED_BOOL = "enabledMMS";
    692     public static final String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL = "enableMMSReadReports";
    693     public static final String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL = "enableMultipartSMS";
    694     public static final String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL = "enabledNotifyWapMMSC";
    695     public static final String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL = "sendMultipartSmsAsSeparateMessages";
    696     public static final String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL = "config_cellBroadcastAppLinks";
    697     public static final String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL = "enableSMSDeliveryReports";
    698     public static final String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL = "supportHttpCharsetHeader";
    699     public static final String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL = "supportMmsContentDisposition";
    700     public static final String KEY_MMS_ALIAS_MAX_CHARS_INT = "aliasMaxChars";
    701     public static final String KEY_MMS_ALIAS_MIN_CHARS_INT = "aliasMinChars";
    702     public static final String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT = "httpSocketTimeout";
    703     public static final String KEY_MMS_MAX_IMAGE_HEIGHT_INT = "maxImageHeight";
    704     public static final String KEY_MMS_MAX_IMAGE_WIDTH_INT = "maxImageWidth";
    705     public static final String KEY_MMS_MAX_MESSAGE_SIZE_INT = "maxMessageSize";
    706     public static final String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT = "maxMessageTextSize";
    707     public static final String KEY_MMS_RECIPIENT_LIMIT_INT = "recipientLimit";
    708     public static final String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT = "smsToMmsTextLengthThreshold";
    709     public static final String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT = "smsToMmsTextThreshold";
    710     public static final String KEY_MMS_SUBJECT_MAX_LENGTH_INT = "maxSubjectLength";
    711     public static final String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING = "emailGatewayNumber";
    712     public static final String KEY_MMS_HTTP_PARAMS_STRING = "httpParams";
    713     public static final String KEY_MMS_NAI_SUFFIX_STRING = "naiSuffix";
    714     public static final String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";
    715     public static final String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";
    716     public static final String KEY_MMS_USER_AGENT_STRING = "userAgent";
    717     /** @hide */
    718     public static final String KEY_MMS_CLOSE_CONNECTION_BOOL = "mmsCloseConnection";
    719 
    720     /**
    721      * If carriers require differentiate un-provisioned status: cold sim or out of credit sim
    722      * a package name and activity name can be provided to launch a supported carrier application
    723      * that check the sim provisioning status
    724      * The first element is the package name and the second element is the activity name
    725      * of the provisioning app
    726      * example:
    727      * <item>com.google.android.carrierPackageName</item>
    728      * <item>com.google.android.carrierPackageName.CarrierActivityName</item>
    729      * The ComponentName of the carrier activity that can setup the device and activate with the
    730      * network as part of the Setup Wizard flow.
    731      * @hide
    732      */
    733      public static final String KEY_CARRIER_SETUP_APP_STRING = "carrier_setup_app_string";
    734 
    735     /**
    736      * A list of component name of carrier signalling receivers which are interested in intent
    737      * android.intent.action.CARRIER_SIGNAL_REDIRECTED.
    738      * Example:
    739      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameA</item>
    740      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameB</item>
    741      * @hide
    742      */
    743     public static final String KEY_SIGNAL_REDIRECTION_RECEIVER_STRING_ARRAY =
    744             "signal_redirection_receiver_string_array";
    745 
    746     /**
    747      * A list of component name of carrier signalling receivers which are interested in intent
    748      * android.intent.action.CARRIER_SIGNAL_REQUEST_NETWORK_FAILED.
    749      * Example:
    750      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameA</item>
    751      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameB</item>
    752      * @hide
    753      */
    754     public static final String KEY_SIGNAL_DCFAILURE_RECEIVER_STRING_ARRAY =
    755             "signal_dcfailure_receiver_string_array";
    756 
    757     /**
    758      * A list of component name of carrier signalling receivers which are interested in intent
    759      * android.intent.action.CARRIER_SIGNAL_PCO_VALUE.
    760      * Example:
    761      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameA</item>
    762      * <item>com.google.android.carrierPackageName/.CarrierSignalReceiverNameB</item>
    763      * @hide
    764      */
    765     public static final String KEY_SIGNAL_PCO_RECEIVER_STRING_ARRAY =
    766             "signal_pco_receiver_string_array";
    767 
    768     /**
    769      * Determines whether the carrier supports making non-emergency phone calls while the phone is
    770      * in emergency callback mode.  Default value is {@code true}, meaning that non-emergency calls
    771      * are allowed in emergency callback mode.
    772      */
    773     public static final String KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL =
    774             "allow_non_emergency_calls_in_ecm_bool";
    775 
    776     /**
    777      * Flag indicating whether to allow carrier video calls to emergency numbers.
    778      * When {@code true}, video calls to emergency numbers will be allowed.  When {@code false},
    779      * video calls to emergency numbers will be initiated as audio-only calls instead.
    780      */
    781     public static final String KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL =
    782             "allow_emergency_video_calls_bool";
    783 
    784     /**
    785      * Flag indicating whether the carrier supports RCS presence indication for video calls.  When
    786      * {@code true}, the carrier supports RCS presence indication for video calls.  When presence
    787      * is supported, the device should use the
    788      * {@link android.provider.ContactsContract.Data#CARRIER_PRESENCE} bit mask and set the
    789      * {@link android.provider.ContactsContract.Data#CARRIER_PRESENCE_VT_CAPABLE} bit to indicate
    790      * whether each contact supports video calling.  The UI is made aware that presence is enabled
    791      * via {@link android.telecom.PhoneAccount#CAPABILITY_VIDEO_CALLING_RELIES_ON_PRESENCE}
    792      * and can choose to hide or show the video calling icon based on whether a contact supports
    793      * video.
    794      */
    795     public static final String KEY_USE_RCS_PRESENCE_BOOL = "use_rcs_presence_bool";
    796 
    797     /**
    798      * The duration in seconds that platform call and message blocking is disabled after the user
    799      * contacts emergency services. Platform considers values in the range 0 to 604800 (one week) as
    800      * valid. See {@link android.provider.BlockedNumberContract#isBlocked(Context, String)}).
    801      */
    802     public static final String KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT =
    803             "duration_blocking_disabled_after_emergency_int";
    804 
    805     /**
    806      * @hide
    807      * The default value for preferred CDMA roaming mode (aka CDMA system select.)
    808      *          CDMA_ROAMING_MODE_RADIO_DEFAULT = the default roaming mode from the radio
    809      *          CDMA_ROAMING_MODE_HOME = Home Networks
    810      *          CDMA_ROAMING_MODE_AFFILIATED = Roaming on Affiliated networks
    811      *          CDMA_ROAMING_MODE_ANY = Roaming on any networks
    812      */
    813     public static final String KEY_CDMA_ROAMING_MODE_INT = "cdma_roaming_mode_int";
    814     /** @hide */
    815     public static final int CDMA_ROAMING_MODE_RADIO_DEFAULT = -1;
    816     /** @hide */
    817     public static final int CDMA_ROAMING_MODE_HOME = 0;
    818     /** @hide */
    819     public static final int CDMA_ROAMING_MODE_AFFILIATED = 1;
    820     /** @hide */
    821     public static final int CDMA_ROAMING_MODE_ANY = 2;
    822 
    823     /**
    824      * Report IMEI as device id even if it's a CDMA/LTE phone.
    825      *
    826      * @hide
    827      */
    828     public static final String KEY_FORCE_IMEI_BOOL = "force_imei_bool";
    829 
    830     /**
    831      * The families of Radio Access Technologies that will get clustered and ratcheted,
    832      * ie, we will report transitions up within the family, but not down until we change
    833      * cells.  This prevents flapping between base technologies and higher techs that are
    834      * granted on demand within the cell.
    835      * @hide
    836      */
    837     public static final String KEY_RATCHET_RAT_FAMILIES =
    838             "ratchet_rat_families";
    839 
    840     /**
    841      * Flag indicating whether some telephony logic will treat a call which was formerly a video
    842      * call as if it is still a video call.  When {@code true}:
    843      * <p>
    844      * Logic which will automatically drop a video call which takes place over WIFI when a
    845      * voice call is answered (see {@link #KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL}.
    846      * <p>
    847      * Logic which determines whether the user can use TTY calling.
    848      */
    849     public static final String KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL =
    850             "treat_downgraded_video_calls_as_video_calls_bool";
    851 
    852     /**
    853      * When {@code true}, if the user is in an ongoing video call over WIFI and answers an incoming
    854      * audio call, the video call will be disconnected before the audio call is answered.  This is
    855      * in contrast to the usual expected behavior where a foreground video call would be put into
    856      * the background and held when an incoming audio call is answered.
    857      */
    858     public static final String KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL =
    859             "drop_video_call_when_answering_audio_call_bool";
    860 
    861     /**
    862      * Flag indicating whether the carrier supports merging wifi calls when VoWIFI is disabled.
    863      * This can happen in the case of a carrier which allows offloading video calls to WIFI
    864      * separately of whether voice over wifi is enabled.  In such a scenario when two video calls
    865      * are downgraded to voice, they remain over wifi.  However, if VoWIFI is disabled, these calls
    866      * cannot be merged.
    867      */
    868     public static final String KEY_ALLOW_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL =
    869             "allow_merge_wifi_calls_when_vowifi_off_bool";
    870 
    871     /**
    872      * Flag indicating whether the carrier supports the Hold command while in an IMS call.
    873      * @hide
    874      */
    875     public static final String KEY_ALLOW_HOLD_IN_IMS_CALL_BOOL = "allow_hold_in_ims_call";
    876 
    877     /**
    878      * When true, indicates that adding a call is disabled when there is an ongoing video call
    879      * or when there is an ongoing call on wifi which was downgraded from video and VoWifi is
    880      * turned off.
    881      */
    882     public static final String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL =
    883             "allow_add_call_during_video_call";
    884 
    885     /**
    886      * When true, indicates that the HD audio icon in the in-call screen should not be shown for
    887      * VoWifi calls.
    888      * @hide
    889      */
    890     public static final String KEY_WIFI_CALLS_CAN_BE_HD_AUDIO = "wifi_calls_can_be_hd_audio";
    891 
    892     /**
    893      * When true, indicates that the HD audio icon in the in-call screen should not be shown for
    894      * video calls.
    895      * @hide
    896      */
    897     public static final String KEY_VIDEO_CALLS_CAN_BE_HD_AUDIO = "video_calls_can_be_hd_audio";
    898 
    899     /**
    900      * Defines operator-specific {@link com.android.ims.ImsReasonInfo} mappings.
    901      *
    902      * Format: "ORIGINAL_CODE|MESSAGE|NEW_CODE"
    903      * Where {@code ORIGINAL_CODE} corresponds to a {@link ImsReasonInfo#getCode()} code,
    904      * {@code MESSAGE} corresponds to an expected {@link ImsReasonInfo#getExtraMessage()} string,
    905      * and {@code NEW_CODE} is the new {@code ImsReasonInfo#CODE_*} which this combination of
    906      * original code and message shall be remapped to.
    907      *
    908      * Example: "501|call completion elsewhere|1014"
    909      * When the {@link ImsReasonInfo#getCode()} is {@link ImsReasonInfo#CODE_USER_TERMINATED} and
    910      * the {@link ImsReasonInfo#getExtraMessage()} is {@code "call completion elsewhere"},
    911      * {@link ImsReasonInfo#CODE_ANSWERED_ELSEWHERE} shall be used as the {@link ImsReasonInfo}
    912      * code instead.
    913      * @hide
    914      */
    915     public static final String KEY_IMS_REASONINFO_MAPPING_STRING_ARRAY =
    916             "ims_reasoninfo_mapping_string_array";
    917 
    918     /**
    919      * When {@code false}, use default title for Enhanced 4G LTE Mode settings.
    920      * When {@code true}, use the variant.
    921      * @hide
    922      */
    923     public static final String KEY_ENHANCED_4G_LTE_TITLE_VARIANT_BOOL =
    924             "enhanced_4g_lte_title_variant_bool";
    925 
    926     /**
    927      * Indicates whether the carrier wants to notify the user when handover of an LTE video call to
    928      * WIFI fails.
    929      * <p>
    930      * When {@code true}, if a video call starts on LTE and the modem reports a failure to handover
    931      * the call to WIFI or if no handover success is reported within 60 seconds of call initiation,
    932      * the {@link android.telephony.TelephonyManager#EVENT_HANDOVER_TO_WIFI_FAILED} event is raised
    933      * on the connection.
    934      * @hide
    935      */
    936     public static final String KEY_NOTIFY_VT_HANDOVER_TO_WIFI_FAILURE_BOOL =
    937             "notify_vt_handover_to_wifi_failure_bool";
    938 
    939     /**
    940      * A upper case list of CNAP names that are unhelpful to the user for distinguising calls and
    941      * should be filtered out of the CNAP information. This includes CNAP names such as "WIRELESS
    942      * CALLER" or "UNKNOWN NAME". By default, if there are no filtered names for this carrier, null
    943      * is returned.
    944      * @hide
    945      */
    946     public static final String FILTERED_CNAP_NAMES_STRING_ARRAY = "filtered_cnap_names_string_array";
    947 
    948     /** The default value for every variable. */
    949     private final static PersistableBundle sDefaults;
    950 
    951     static {
    952         sDefaults = new PersistableBundle();
    953         sDefaults.putBoolean(KEY_ALLOW_HOLD_IN_IMS_CALL_BOOL, true);
    954         sDefaults.putBoolean(KEY_ADDITIONAL_CALL_SETTING_BOOL, true);
    955         sDefaults.putBoolean(KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL, false);
    956         sDefaults.putBoolean(KEY_ALLOW_LOCAL_DTMF_TONES_BOOL, true);
    957         sDefaults.putBoolean(KEY_APN_EXPAND_BOOL, true);
    958         sDefaults.putBoolean(KEY_AUTO_RETRY_ENABLED_BOOL, false);
    959         sDefaults.putBoolean(KEY_CARRIER_SETTINGS_ENABLE_BOOL, false);
    960         sDefaults.putBoolean(KEY_CARRIER_VOLTE_AVAILABLE_BOOL, false);
    961         sDefaults.putBoolean(KEY_CARRIER_VT_AVAILABLE_BOOL, false);
    962         sDefaults.putBoolean(KEY_NOTIFY_HANDOVER_VIDEO_FROM_WIFI_TO_LTE_BOOL, false);
    963         sDefaults.putBoolean(KEY_SUPPORT_DOWNGRADE_VT_TO_AUDIO_BOOL, true);
    964         sDefaults.putBoolean(KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL, false);
    965         sDefaults.putBoolean(KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL, false);
    966         sDefaults.putBoolean(KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL, false);
    967         sDefaults.putBoolean(KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL, false);
    968         sDefaults.putBoolean(KEY_CARRIER_PROMOTE_WFC_ON_CALL_FAIL_BOOL, false);
    969         sDefaults.putInt(KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT, 2);
    970         sDefaults.putBoolean(KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL, false);
    971         sDefaults.putBoolean(KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL, false);
    972         sDefaults.putBoolean(KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL, true);
    973         sDefaults.putBoolean(KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL, true);
    974         sDefaults.putBoolean(KEY_CARRIER_IMS_GBA_REQUIRED_BOOL, false);
    975         sDefaults.putBoolean(KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL, false);
    976         sDefaults.putBoolean(KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL, true);
    977         sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING, "");
    978         sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING, "");
    979         sDefaults.putString(KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING, "");
    980         sDefaults.putInt(KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT, 64);
    981         sDefaults.putBoolean(KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL, false);
    982         sDefaults.putBoolean(KEY_DTMF_TYPE_ENABLED_BOOL, false);
    983         sDefaults.putBoolean(KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL, true);
    984         sDefaults.putBoolean(KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL, false);
    985         sDefaults.putBoolean(KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL, false);
    986         sDefaults.putBoolean(KEY_HIDE_SIM_LOCK_SETTINGS_BOOL, false);
    987         sDefaults.putBoolean(KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL, false);
    988         sDefaults.putBoolean(KEY_OPERATOR_SELECTION_EXPAND_BOOL, true);
    989         sDefaults.putBoolean(KEY_PREFER_2G_BOOL, true);
    990         sDefaults.putBoolean(KEY_SHOW_APN_SETTING_CDMA_BOOL, false);
    991         sDefaults.putBoolean(KEY_SHOW_CDMA_CHOICES_BOOL, false);
    992         sDefaults.putBoolean(KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL, true);
    993         sDefaults.putBoolean(KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL, true);
    994         sDefaults.putBoolean(KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL, false);
    995         sDefaults.putBoolean(KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL, true);
    996         sDefaults.putBoolean(KEY_USE_HFA_FOR_PROVISIONING_BOOL, false);
    997         sDefaults.putBoolean(KEY_USE_OTASP_FOR_PROVISIONING_BOOL, false);
    998         sDefaults.putBoolean(KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL, false);
    999         sDefaults.putBoolean(KEY_VOICE_PRIVACY_DISABLE_UI_BOOL, false);
   1000         sDefaults.putBoolean(KEY_WORLD_PHONE_BOOL, false);
   1001         sDefaults.putBoolean(KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL, true);
   1002         sDefaults.putInt(KEY_VOLTE_REPLACEMENT_RAT_INT, 0);
   1003         sDefaults.putString(KEY_DEFAULT_SIM_CALL_MANAGER_STRING, "");
   1004         sDefaults.putString(KEY_VVM_DESTINATION_NUMBER_STRING, "");
   1005         sDefaults.putInt(KEY_VVM_PORT_NUMBER_INT, 0);
   1006         sDefaults.putString(KEY_VVM_TYPE_STRING, "");
   1007         sDefaults.putBoolean(KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL, false);
   1008         sDefaults.putBoolean(KEY_VVM_PREFETCH_BOOL, true);
   1009         sDefaults.putString(KEY_CARRIER_VVM_PACKAGE_NAME_STRING, "");
   1010         sDefaults.putBoolean(KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL, false);
   1011         sDefaults.putBoolean(KEY_CI_ACTION_ON_SYS_UPDATE_BOOL, false);
   1012         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING, "");
   1013         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING, "");
   1014         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING, "");
   1015         sDefaults.putBoolean(KEY_CSP_ENABLED_BOOL, false);
   1016         sDefaults.putBoolean(KEY_ALLOW_ADDING_APNS_BOOL, true);
   1017         sDefaults.putBoolean(KEY_BROADCAST_EMERGENCY_CALL_STATE_CHANGES_BOOL, false);
   1018         sDefaults.putBoolean(KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL, false);
   1019         sDefaults.putBoolean(KEY_DISABLE_SEVERE_WHEN_EXTREME_DISABLED_BOOL, true);
   1020         sDefaults.putString(KEY_CARRIER_DATA_CALL_RETRY_CONFIG_DEFAULT_STRING,
   1021                 "default_randomization=2000,5000,10000,20000,40000,80000:5000,160000:5000,"
   1022                         + "320000:5000,640000:5000,1280000:5000,1800000:5000");
   1023         sDefaults.putString(KEY_CARRIER_DATA_CALL_RETRY_CONFIG_OTHERS_STRING,
   1024                 "max_retries=3, 5000, 5000, 5000");
   1025         sDefaults.putLong(KEY_CARRIER_DATA_CALL_APN_DELAY_DEFAULT_LONG, 20000);
   1026         sDefaults.putLong(KEY_CARRIER_DATA_CALL_APN_DELAY_FASTER_LONG, 3000);
   1027         sDefaults.putString(KEY_CARRIER_ERI_FILE_NAME_STRING, "eri.xml");
   1028         sDefaults.putInt(KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT, 7200);
   1029         sDefaults.putStringArray(KEY_CARRIER_METERED_APN_TYPES_STRINGS,
   1030                 new String[]{"default", "mms", "dun", "supl"});
   1031         sDefaults.putStringArray(KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS,
   1032                 new String[]{"default", "mms", "dun", "supl"});
   1033 
   1034         sDefaults.putStringArray(KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY, null);
   1035         sDefaults.putStringArray(KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY, null);
   1036         sDefaults.putStringArray(KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY, null);
   1037         sDefaults.putStringArray(KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY, null);
   1038         sDefaults.putBoolean(KEY_FORCE_HOME_NETWORK_BOOL, false);
   1039         sDefaults.putInt(KEY_GSM_DTMF_TONE_DELAY_INT, 0);
   1040         sDefaults.putInt(KEY_IMS_DTMF_TONE_DELAY_INT, 0);
   1041         sDefaults.putInt(KEY_CDMA_DTMF_TONE_DELAY_INT, 100);
   1042         sDefaults.putBoolean(KEY_SUPPORT_CONFERENCE_CALL_BOOL, true);
   1043         sDefaults.putBoolean(KEY_SUPPORT_VIDEO_CONFERENCE_CALL_BOOL, false);
   1044         sDefaults.putBoolean(KEY_EDITABLE_ENHANCED_4G_LTE_BOOL, true);
   1045         sDefaults.putBoolean(KEY_HIDE_IMS_APN_BOOL, false);
   1046         sDefaults.putBoolean(KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL, false);
   1047         sDefaults.putBoolean(KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL, false);
   1048         sDefaults.putBoolean(KEY_EDITABLE_WFC_MODE_BOOL, true);
   1049         sDefaults.putStringArray(KEY_WFC_OPERATOR_ERROR_CODES_STRING_ARRAY, null);
   1050         sDefaults.putInt(KEY_WFC_SPN_FORMAT_IDX_INT, 0);
   1051         sDefaults.putInt(KEY_WFC_DATA_SPN_FORMAT_IDX_INT, 0);
   1052         sDefaults.putString(KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING, "");
   1053         sDefaults.putBoolean(KEY_CONFIG_WIFI_DISABLE_IN_ECBM, false);
   1054         sDefaults.putBoolean(KEY_CARRIER_NAME_OVERRIDE_BOOL, false);
   1055         sDefaults.putString(KEY_CARRIER_NAME_STRING, "");
   1056 
   1057         // MMS defaults
   1058         sDefaults.putBoolean(KEY_MMS_ALIAS_ENABLED_BOOL, false);
   1059         sDefaults.putBoolean(KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL, true);
   1060         sDefaults.putBoolean(KEY_MMS_APPEND_TRANSACTION_ID_BOOL, false);
   1061         sDefaults.putBoolean(KEY_MMS_GROUP_MMS_ENABLED_BOOL, true);
   1062         sDefaults.putBoolean(KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL, false);
   1063         sDefaults.putBoolean(KEY_MMS_MMS_ENABLED_BOOL, true);
   1064         sDefaults.putBoolean(KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL, false);
   1065         sDefaults.putBoolean(KEY_MMS_MULTIPART_SMS_ENABLED_BOOL, true);
   1066         sDefaults.putBoolean(KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL, false);
   1067         sDefaults.putBoolean(KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL, false);
   1068         sDefaults.putBoolean(KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL, true);
   1069         sDefaults.putBoolean(KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL, true);
   1070         sDefaults.putBoolean(KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL, false);
   1071         sDefaults.putBoolean(KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL, true);
   1072         sDefaults.putBoolean(KEY_MMS_CLOSE_CONNECTION_BOOL, false);
   1073         sDefaults.putInt(KEY_MMS_ALIAS_MAX_CHARS_INT, 48);
   1074         sDefaults.putInt(KEY_MMS_ALIAS_MIN_CHARS_INT, 2);
   1075         sDefaults.putInt(KEY_MMS_HTTP_SOCKET_TIMEOUT_INT, 60 * 1000);
   1076         sDefaults.putInt(KEY_MMS_MAX_IMAGE_HEIGHT_INT, 480);
   1077         sDefaults.putInt(KEY_MMS_MAX_IMAGE_WIDTH_INT, 640);
   1078         sDefaults.putInt(KEY_MMS_MAX_MESSAGE_SIZE_INT, 300 * 1024);
   1079         sDefaults.putInt(KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT, -1);
   1080         sDefaults.putInt(KEY_MMS_RECIPIENT_LIMIT_INT, Integer.MAX_VALUE);
   1081         sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT, -1);
   1082         sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT, -1);
   1083         sDefaults.putInt(KEY_MMS_SUBJECT_MAX_LENGTH_INT, 40);
   1084         sDefaults.putString(KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING, "");
   1085         sDefaults.putString(KEY_MMS_HTTP_PARAMS_STRING, "");
   1086         sDefaults.putString(KEY_MMS_NAI_SUFFIX_STRING, "");
   1087         sDefaults.putString(KEY_MMS_UA_PROF_TAG_NAME_STRING, "x-wap-profile");
   1088         sDefaults.putString(KEY_MMS_UA_PROF_URL_STRING, "");
   1089         sDefaults.putString(KEY_MMS_USER_AGENT_STRING, "");
   1090         sDefaults.putBoolean(KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL, true);
   1091         sDefaults.putBoolean(KEY_USE_RCS_PRESENCE_BOOL, false);
   1092         sDefaults.putBoolean(KEY_FORCE_IMEI_BOOL, false);
   1093         sDefaults.putInt(KEY_CDMA_ROAMING_MODE_INT, CDMA_ROAMING_MODE_RADIO_DEFAULT);
   1094 
   1095         // Carrier Signalling Receivers
   1096         sDefaults.putStringArray(KEY_SIGNAL_REDIRECTION_RECEIVER_STRING_ARRAY, null);
   1097         sDefaults.putStringArray(KEY_SIGNAL_DCFAILURE_RECEIVER_STRING_ARRAY, null);
   1098         sDefaults.putStringArray(KEY_SIGNAL_PCO_RECEIVER_STRING_ARRAY, null);
   1099         sDefaults.putString(KEY_CARRIER_SETUP_APP_STRING, "");
   1100 
   1101         // Rat families: {GPRS, EDGE}, {EVDO, EVDO_A, EVDO_B}, {UMTS, HSPA, HSDPA, HSUPA, HSPAP},
   1102         // {LTE, LTE_CA}
   1103         // Order is important - lowest precidence first
   1104         sDefaults.putStringArray(KEY_RATCHET_RAT_FAMILIES,
   1105                 new String[]{"1,2","7,8,12","3,11,9,10,15","14,19"});
   1106         sDefaults.putBoolean(KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL, false);
   1107         sDefaults.putBoolean(KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL, false);
   1108         sDefaults.putBoolean(KEY_ALLOW_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL, true);
   1109         sDefaults.putBoolean(KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL, true);
   1110         sDefaults.putBoolean(KEY_WIFI_CALLS_CAN_BE_HD_AUDIO, true);
   1111         sDefaults.putBoolean(KEY_VIDEO_CALLS_CAN_BE_HD_AUDIO, true);
   1112 
   1113         sDefaults.putStringArray(KEY_IMS_REASONINFO_MAPPING_STRING_ARRAY, null);
   1114         sDefaults.putBoolean(KEY_ENHANCED_4G_LTE_TITLE_VARIANT_BOOL, false);
   1115         sDefaults.putBoolean(KEY_NOTIFY_VT_HANDOVER_TO_WIFI_FAILURE_BOOL, false);
   1116         sDefaults.putStringArray(FILTERED_CNAP_NAMES_STRING_ARRAY, null);
   1117     }
   1118 
   1119     /**
   1120      * Gets the configuration values for a particular subscription, which is associated with a
   1121      * specific SIM card. If an invalid subId is used, the returned config will contain default
   1122      * values.
   1123      *
   1124      * <p>Requires Permission:
   1125      * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
   1126      *
   1127      * @param subId the subscription ID, normally obtained from {@link SubscriptionManager}.
   1128      * @return A {@link PersistableBundle} containing the config for the given subId, or default
   1129      *         values for an invalid subId.
   1130      */
   1131     @Nullable
   1132     public PersistableBundle getConfigForSubId(int subId) {
   1133         try {
   1134             ICarrierConfigLoader loader = getICarrierConfigLoader();
   1135             if (loader == null) {
   1136                 Rlog.w(TAG, "Error getting config for subId " + subId
   1137                         + " ICarrierConfigLoader is null");
   1138                 return null;
   1139             }
   1140             return loader.getConfigForSubId(subId);
   1141         } catch (RemoteException ex) {
   1142             Rlog.e(TAG, "Error getting config for subId " + subId + ": "
   1143                     + ex.toString());
   1144         }
   1145         return null;
   1146     }
   1147 
   1148     /**
   1149      * Gets the configuration values for the default subscription.
   1150      *
   1151      * <p>Requires Permission:
   1152      * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
   1153      *
   1154      * @see #getConfigForSubId
   1155      */
   1156     @Nullable
   1157     public PersistableBundle getConfig() {
   1158         return getConfigForSubId(SubscriptionManager.getDefaultSubscriptionId());
   1159     }
   1160 
   1161     /**
   1162      * Calling this method triggers telephony services to fetch the current carrier configuration.
   1163      * <p>
   1164      * Normally this does not need to be called because the platform reloads config on its own.
   1165      * This should be called by a carrier service app if it wants to update config at an arbitrary
   1166      * moment.
   1167      * </p>
   1168      * <p>Requires that the calling app has carrier privileges.
   1169      * @see #hasCarrierPrivileges
   1170      * <p>
   1171      * This method returns before the reload has completed, and
   1172      * {@link android.service.carrier.CarrierService#onLoadConfig} will be called from an
   1173      * arbitrary thread.
   1174      * </p>
   1175      */
   1176     public void notifyConfigChangedForSubId(int subId) {
   1177         try {
   1178             ICarrierConfigLoader loader = getICarrierConfigLoader();
   1179             if (loader == null) {
   1180                 Rlog.w(TAG, "Error reloading config for subId=" + subId
   1181                         + " ICarrierConfigLoader is null");
   1182                 return;
   1183             }
   1184             loader.notifyConfigChangedForSubId(subId);
   1185         } catch (RemoteException ex) {
   1186             Rlog.e(TAG, "Error reloading config for subId=" + subId + ": " + ex.toString());
   1187         }
   1188     }
   1189 
   1190     /**
   1191      * Request the carrier config loader to update the cofig for phoneId.
   1192      * <p>
   1193      * Depending on simState, the config may be cleared or loaded from config app. This is only used
   1194      * by SubscriptionInfoUpdater.
   1195      * </p>
   1196      *
   1197      * @hide
   1198      */
   1199     @SystemApi
   1200     public void updateConfigForPhoneId(int phoneId, String simState) {
   1201         try {
   1202             ICarrierConfigLoader loader = getICarrierConfigLoader();
   1203             if (loader == null) {
   1204                 Rlog.w(TAG, "Error updating config for phoneId=" + phoneId
   1205                         + " ICarrierConfigLoader is null");
   1206                 return;
   1207             }
   1208             loader.updateConfigForPhoneId(phoneId, simState);
   1209         } catch (RemoteException ex) {
   1210             Rlog.e(TAG, "Error updating config for phoneId=" + phoneId + ": " + ex.toString());
   1211         }
   1212     }
   1213 
   1214     /**
   1215      * Returns a new bundle with the default value for every supported configuration variable.
   1216      *
   1217      * @hide
   1218      */
   1219     @NonNull
   1220     @SystemApi
   1221     public static PersistableBundle getDefaultConfig() {
   1222         return new PersistableBundle(sDefaults);
   1223     }
   1224 
   1225     /** @hide */
   1226     @Nullable
   1227     private ICarrierConfigLoader getICarrierConfigLoader() {
   1228         return ICarrierConfigLoader.Stub
   1229                 .asInterface(ServiceManager.getService(Context.CARRIER_CONFIG_SERVICE));
   1230     }
   1231 }
   1232