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 com.android.internal.telephony.ICarrierConfigLoader;
     20 
     21 import android.annotation.NonNull;
     22 import android.annotation.Nullable;
     23 import android.annotation.SystemApi;
     24 import android.content.Context;
     25 import android.os.PersistableBundle;
     26 import android.os.RemoteException;
     27 import android.os.ServiceManager;
     28 
     29 /**
     30  * Provides access to telephony configuration values that are carrier-specific.
     31  * <p>
     32  * Users should obtain an instance of this class by calling
     33  * {@code mContext.getSystemService(Context.CARRIER_CONFIG_SERVICE);}
     34  * </p>
     35  *
     36  * @see Context#getSystemService
     37  * @see Context#CARRIER_CONFIG_SERVICE
     38  */
     39 public class CarrierConfigManager {
     40     private final static String TAG = "CarrierConfigManager";
     41 
     42     /**
     43      * @hide
     44      */
     45     public CarrierConfigManager() {
     46     }
     47 
     48     /**
     49      * This intent is broadcast by the system when carrier config changes.
     50      */
     51     public static final String
     52             ACTION_CARRIER_CONFIG_CHANGED = "android.telephony.action.CARRIER_CONFIG_CHANGED";
     53 
     54     // Below are the keys used in carrier config bundles. To add a new variable, define the key and
     55     // give it a default value in sDefaults. If you need to ship a per-network override in the
     56     // system image, that can be added in packages/apps/CarrierConfig.
     57 
     58     /**
     59      * Flag indicating whether the Phone app should ignore EVENT_SIM_NETWORK_LOCKED
     60      * events from the Sim.
     61      * If true, this will prevent the IccNetworkDepersonalizationPanel from being shown, and
     62      * effectively disable the "Sim network lock" feature.
     63      */
     64     public static final String
     65             KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL = "ignore_sim_network_locked_events_bool";
     66 
     67     /**
     68      * Flag indicating whether the Phone app should provide a "Dismiss" button on the SIM network
     69      * unlock screen. The default value is true. If set to false, there will be *no way* to dismiss
     70      * the SIM network unlock screen if you don't enter the correct unlock code. (One important
     71      * consequence: there will be no way to make an Emergency Call if your SIM is network-locked and
     72      * you don't know the PIN.)
     73      */
     74     public static final String
     75             KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL = "sim_network_unlock_allow_dismiss_bool";
     76 
     77     /** Flag indicating if the phone is a world phone */
     78     public static final String KEY_WORLD_PHONE_BOOL = "world_phone_bool";
     79 
     80     /**
     81      * If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity.
     82      * The pattern is set on a per-platform basis using config_virtualKeyVibePattern. To be
     83      * consistent with the regular Dialer, this value should agree with the corresponding values
     84      * from config.xml under apps/Contacts.
     85      */
     86     public static final String
     87             KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL = "enable_dialer_key_vibration_bool";
     88 
     89     /** Flag indicating if dtmf tone type is enabled */
     90     public static final String KEY_DTMF_TYPE_ENABLED_BOOL = "dtmf_type_enabled_bool";
     91 
     92     /** Flag indicating if auto retry is enabled */
     93     public static final String KEY_AUTO_RETRY_ENABLED_BOOL = "auto_retry_enabled_bool";
     94 
     95     /**
     96      * Determine whether we want to play local DTMF tones in a call, or just let the radio/BP handle
     97      * playing of the tones.
     98      */
     99     public static final String KEY_ALLOW_LOCAL_DTMF_TONES_BOOL = "allow_local_dtmf_tones_bool";
    100 
    101     /**
    102      * If true, show an onscreen "Dial" button in the dialer. In practice this is used on all
    103      * platforms, even the ones with hard SEND/END keys, but for maximum flexibility it's controlled
    104      * by a flag here (which can be overridden on a per-product basis.)
    105      */
    106     public static final String KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL = "show_onscreen_dial_button_bool";
    107 
    108     /** Determines if device implements a noise suppression device for in call audio. */
    109     public static final String
    110             KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL = "has_in_call_noise_suppression_bool";
    111 
    112     /**
    113      * Determines if the current device should allow emergency numbers to be logged in the Call Log.
    114      * (Some carriers require that emergency calls *not* be logged, presumably to avoid the risk of
    115      * accidental redialing from the call log UI. This is a good idea, so the default here is
    116      * false.)
    117      */
    118     public static final String
    119             KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL = "allow_emergency_numbers_in_call_log_bool";
    120 
    121     /** If true, removes the Voice Privacy option from Call Settings */
    122     public static final String KEY_VOICE_PRIVACY_DISABLE_UI_BOOL = "voice_privacy_disable_ui_bool";
    123 
    124     /** Control whether users can reach the carrier portions of Cellular Network Settings. */
    125     public static final String
    126             KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL = "hide_carrier_network_settings_bool";
    127 
    128     /** Control whether users can reach the SIM lock settings. */
    129     public static final String
    130             KEY_HIDE_SIM_LOCK_SETTINGS_BOOL = "hide_sim_lock_settings_bool";
    131 
    132     /** Control whether users can edit APNs in Settings. */
    133     public static final String KEY_APN_EXPAND_BOOL = "apn_expand_bool";
    134 
    135     /** Control whether users can choose a network operator. */
    136     public static final String KEY_OPERATOR_SELECTION_EXPAND_BOOL = "operator_selection_expand_bool";
    137 
    138     /** Used in Cellular Network Settings for preferred network type. */
    139     public static final String KEY_PREFER_2G_BOOL = "prefer_2g_bool";
    140 
    141     /** Show cdma network mode choices 1x, 3G, global etc. */
    142     public static final String KEY_SHOW_CDMA_CHOICES_BOOL = "show_cdma_choices_bool";
    143 
    144     /** CDMA activation goes through HFA */
    145     public static final String KEY_USE_HFA_FOR_PROVISIONING_BOOL = "use_hfa_for_provisioning_bool";
    146 
    147     /**
    148      * CDMA activation goes through OTASP.
    149      * <p>
    150      * TODO: This should be combined with config_use_hfa_for_provisioning and implemented as an enum
    151      * (NONE, HFA, OTASP).
    152      */
    153     public static final String KEY_USE_OTASP_FOR_PROVISIONING_BOOL = "use_otasp_for_provisioning_bool";
    154 
    155     /** Display carrier settings menu if true */
    156     public static final String KEY_CARRIER_SETTINGS_ENABLE_BOOL = "carrier_settings_enable_bool";
    157 
    158     /** Does not display additional call seting for IMS phone based on GSM Phone */
    159     public static final String KEY_ADDITIONAL_CALL_SETTING_BOOL = "additional_call_setting_bool";
    160 
    161     /** Show APN Settings for some CDMA carriers */
    162     public static final String KEY_SHOW_APN_SETTING_CDMA_BOOL = "show_apn_setting_cdma_bool";
    163 
    164     /** After a CDMA conference call is merged, the swap button should be displayed. */
    165     public static final String KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL = "support_swap_after_merge_bool";
    166 
    167     /**
    168      * Determine whether the voicemail notification is persistent in the notification bar. If true,
    169      * the voicemail notifications cannot be dismissed from the notification bar.
    170      */
    171     public static final String
    172             KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL = "voicemail_notification_persistent_bool";
    173 
    174     /** For IMS video over LTE calls, determines whether video pause signalling is supported. */
    175     public static final String
    176             KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL = "support_pause_ims_video_calls_bool";
    177 
    178     /**
    179      * Disables dialing "*228" (OTASP provisioning) on CDMA carriers where it is not supported or is
    180      * potentially harmful by locking the SIM to 3G.
    181      */
    182     public static final String
    183             KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL = "disable_cdma_activation_code_bool";
    184 
    185    /**
    186      * Override the platform's notion of a network operator being considered roaming.
    187      * Value is string array of MCCMNCs to be considered roaming for 3GPP RATs.
    188      */
    189     public static final String
    190             KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY = "gsm_roaming_networks_string_array";
    191 
    192     /**
    193      * Override the platform's notion of a network operator being considered not roaming.
    194      * Value is string array of MCCMNCs to be considered not roaming for 3GPP RATs.
    195      */
    196     public static final String
    197             KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY = "gsm_nonroaming_networks_string_array";
    198 
    199     /**
    200      * Override the platform's notion of a network operator being considered roaming.
    201      * Value is string array of SIDs to be considered roaming for 3GPP2 RATs.
    202      */
    203     public static final String
    204             KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY = "cdma_roaming_networks_string_array";
    205 
    206     /**
    207      * Override the platform's notion of a network operator being considered non roaming.
    208      * Value is string array of SIDs to be considered not roaming for 3GPP2 RATs.
    209      */
    210     public static final String
    211             KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY = "cdma_nonroaming_networks_string_array";
    212 
    213     /**
    214      * Override the platform's notion of a network operator being considered non roaming.
    215      * If true all networks are considered as home network a.k.a non-roaming.  When false,
    216      * the 2 pairs of CMDA and GSM roaming/non-roaming arrays are consulted.
    217      *
    218      * @see KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY
    219      * @see KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY
    220      * @see KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
    221      * @see KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY
    222      */
    223     public static final String
    224             KEY_FORCE_HOME_NETWORK_BOOL = "force_home_network_bool";
    225 
    226     /**
    227      * Flag specifying whether VoLTE should be available for carrier, independent of carrier
    228      * provisioning. If false: hard disabled. If true: then depends on carrier provisioning,
    229      * availability, etc.
    230      */
    231     public static final String KEY_CARRIER_VOLTE_AVAILABLE_BOOL = "carrier_volte_available_bool";
    232 
    233     /**
    234      * Flag specifying whether video telephony is available for carrier. If false: hard disabled.
    235      * If true: then depends on carrier provisioning, availability, etc.
    236      */
    237     public static final String KEY_CARRIER_VT_AVAILABLE_BOOL = "carrier_vt_available_bool";
    238 
    239     /**
    240      * Flag specifying whether WFC over IMS should be available for carrier: independent of
    241      * carrier provisioning. If false: hard disabled. If true: then depends on carrier
    242      * provisioning, availability etc.
    243      */
    244     public static final String KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL = "carrier_wfc_ims_available_bool";
    245 
    246     /** Flag specifying whether provisioning is required for VOLTE. */
    247     public static final String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
    248             = "carrier_volte_provisioning_required_bool";
    249 
    250     /** Flag specifying whether VoLTE TTY is supported. */
    251     public static final String KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
    252             = "carrier_volte_tty_supported_bool";
    253 
    254     /**
    255      * Flag specifying whether IMS service can be turned off. If false then the service will not be
    256      * turned-off completely, but individual features can be disabled.
    257      */
    258     public static final String KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL
    259             = "carrier_allow_turnoff_ims_bool";
    260 
    261     /**
    262      * If Voice Radio Technology is RIL_RADIO_TECHNOLOGY_LTE:14 or RIL_RADIO_TECHNOLOGY_UNKNOWN:0
    263      * this is the value that should be used instead. A configuration value of
    264      * RIL_RADIO_TECHNOLOGY_UNKNOWN:0 means there is no replacement value and that the default
    265      * assumption for phone type (GSM) should be used.
    266      */
    267     public static final String KEY_VOLTE_REPLACEMENT_RAT_INT = "volte_replacement_rat_int";
    268 
    269     /**
    270      * The default sim call manager to use when the default dialer doesn't implement one. A sim call
    271      * manager can control and route outgoing and incoming phone calls, even if they're placed
    272      * using another connection service (PSTN, for example).
    273      */
    274     public static final String KEY_DEFAULT_SIM_CALL_MANAGER_STRING = "default_sim_call_manager_string";
    275 
    276     /**
    277      * The default flag specifying whether ETWS/CMAS test setting is forcibly disabled in
    278      * Settings->More->Emergency broadcasts menu even though developer options is turned on.
    279      * @hide
    280      */
    281     public static final String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL =
    282             "carrier_force_disable_etws_cmas_test_bool";
    283 
    284     /* The following 3 fields are related to carrier visual voicemail. */
    285 
    286     /**
    287      * The carrier number mobile outgoing (MO) sms messages are sent to.
    288      */
    289     public static final String KEY_VVM_DESTINATION_NUMBER_STRING = "vvm_destination_number_string";
    290 
    291     /**
    292      * The port through which the mobile outgoing (MO) sms messages are sent through.
    293      */
    294     public static final String KEY_VVM_PORT_NUMBER_INT = "vvm_port_number_int";
    295 
    296     /**
    297      * The type of visual voicemail protocol the carrier adheres to. See {@link TelephonyManager}
    298      * for possible values. For example {@link TelephonyManager#VVM_TYPE_OMTP}.
    299      */
    300     public static final String KEY_VVM_TYPE_STRING = "vvm_type_string";
    301 
    302     /**
    303      * The package name of the carrier's visual voicemail app to ensure that dialer visual voicemail
    304      * and carrier visual voicemail are not active at the same time.
    305      */
    306     public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING = "carrier_vvm_package_name_string";
    307 
    308     /**
    309      * Flag specifying whether an additional (client initiated) intent needs to be sent on System
    310      * update
    311      * @hide
    312      */
    313     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_BOOL = "ci_action_on_sys_update_bool";
    314 
    315     /**
    316      * Intent to be sent for the additional action on System update
    317      * @hide
    318      */
    319     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING =
    320             "ci_action_on_sys_update_intent_string";
    321 
    322     /**
    323      * Extra to be included in the intent sent for additional action on System update
    324      * @hide
    325      */
    326     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING =
    327             "ci_action_on_sys_update_extra_string";
    328 
    329     /**
    330      * Value of extra included in intent sent for additional action on System update
    331      * @hide
    332      */
    333     public static final String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING =
    334             "ci_action_on_sys_update_extra_val_string";
    335 
    336     /**
    337      * If this is true, the SIM card (through Customer Service Profile EF file) will be able to
    338      * prevent manual operator selection. If false, this SIM setting will be ignored and manual
    339      * operator selection will always be available. See CPHS4_2.WW6, CPHS B.4.7.1 for more
    340      * information
    341      */
    342     public static final String KEY_CSP_ENABLED_BOOL = "csp_enabled_bool";
    343 
    344     // These variables are used by the MMS service and exposed through another API, {@link
    345     // SmsManager}. The variable names and string values are copied from there.
    346     public static final String KEY_MMS_ALIAS_ENABLED_BOOL = "aliasEnabled";
    347     public static final String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL = "allowAttachAudio";
    348     public static final String KEY_MMS_APPEND_TRANSACTION_ID_BOOL = "enabledTransID";
    349     public static final String KEY_MMS_GROUP_MMS_ENABLED_BOOL = "enableGroupMms";
    350     public static final String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL = "enableMMSDeliveryReports";
    351     public static final String KEY_MMS_MMS_ENABLED_BOOL = "enabledMMS";
    352     public static final String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL = "enableMMSReadReports";
    353     public static final String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL = "enableMultipartSMS";
    354     public static final String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL = "enabledNotifyWapMMSC";
    355     public static final String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL = "sendMultipartSmsAsSeparateMessages";
    356     public static final String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL = "config_cellBroadcastAppLinks";
    357     public static final String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL = "enableSMSDeliveryReports";
    358     public static final String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL = "supportHttpCharsetHeader";
    359     public static final String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL = "supportMmsContentDisposition";
    360     public static final String KEY_MMS_ALIAS_MAX_CHARS_INT = "aliasMaxChars";
    361     public static final String KEY_MMS_ALIAS_MIN_CHARS_INT = "aliasMinChars";
    362     public static final String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT = "httpSocketTimeout";
    363     public static final String KEY_MMS_MAX_IMAGE_HEIGHT_INT = "maxImageHeight";
    364     public static final String KEY_MMS_MAX_IMAGE_WIDTH_INT = "maxImageWidth";
    365     public static final String KEY_MMS_MAX_MESSAGE_SIZE_INT = "maxMessageSize";
    366     public static final String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT = "maxMessageTextSize";
    367     public static final String KEY_MMS_RECIPIENT_LIMIT_INT = "recipientLimit";
    368     public static final String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT = "smsToMmsTextLengthThreshold";
    369     public static final String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT = "smsToMmsTextThreshold";
    370     public static final String KEY_MMS_SUBJECT_MAX_LENGTH_INT = "maxSubjectLength";
    371     public static final String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING = "emailGatewayNumber";
    372     public static final String KEY_MMS_HTTP_PARAMS_STRING = "httpParams";
    373     public static final String KEY_MMS_NAI_SUFFIX_STRING = "naiSuffix";
    374     public static final String KEY_MMS_UA_PROF_TAG_NAME_STRING = "uaProfTagName";
    375     public static final String KEY_MMS_UA_PROF_URL_STRING = "uaProfUrl";
    376     public static final String KEY_MMS_USER_AGENT_STRING = "userAgent";
    377 
    378     /** The default value for every variable. */
    379     private final static PersistableBundle sDefaults;
    380 
    381     static {
    382         sDefaults = new PersistableBundle();
    383         sDefaults.putBoolean(KEY_ADDITIONAL_CALL_SETTING_BOOL, true);
    384         sDefaults.putBoolean(KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL, false);
    385         sDefaults.putBoolean(KEY_ALLOW_LOCAL_DTMF_TONES_BOOL, true);
    386         sDefaults.putBoolean(KEY_APN_EXPAND_BOOL, true);
    387         sDefaults.putBoolean(KEY_AUTO_RETRY_ENABLED_BOOL, false);
    388         sDefaults.putBoolean(KEY_CARRIER_SETTINGS_ENABLE_BOOL, false);
    389         sDefaults.putBoolean(KEY_CARRIER_VOLTE_AVAILABLE_BOOL, false);
    390         sDefaults.putBoolean(KEY_CARRIER_VT_AVAILABLE_BOOL, false);
    391         sDefaults.putBoolean(KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL, false);
    392         sDefaults.putBoolean(KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL, false);
    393         sDefaults.putBoolean(KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL, false);
    394         sDefaults.putBoolean(KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL, true);
    395         sDefaults.putBoolean(KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL, true);
    396         sDefaults.putBoolean(KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL, false);
    397         sDefaults.putBoolean(KEY_DTMF_TYPE_ENABLED_BOOL, false);
    398         sDefaults.putBoolean(KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL, true);
    399         sDefaults.putBoolean(KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL, false);
    400         sDefaults.putBoolean(KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL, false);
    401         sDefaults.putBoolean(KEY_HIDE_SIM_LOCK_SETTINGS_BOOL, false);
    402         sDefaults.putBoolean(KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL, false);
    403         sDefaults.putBoolean(KEY_OPERATOR_SELECTION_EXPAND_BOOL, true);
    404         sDefaults.putBoolean(KEY_PREFER_2G_BOOL, true);
    405         sDefaults.putBoolean(KEY_SHOW_APN_SETTING_CDMA_BOOL, false);
    406         sDefaults.putBoolean(KEY_SHOW_CDMA_CHOICES_BOOL, false);
    407         sDefaults.putBoolean(KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL, true);
    408         sDefaults.putBoolean(KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL, true);
    409         sDefaults.putBoolean(KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL, true);
    410         sDefaults.putBoolean(KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL, true);
    411         sDefaults.putBoolean(KEY_USE_HFA_FOR_PROVISIONING_BOOL, false);
    412         sDefaults.putBoolean(KEY_USE_OTASP_FOR_PROVISIONING_BOOL, false);
    413         sDefaults.putBoolean(KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL, false);
    414         sDefaults.putBoolean(KEY_VOICE_PRIVACY_DISABLE_UI_BOOL, false);
    415         sDefaults.putBoolean(KEY_WORLD_PHONE_BOOL, false);
    416         sDefaults.putInt(KEY_VOLTE_REPLACEMENT_RAT_INT, 0);
    417         sDefaults.putString(KEY_DEFAULT_SIM_CALL_MANAGER_STRING, "");
    418         sDefaults.putString(KEY_VVM_DESTINATION_NUMBER_STRING, "");
    419         sDefaults.putInt(KEY_VVM_PORT_NUMBER_INT, 0);
    420         sDefaults.putString(KEY_VVM_TYPE_STRING, "");
    421         sDefaults.putString(KEY_CARRIER_VVM_PACKAGE_NAME_STRING, "");
    422         sDefaults.putBoolean(KEY_CI_ACTION_ON_SYS_UPDATE_BOOL, false);
    423         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING, "");
    424         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING, "");
    425         sDefaults.putString(KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING, "");
    426         sDefaults.putBoolean(KEY_CSP_ENABLED_BOOL, false);
    427 
    428         sDefaults.putStringArray(KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY, null);
    429         sDefaults.putStringArray(KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY, null);
    430         sDefaults.putStringArray(KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY, null);
    431         sDefaults.putStringArray(KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY, null);
    432         sDefaults.putBoolean(KEY_FORCE_HOME_NETWORK_BOOL, false);
    433 
    434         // MMS defaults
    435         sDefaults.putBoolean(KEY_MMS_ALIAS_ENABLED_BOOL, false);
    436         sDefaults.putBoolean(KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL, true);
    437         sDefaults.putBoolean(KEY_MMS_APPEND_TRANSACTION_ID_BOOL, false);
    438         sDefaults.putBoolean(KEY_MMS_GROUP_MMS_ENABLED_BOOL, true);
    439         sDefaults.putBoolean(KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL, false);
    440         sDefaults.putBoolean(KEY_MMS_MMS_ENABLED_BOOL, true);
    441         sDefaults.putBoolean(KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL, false);
    442         sDefaults.putBoolean(KEY_MMS_MULTIPART_SMS_ENABLED_BOOL, true);
    443         sDefaults.putBoolean(KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL, false);
    444         sDefaults.putBoolean(KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL, false);
    445         sDefaults.putBoolean(KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL, true);
    446         sDefaults.putBoolean(KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL, true);
    447         sDefaults.putBoolean(KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL, false);
    448         sDefaults.putBoolean(KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL, true);
    449         sDefaults.putInt(KEY_MMS_ALIAS_MAX_CHARS_INT, 48);
    450         sDefaults.putInt(KEY_MMS_ALIAS_MIN_CHARS_INT, 2);
    451         sDefaults.putInt(KEY_MMS_HTTP_SOCKET_TIMEOUT_INT, 60 * 1000);
    452         sDefaults.putInt(KEY_MMS_MAX_IMAGE_HEIGHT_INT, 480);
    453         sDefaults.putInt(KEY_MMS_MAX_IMAGE_WIDTH_INT, 640);
    454         sDefaults.putInt(KEY_MMS_MAX_MESSAGE_SIZE_INT, 300 * 1024);
    455         sDefaults.putInt(KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT, -1);
    456         sDefaults.putInt(KEY_MMS_RECIPIENT_LIMIT_INT, Integer.MAX_VALUE);
    457         sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT, -1);
    458         sDefaults.putInt(KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT, -1);
    459         sDefaults.putInt(KEY_MMS_SUBJECT_MAX_LENGTH_INT, 40);
    460         sDefaults.putString(KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING, "");
    461         sDefaults.putString(KEY_MMS_HTTP_PARAMS_STRING, "");
    462         sDefaults.putString(KEY_MMS_NAI_SUFFIX_STRING, "");
    463         sDefaults.putString(KEY_MMS_UA_PROF_TAG_NAME_STRING, "x-wap-profile");
    464         sDefaults.putString(KEY_MMS_UA_PROF_URL_STRING, "");
    465         sDefaults.putString(KEY_MMS_USER_AGENT_STRING, "");
    466     }
    467 
    468     /**
    469      * Gets the configuration values for a particular subscription, which is associated with a
    470      * specific SIM card. If an invalid subId is used, the returned config will contain default
    471      * values.
    472      *
    473      * <p>Requires Permission:
    474      * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
    475      *
    476      * @param subId the subscription ID, normally obtained from {@link SubscriptionManager}.
    477      * @return A {@link PersistableBundle} containing the config for the given subId, or default
    478      *         values for an invalid subId.
    479      */
    480     @Nullable
    481     public PersistableBundle getConfigForSubId(int subId) {
    482         try {
    483             return getICarrierConfigLoader().getConfigForSubId(subId);
    484         } catch (RemoteException ex) {
    485             Rlog.e(TAG, "Error getting config for subId " + Integer.toString(subId) + ": "
    486                     + ex.toString());
    487         } catch (NullPointerException ex) {
    488             Rlog.e(TAG, "Error getting config for subId " + Integer.toString(subId) + ": "
    489                     + ex.toString());
    490         }
    491         return null;
    492     }
    493 
    494     /**
    495      * Gets the configuration values for the default subscription.
    496      *
    497      * <p>Requires Permission:
    498      * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
    499      *
    500      * @see #getConfigForSubId
    501      */
    502     @Nullable
    503     public PersistableBundle getConfig() {
    504         return getConfigForSubId(SubscriptionManager.getDefaultSubId());
    505     }
    506 
    507     /**
    508      * Calling this method triggers telephony services to fetch the current carrier configuration.
    509      * <p>
    510      * Normally this does not need to be called because the platform reloads config on its own.
    511      * This should be called by a carrier service app if it wants to update config at an arbitrary
    512      * moment.
    513      * </p>
    514      * <p>Requires that the calling app has carrier privileges.
    515      * @see #hasCarrierPrivileges
    516      * <p>
    517      * This method returns before the reload has completed, and
    518      * {@link android.service.carrier.CarrierService#onLoadConfig} will be called from an
    519      * arbitrary thread.
    520      * </p>
    521      */
    522     public void notifyConfigChangedForSubId(int subId) {
    523         try {
    524             getICarrierConfigLoader().notifyConfigChangedForSubId(subId);
    525         } catch (RemoteException ex) {
    526             Rlog.e(TAG, "Error reloading config for subId=" + subId + ": " + ex.toString());
    527         } catch (NullPointerException ex) {
    528             Rlog.e(TAG, "Error reloading config for subId=" + subId + ": " + ex.toString());
    529         }
    530     }
    531 
    532     /**
    533      * Request the carrier config loader to update the cofig for phoneId.
    534      * <p>
    535      * Depending on simState, the config may be cleared or loaded from config app. This is only used
    536      * by SubscriptionInfoUpdater.
    537      * </p>
    538      *
    539      * @hide
    540      */
    541     @SystemApi
    542     public void updateConfigForPhoneId(int phoneId, String simState) {
    543         try {
    544             getICarrierConfigLoader().updateConfigForPhoneId(phoneId, simState);
    545         } catch (RemoteException ex) {
    546             Rlog.e(TAG, "Error updating config for phoneId=" + phoneId + ": " + ex.toString());
    547         } catch (NullPointerException ex) {
    548             Rlog.e(TAG, "Error updating config for phoneId=" + phoneId + ": " + ex.toString());
    549         }
    550     }
    551 
    552     /**
    553      * Returns a new bundle with the default value for every supported configuration variable.
    554      *
    555      * @hide
    556      */
    557     @NonNull
    558     @SystemApi
    559     public static PersistableBundle getDefaultConfig() {
    560         return new PersistableBundle(sDefaults);
    561     }
    562 
    563     /** @hide */
    564     private ICarrierConfigLoader getICarrierConfigLoader() {
    565         return ICarrierConfigLoader.Stub
    566                 .asInterface(ServiceManager.getService(Context.CARRIER_CONFIG_SERVICE));
    567     }
    568 }
    569