Most visited

Recently visited

Added in API level 23

CarrierConfigManager

public class CarrierConfigManager
extends Object

java.lang.Object
   ↳ android.telephony.CarrierConfigManager


Provides access to telephony configuration values that are carrier-specific.

Users should obtain an instance of this class by calling mContext.getSystemService(Context.CARRIER_CONFIG_SERVICE);

See also:

Summary

Constants

String ACTION_CARRIER_CONFIG_CHANGED

This intent is broadcast by the system when carrier config changes.

String KEY_ADDITIONAL_CALL_SETTING_BOOL

Does not display additional call seting for IMS phone based on GSM Phone

String KEY_ALLOW_ADDING_APNS_BOOL

Allow user to add APNs

String KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL

Determines if the current device should allow emergency numbers to be logged in the Call Log.

String KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL

Flag indicating whether to allow carrier video calls to emergency numbers.

String KEY_ALLOW_LOCAL_DTMF_TONES_BOOL

Determine whether we want to play local DTMF tones in a call, or just let the radio/BP handle playing of the tones.

String KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL

Determines whether the carrier supports making non-emergency phone calls while the phone is in emergency callback mode.

String KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL

The default flag specifying whether "Turn on Notifications" option will be always shown in Settings->More->Emergency broadcasts menu regardless developer options is turned on or not.

String KEY_APN_EXPAND_BOOL

Control whether users can edit APNs in Settings.

String KEY_AUTO_RETRY_ENABLED_BOOL

Flag indicating if auto retry is enabled

String KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL

Flag specifying whether IMS service can be turned off.

String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL

The default flag specifying whether ETWS/CMAS test setting is forcibly disabled in Settings->More->Emergency broadcasts menu even though developer options is turned on.

String KEY_CARRIER_IMS_GBA_REQUIRED_BOOL

Flag specifying whether Generic Bootstrapping Architecture capable SIM is required for IMS.

String KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL

Flag specifying whether IMS instant lettering is available for the carrier.

String KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines the character encoding which will be used when determining the length of messages.

String KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines a list of characters which must be escaped with a backslash '\' character.

String KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines the list of characters which may not be contained in messages.

String KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), the length limit for messages.

String KEY_CARRIER_SETTINGS_ENABLE_BOOL

Display carrier settings menu if true

String KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL

String KEY_CARRIER_VOLTE_AVAILABLE_BOOL

Flag specifying whether VoLTE should be available for carrier, independent of carrier provisioning.

String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL

Flag specifying whether provisioning is required for VOLTE.

String KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL

Flag specifying whether VoLTE TTY is supported.

String KEY_CARRIER_VT_AVAILABLE_BOOL

Flag specifying whether video telephony is available for carrier.

String KEY_CARRIER_VVM_PACKAGE_NAME_STRING

The package name of the carrier's visual voicemail app to ensure that dialer visual voicemail and carrier visual voicemail are not active at the same time.

String KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL

Flag specifying whether WFC over IMS should be available for carrier: independent of carrier provisioning.

String KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL

Flag specifying whether WFC over IMS supports the "wifi only" option.

String KEY_CDMA_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between postdial DTMF tones.

String KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered non roaming.

String KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered roaming.

String KEY_CI_ACTION_ON_SYS_UPDATE_BOOL

Flag specifying whether an additional (client initiated) intent needs to be sent on System update

String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING

Extra to be included in the intent sent for additional action on System update

String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING

Value of extra included in intent sent for additional action on System update

String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING

Intent to be sent for the additional action on System update

String KEY_CSP_ENABLED_BOOL

If this is true, the SIM card (through Customer Service Profile EF file) will be able to prevent manual operator selection.

String KEY_DEFAULT_SIM_CALL_MANAGER_STRING

The default sim call manager to use when the default dialer doesn't implement one.

String KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL

Disables dialing "*228" (OTASP provisioning) on CDMA carriers where it is not supported or is potentially harmful by locking the SIM to 3G.

String KEY_DTMF_TYPE_ENABLED_BOOL

Flag indicating if dtmf tone type is enabled

String KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT

The duration in seconds that platform call and message blocking is disabled after the user contacts emergency services.

String KEY_EDITABLE_ENHANCED_4G_LTE_BOOL

Determine whether user can toggle Enhanced 4G LTE Mode in Settings.

String KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL

If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity.

String KEY_FORCE_HOME_NETWORK_BOOL

Override the platform's notion of a network operator being considered non roaming.

String KEY_GSM_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between postdial DTMF tones.

String KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered not roaming.

String KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered roaming.

String KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL

Determines if device implements a noise suppression device for in call audio.

String KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL

Control whether users can reach the carrier portions of Cellular Network Settings.

String KEY_HIDE_IMS_APN_BOOL

Determine whether IMS apn can be shown.

String KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL

Determine whether preferred network type can be shown.

String KEY_HIDE_SIM_LOCK_SETTINGS_BOOL

Control whether users can reach the SIM lock settings.

String KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL

Flag indicating whether the Phone app should ignore EVENT_SIM_NETWORK_LOCKED events from the Sim.

String KEY_IMS_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between DTMF tones.

String KEY_MMS_ALIAS_ENABLED_BOOL

String KEY_MMS_ALIAS_MAX_CHARS_INT

String KEY_MMS_ALIAS_MIN_CHARS_INT

String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL

String KEY_MMS_APPEND_TRANSACTION_ID_BOOL

String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING

String KEY_MMS_GROUP_MMS_ENABLED_BOOL

String KEY_MMS_HTTP_PARAMS_STRING

String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT

String KEY_MMS_MAX_IMAGE_HEIGHT_INT

String KEY_MMS_MAX_IMAGE_WIDTH_INT

String KEY_MMS_MAX_MESSAGE_SIZE_INT

String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT

String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL

String KEY_MMS_MMS_ENABLED_BOOL

String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL

String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL

String KEY_MMS_NAI_SUFFIX_STRING

String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL

String KEY_MMS_RECIPIENT_LIMIT_INT

String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL

String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL

String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL

String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT

String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT

String KEY_MMS_SUBJECT_MAX_LENGTH_INT

String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL

String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL

String KEY_MMS_UA_PROF_TAG_NAME_STRING

String KEY_MMS_UA_PROF_URL_STRING

String KEY_MMS_USER_AGENT_STRING

String KEY_OPERATOR_SELECTION_EXPAND_BOOL

Control whether users can choose a network operator.

String KEY_PREFER_2G_BOOL

Used in Cellular Network Settings for preferred network type.

String KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL

Flag to require or skip entitlement checks.

String KEY_SHOW_APN_SETTING_CDMA_BOOL

Show APN Settings for some CDMA carriers

String KEY_SHOW_CDMA_CHOICES_BOOL

Show cdma network mode choices 1x, 3G, global etc.

String KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL

Flag specifying whether ICCID is showed in SIM Status screen, default to false.

String KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL

If true, show an onscreen "Dial" button in the dialer.

String KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL

Flag indicating whether the Phone app should provide a "Dismiss" button on the SIM network unlock screen.

String KEY_SUPPORT_CONFERENCE_CALL_BOOL

Determines whether conference calls are supported by a carrier.

String KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL

For IMS video over LTE calls, determines whether video pause signalling is supported.

String KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL

After a CDMA conference call is merged, the swap button should be displayed.

String KEY_USE_HFA_FOR_PROVISIONING_BOOL

CDMA activation goes through HFA

String KEY_USE_OTASP_FOR_PROVISIONING_BOOL

CDMA activation goes through OTASP.

String KEY_USE_RCS_PRESENCE_BOOL

Flag indicating whether the carrier supports RCS presence indication for video calls.

String KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL

Determine whether the voicemail notification is persistent in the notification bar.

String KEY_VOICE_PRIVACY_DISABLE_UI_BOOL

If true, removes the Voice Privacy option from Call Settings

String KEY_VOLTE_REPLACEMENT_RAT_INT

If Voice Radio Technology is RIL_RADIO_TECHNOLOGY_LTE:14 or RIL_RADIO_TECHNOLOGY_UNKNOWN:0 this is the value that should be used instead.

String KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL

Whether cellular data is required to access visual voicemail.

String KEY_VVM_DESTINATION_NUMBER_STRING

The carrier number mobile outgoing (MO) sms messages are sent to.

String KEY_VVM_PORT_NUMBER_INT

The port through which the mobile outgoing (MO) sms messages are sent through.

String KEY_VVM_PREFETCH_BOOL

Whether to prefetch audio data on new voicemail arrival, defaulted to true.

String KEY_VVM_TYPE_STRING

The type of visual voicemail protocol the carrier adheres to.

String KEY_WORLD_PHONE_BOOL

Flag indicating if the phone is a world phone

Public methods

PersistableBundle getConfig()

Gets the configuration values for the default subscription.

PersistableBundle getConfigForSubId(int subId)

Gets the configuration values for a particular subscription, which is associated with a specific SIM card.

void notifyConfigChangedForSubId(int subId)

Calling this method triggers telephony services to fetch the current carrier configuration.

Inherited methods

From class java.lang.Object

Constants

ACTION_CARRIER_CONFIG_CHANGED

Added in API level 23
String ACTION_CARRIER_CONFIG_CHANGED

This intent is broadcast by the system when carrier config changes.

Constant Value: "android.telephony.action.CARRIER_CONFIG_CHANGED"

KEY_ADDITIONAL_CALL_SETTING_BOOL

Added in API level 23
String KEY_ADDITIONAL_CALL_SETTING_BOOL

Does not display additional call seting for IMS phone based on GSM Phone

Constant Value: "additional_call_setting_bool"

KEY_ALLOW_ADDING_APNS_BOOL

Added in API level 24
String KEY_ALLOW_ADDING_APNS_BOOL

Allow user to add APNs

Constant Value: "allow_adding_apns_bool"

KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL

Added in API level 23
String KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL

Determines if the current device should allow emergency numbers to be logged in the Call Log. (Some carriers require that emergency calls *not* be logged, presumably to avoid the risk of accidental redialing from the call log UI. This is a good idea, so the default here is false.)

Constant Value: "allow_emergency_numbers_in_call_log_bool"

KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL

Added in API level 24
String KEY_ALLOW_EMERGENCY_VIDEO_CALLS_BOOL

Flag indicating whether to allow carrier video calls to emergency numbers. When true, video calls to emergency numbers will be allowed. When false, video calls to emergency numbers will be initiated as audio-only calls instead.

Constant Value: "allow_emergency_video_calls_bool"

KEY_ALLOW_LOCAL_DTMF_TONES_BOOL

Added in API level 23
String KEY_ALLOW_LOCAL_DTMF_TONES_BOOL

Determine whether we want to play local DTMF tones in a call, or just let the radio/BP handle playing of the tones.

Constant Value: "allow_local_dtmf_tones_bool"

KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL

Added in API level 24
String KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL

Determines whether the carrier supports making non-emergency phone calls while the phone is in emergency callback mode. Default value is true, meaning that non-emergency calls are allowed in emergency callback mode.

Constant Value: "allow_non_emergency_calls_in_ecm_bool"

KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL

Added in API level 24
String KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL

The default flag specifying whether "Turn on Notifications" option will be always shown in Settings->More->Emergency broadcasts menu regardless developer options is turned on or not.

Constant Value: "always_show_emergency_alert_onoff_bool"

KEY_APN_EXPAND_BOOL

Added in API level 23
String KEY_APN_EXPAND_BOOL

Control whether users can edit APNs in Settings.

Constant Value: "apn_expand_bool"

KEY_AUTO_RETRY_ENABLED_BOOL

Added in API level 23
String KEY_AUTO_RETRY_ENABLED_BOOL

Flag indicating if auto retry is enabled

Constant Value: "auto_retry_enabled_bool"

KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL

Added in API level 23
String KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL

Flag specifying whether IMS service can be turned off. If false then the service will not be turned-off completely, but individual features can be disabled.

Constant Value: "carrier_allow_turnoff_ims_bool"

KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL

Added in API level 24
String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL

The default flag specifying whether ETWS/CMAS test setting is forcibly disabled in Settings->More->Emergency broadcasts menu even though developer options is turned on.

Constant Value: "carrier_force_disable_etws_cmas_test_bool"

KEY_CARRIER_IMS_GBA_REQUIRED_BOOL

Added in API level 24
String KEY_CARRIER_IMS_GBA_REQUIRED_BOOL

Flag specifying whether Generic Bootstrapping Architecture capable SIM is required for IMS.

Constant Value: "carrier_ims_gba_required_bool"

KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL

Added in API level 24
String KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL

Flag specifying whether IMS instant lettering is available for the carrier. True if instant lettering is available for the carrier, false otherwise.

Constant Value: "carrier_instant_lettering_available_bool"

KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING

Added in API level 24
String KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines the character encoding which will be used when determining the length of messages. Used in the InCall UI to limit the number of characters the user may type. If empty-string, the instant lettering message size limit will be enforced on a 1:1 basis. That is, each character will count towards the messages size limit as a single bye. If a character encoding is specified, the message size limit will be based on the number of bytes in the message per the specified encoding.

Constant Value: "carrier_instant_lettering_encoding_string"

KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING

Added in API level 24
String KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines a list of characters which must be escaped with a backslash '\' character. Should be specified as a string containing the characters to be escaped. For example to escape quote and backslash the string would be a quote and a backslash.

Constant Value: "carrier_instant_lettering_escaped_chars_string"

KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING

Added in API level 24
String KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), determines the list of characters which may not be contained in messages. Should be specified as a regular expression suitable for use with matches(String).

Constant Value: "carrier_instant_lettering_invalid_chars_string"

KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT

Added in API level 24
String KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT

When IMS instant lettering is available for a carrier (see KEY_CARRIER_INSTANT_LETTERING_AVAILABLE_BOOL), the length limit for messages. Used in the InCall UI to ensure the user cannot enter more characters than allowed by the carrier. See also KEY_CARRIER_INSTANT_LETTERING_ENCODING_STRING for more information on how the length of the message is calculated.

Constant Value: "carrier_instant_lettering_length_limit_int"

KEY_CARRIER_SETTINGS_ENABLE_BOOL

Added in API level 23
String KEY_CARRIER_SETTINGS_ENABLE_BOOL

Display carrier settings menu if true

Constant Value: "carrier_settings_enable_bool"

KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL

Added in API level 24
String KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL

Constant Value: "carrier_use_ims_first_for_emergency_bool"

KEY_CARRIER_VOLTE_AVAILABLE_BOOL

Added in API level 23
String KEY_CARRIER_VOLTE_AVAILABLE_BOOL

Flag specifying whether VoLTE should be available for carrier, independent of carrier provisioning. If false: hard disabled. If true: then depends on carrier provisioning, availability, etc.

Constant Value: "carrier_volte_available_bool"

KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL

Added in API level 23
String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL

Flag specifying whether provisioning is required for VOLTE.

Constant Value: "carrier_volte_provisioning_required_bool"

KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL

Added in API level 23
String KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL

Flag specifying whether VoLTE TTY is supported.

Constant Value: "carrier_volte_tty_supported_bool"

KEY_CARRIER_VT_AVAILABLE_BOOL

Added in API level 23
String KEY_CARRIER_VT_AVAILABLE_BOOL

Flag specifying whether video telephony is available for carrier. If false: hard disabled. If true: then depends on carrier provisioning, availability, etc.

Constant Value: "carrier_vt_available_bool"

KEY_CARRIER_VVM_PACKAGE_NAME_STRING

Added in API level 23
String KEY_CARRIER_VVM_PACKAGE_NAME_STRING

The package name of the carrier's visual voicemail app to ensure that dialer visual voicemail and carrier visual voicemail are not active at the same time.

Constant Value: "carrier_vvm_package_name_string"

KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL

Added in API level 23
String KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL

Flag specifying whether WFC over IMS should be available for carrier: independent of carrier provisioning. If false: hard disabled. If true: then depends on carrier provisioning, availability etc.

Constant Value: "carrier_wfc_ims_available_bool"

KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL

Added in API level 24
String KEY_CARRIER_WFC_SUPPORTS_WIFI_ONLY_BOOL

Flag specifying whether WFC over IMS supports the "wifi only" option. If false, the wifi calling settings will not include an option for "wifi only". If true, the wifi calling settings will include an option for "wifi only"

By default, it is assumed that WFC supports "wifi only".

Constant Value: "carrier_wfc_supports_wifi_only_bool"

KEY_CDMA_DTMF_TONE_DELAY_INT

Added in API level 24
String KEY_CDMA_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between postdial DTMF tones. When a non-zero value is specified, the UE shall wait for the specified amount of time before it sends out successive DTMF tones on the network.

Constant Value: "cdma_dtmf_tone_delay_int"

KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY

Added in API level 23
String KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered non roaming. Value is string array of SIDs to be considered not roaming for 3GPP2 RATs.

Constant Value: "cdma_nonroaming_networks_string_array"

KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY

Added in API level 23
String KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered roaming. Value is string array of SIDs to be considered roaming for 3GPP2 RATs.

Constant Value: "cdma_roaming_networks_string_array"

KEY_CI_ACTION_ON_SYS_UPDATE_BOOL

Added in API level 24
String KEY_CI_ACTION_ON_SYS_UPDATE_BOOL

Flag specifying whether an additional (client initiated) intent needs to be sent on System update

Constant Value: "ci_action_on_sys_update_bool"

KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING

Added in API level 24
String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_STRING

Extra to be included in the intent sent for additional action on System update

Constant Value: "ci_action_on_sys_update_extra_string"

KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING

Added in API level 24
String KEY_CI_ACTION_ON_SYS_UPDATE_EXTRA_VAL_STRING

Value of extra included in intent sent for additional action on System update

Constant Value: "ci_action_on_sys_update_extra_val_string"

KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING

Added in API level 24
String KEY_CI_ACTION_ON_SYS_UPDATE_INTENT_STRING

Intent to be sent for the additional action on System update

Constant Value: "ci_action_on_sys_update_intent_string"

KEY_CSP_ENABLED_BOOL

Added in API level 23
String KEY_CSP_ENABLED_BOOL

If this is true, the SIM card (through Customer Service Profile EF file) will be able to prevent manual operator selection. If false, this SIM setting will be ignored and manual operator selection will always be available. See CPHS4_2.WW6, CPHS B.4.7.1 for more information

Constant Value: "csp_enabled_bool"

KEY_DEFAULT_SIM_CALL_MANAGER_STRING

Added in API level 23
String KEY_DEFAULT_SIM_CALL_MANAGER_STRING

The default sim call manager to use when the default dialer doesn't implement one. A sim call manager can control and route outgoing and incoming phone calls, even if they're placed using another connection service (PSTN, for example).

Constant Value: "default_sim_call_manager_string"

KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL

Added in API level 23
String KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL

Disables dialing "*228" (OTASP provisioning) on CDMA carriers where it is not supported or is potentially harmful by locking the SIM to 3G.

Constant Value: "disable_cdma_activation_code_bool"

KEY_DTMF_TYPE_ENABLED_BOOL

Added in API level 23
String KEY_DTMF_TYPE_ENABLED_BOOL

Flag indicating if dtmf tone type is enabled

Constant Value: "dtmf_type_enabled_bool"

KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT

Added in API level 24
String KEY_DURATION_BLOCKING_DISABLED_AFTER_EMERGENCY_INT

The duration in seconds that platform call and message blocking is disabled after the user contacts emergency services. Platform considers values in the range 0 to 604800 (one week) as valid. See isBlocked(Context, String)).

Constant Value: "duration_blocking_disabled_after_emergency_int"

KEY_EDITABLE_ENHANCED_4G_LTE_BOOL

Added in API level 24
String KEY_EDITABLE_ENHANCED_4G_LTE_BOOL

Determine whether user can toggle Enhanced 4G LTE Mode in Settings.

Constant Value: "editable_enhanced_4g_lte_bool"

KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL

Added in API level 23
String KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL

If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity. The pattern is set on a per-platform basis using config_virtualKeyVibePattern. To be consistent with the regular Dialer, this value should agree with the corresponding values from config.xml under apps/Contacts.

Constant Value: "enable_dialer_key_vibration_bool"

KEY_FORCE_HOME_NETWORK_BOOL

Added in API level 23
String KEY_FORCE_HOME_NETWORK_BOOL

Override the platform's notion of a network operator being considered non roaming. If true all networks are considered as home network a.k.a non-roaming. When false, the 2 pairs of CMDA and GSM roaming/non-roaming arrays are consulted.

See also:

Constant Value: "force_home_network_bool"

KEY_GSM_DTMF_TONE_DELAY_INT

Added in API level 24
String KEY_GSM_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between postdial DTMF tones. When a non-zero value is specified, the UE shall wait for the specified amount of time before it sends out successive DTMF tones on the network.

Constant Value: "gsm_dtmf_tone_delay_int"

KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY

Added in API level 23
String KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered not roaming. Value is string array of MCCMNCs to be considered not roaming for 3GPP RATs.

Constant Value: "gsm_nonroaming_networks_string_array"

KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY

Added in API level 23
String KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY

Override the platform's notion of a network operator being considered roaming. Value is string array of MCCMNCs to be considered roaming for 3GPP RATs.

Constant Value: "gsm_roaming_networks_string_array"

KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL

Added in API level 23
String KEY_HAS_IN_CALL_NOISE_SUPPRESSION_BOOL

Determines if device implements a noise suppression device for in call audio.

Constant Value: "has_in_call_noise_suppression_bool"

KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL

Added in API level 23
String KEY_HIDE_CARRIER_NETWORK_SETTINGS_BOOL

Control whether users can reach the carrier portions of Cellular Network Settings.

Constant Value: "hide_carrier_network_settings_bool"

KEY_HIDE_IMS_APN_BOOL

Added in API level 24
String KEY_HIDE_IMS_APN_BOOL

Determine whether IMS apn can be shown.

Constant Value: "hide_ims_apn_bool"

KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL

Added in API level 24
String KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL

Determine whether preferred network type can be shown.

Constant Value: "hide_preferred_network_type_bool"

KEY_HIDE_SIM_LOCK_SETTINGS_BOOL

Added in API level 23
String KEY_HIDE_SIM_LOCK_SETTINGS_BOOL

Control whether users can reach the SIM lock settings.

Constant Value: "hide_sim_lock_settings_bool"

KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL

Added in API level 23
String KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL

Flag indicating whether the Phone app should ignore EVENT_SIM_NETWORK_LOCKED events from the Sim. If true, this will prevent the IccNetworkDepersonalizationPanel from being shown, and effectively disable the "Sim network lock" feature.

Constant Value: "ignore_sim_network_locked_events_bool"

KEY_IMS_DTMF_TONE_DELAY_INT

Added in API level 24
String KEY_IMS_DTMF_TONE_DELAY_INT

Specifies the amount of gap to be added in millis between DTMF tones. When a non-zero value is specified, the UE shall wait for the specified amount of time before it sends out successive DTMF tones on the network.

Constant Value: "ims_dtmf_tone_delay_int"

KEY_MMS_ALIAS_ENABLED_BOOL

Added in API level 23
String KEY_MMS_ALIAS_ENABLED_BOOL

Constant Value: "aliasEnabled"

KEY_MMS_ALIAS_MAX_CHARS_INT

Added in API level 23
String KEY_MMS_ALIAS_MAX_CHARS_INT

Constant Value: "aliasMaxChars"

KEY_MMS_ALIAS_MIN_CHARS_INT

Added in API level 23
String KEY_MMS_ALIAS_MIN_CHARS_INT

Constant Value: "aliasMinChars"

KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL

Added in API level 23
String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL

Constant Value: "allowAttachAudio"

KEY_MMS_APPEND_TRANSACTION_ID_BOOL

Added in API level 23
String KEY_MMS_APPEND_TRANSACTION_ID_BOOL

Constant Value: "enabledTransID"

KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING

Added in API level 23
String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING

Constant Value: "emailGatewayNumber"

KEY_MMS_GROUP_MMS_ENABLED_BOOL

Added in API level 23
String KEY_MMS_GROUP_MMS_ENABLED_BOOL

Constant Value: "enableGroupMms"

KEY_MMS_HTTP_PARAMS_STRING

Added in API level 23
String KEY_MMS_HTTP_PARAMS_STRING

Constant Value: "httpParams"

KEY_MMS_HTTP_SOCKET_TIMEOUT_INT

Added in API level 23
String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT

Constant Value: "httpSocketTimeout"

KEY_MMS_MAX_IMAGE_HEIGHT_INT

Added in API level 23
String KEY_MMS_MAX_IMAGE_HEIGHT_INT

Constant Value: "maxImageHeight"

KEY_MMS_MAX_IMAGE_WIDTH_INT

Added in API level 23
String KEY_MMS_MAX_IMAGE_WIDTH_INT

Constant Value: "maxImageWidth"

KEY_MMS_MAX_MESSAGE_SIZE_INT

Added in API level 23
String KEY_MMS_MAX_MESSAGE_SIZE_INT

Constant Value: "maxMessageSize"

KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT

Added in API level 23
String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT

Constant Value: "maxMessageTextSize"

KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL

Added in API level 23
String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL

Constant Value: "enableMMSDeliveryReports"

KEY_MMS_MMS_ENABLED_BOOL

Added in API level 23
String KEY_MMS_MMS_ENABLED_BOOL

Constant Value: "enabledMMS"

KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL

Added in API level 23
String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL

Constant Value: "enableMMSReadReports"

KEY_MMS_MULTIPART_SMS_ENABLED_BOOL

Added in API level 23
String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL

Constant Value: "enableMultipartSMS"

KEY_MMS_NAI_SUFFIX_STRING

Added in API level 23
String KEY_MMS_NAI_SUFFIX_STRING

Constant Value: "naiSuffix"

KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL

Added in API level 23
String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL

Constant Value: "enabledNotifyWapMMSC"

KEY_MMS_RECIPIENT_LIMIT_INT

Added in API level 23
String KEY_MMS_RECIPIENT_LIMIT_INT

Constant Value: "recipientLimit"

KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL

Added in API level 23
String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL

Constant Value: "sendMultipartSmsAsSeparateMessages"

KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL

Added in API level 23
String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL

Constant Value: "config_cellBroadcastAppLinks"

KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL

Added in API level 23
String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL

Constant Value: "enableSMSDeliveryReports"

KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT

Added in API level 23
String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT

Constant Value: "smsToMmsTextLengthThreshold"

KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT

Added in API level 23
String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT

Constant Value: "smsToMmsTextThreshold"

KEY_MMS_SUBJECT_MAX_LENGTH_INT

Added in API level 23
String KEY_MMS_SUBJECT_MAX_LENGTH_INT

Constant Value: "maxSubjectLength"

KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL

Added in API level 23
String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL

Constant Value: "supportHttpCharsetHeader"

KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL

Added in API level 23
String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL

Constant Value: "supportMmsContentDisposition"

KEY_MMS_UA_PROF_TAG_NAME_STRING

Added in API level 23
String KEY_MMS_UA_PROF_TAG_NAME_STRING

Constant Value: "uaProfTagName"

KEY_MMS_UA_PROF_URL_STRING

Added in API level 23
String KEY_MMS_UA_PROF_URL_STRING

Constant Value: "uaProfUrl"

KEY_MMS_USER_AGENT_STRING

Added in API level 23
String KEY_MMS_USER_AGENT_STRING

Constant Value: "userAgent"

KEY_OPERATOR_SELECTION_EXPAND_BOOL

Added in API level 23
String KEY_OPERATOR_SELECTION_EXPAND_BOOL

Control whether users can choose a network operator.

Constant Value: "operator_selection_expand_bool"

KEY_PREFER_2G_BOOL

Added in API level 23
String KEY_PREFER_2G_BOOL

Used in Cellular Network Settings for preferred network type.

Constant Value: "prefer_2g_bool"

KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL

Added in API level 24
String KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL

Flag to require or skip entitlement checks. If true, entitlement checks will be executed if device has been configured for it, If false, entitlement checks will be skipped.

Constant Value: "require_entitlement_checks_bool"

KEY_SHOW_APN_SETTING_CDMA_BOOL

Added in API level 23
String KEY_SHOW_APN_SETTING_CDMA_BOOL

Show APN Settings for some CDMA carriers

Constant Value: "show_apn_setting_cdma_bool"

KEY_SHOW_CDMA_CHOICES_BOOL

Added in API level 23
String KEY_SHOW_CDMA_CHOICES_BOOL

Show cdma network mode choices 1x, 3G, global etc.

Constant Value: "show_cdma_choices_bool"

KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL

Added in API level 24
String KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL

Flag specifying whether ICCID is showed in SIM Status screen, default to false.

Constant Value: "show_iccid_in_sim_status_bool"

KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL

Added in API level 23
String KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL

If true, show an onscreen "Dial" button in the dialer. In practice this is used on all platforms, even the ones with hard SEND/END keys, but for maximum flexibility it's controlled by a flag here (which can be overridden on a per-product basis.)

Constant Value: "show_onscreen_dial_button_bool"

KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL

Added in API level 23
String KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL

Flag indicating whether the Phone app should provide a "Dismiss" button on the SIM network unlock screen. The default value is true. If set to false, there will be *no way* to dismiss the SIM network unlock screen if you don't enter the correct unlock code. (One important consequence: there will be no way to make an Emergency Call if your SIM is network-locked and you don't know the PIN.)

Constant Value: "sim_network_unlock_allow_dismiss_bool"

KEY_SUPPORT_CONFERENCE_CALL_BOOL

Added in API level 24
String KEY_SUPPORT_CONFERENCE_CALL_BOOL

Determines whether conference calls are supported by a carrier. When true, conference calling is supported, false otherwise.

Constant Value: "support_conference_call_bool"

KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL

Added in API level 23
String KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL

For IMS video over LTE calls, determines whether video pause signalling is supported.

Constant Value: "support_pause_ims_video_calls_bool"

KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL

Added in API level 23
String KEY_SUPPORT_SWAP_AFTER_MERGE_BOOL

After a CDMA conference call is merged, the swap button should be displayed.

Constant Value: "support_swap_after_merge_bool"

KEY_USE_HFA_FOR_PROVISIONING_BOOL

Added in API level 23
String KEY_USE_HFA_FOR_PROVISIONING_BOOL

CDMA activation goes through HFA

Constant Value: "use_hfa_for_provisioning_bool"

KEY_USE_OTASP_FOR_PROVISIONING_BOOL

Added in API level 23
String KEY_USE_OTASP_FOR_PROVISIONING_BOOL

CDMA activation goes through OTASP.

TODO: This should be combined with config_use_hfa_for_provisioning and implemented as an enum (NONE, HFA, OTASP).

Constant Value: "use_otasp_for_provisioning_bool"

KEY_USE_RCS_PRESENCE_BOOL

Added in API level 24
String KEY_USE_RCS_PRESENCE_BOOL

Flag indicating whether the carrier supports RCS presence indication for video calls. When true, the carrier supports RCS presence indication for video calls. When presence is supported, the device should use the CARRIER_PRESENCE bit mask and set the CARRIER_PRESENCE_VT_CAPABLE bit to indicate whether each contact supports video calling. The UI is made aware that presence is enabled via CAPABILITY_VIDEO_CALLING_RELIES_ON_PRESENCE and can choose to hide or show the video calling icon based on whether a contact supports video.

Constant Value: "use_rcs_presence_bool"

KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL

Added in API level 23
String KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL

Determine whether the voicemail notification is persistent in the notification bar. If true, the voicemail notifications cannot be dismissed from the notification bar.

Constant Value: "voicemail_notification_persistent_bool"

KEY_VOICE_PRIVACY_DISABLE_UI_BOOL

Added in API level 23
String KEY_VOICE_PRIVACY_DISABLE_UI_BOOL

If true, removes the Voice Privacy option from Call Settings

Constant Value: "voice_privacy_disable_ui_bool"

KEY_VOLTE_REPLACEMENT_RAT_INT

Added in API level 23
String KEY_VOLTE_REPLACEMENT_RAT_INT

If Voice Radio Technology is RIL_RADIO_TECHNOLOGY_LTE:14 or RIL_RADIO_TECHNOLOGY_UNKNOWN:0 this is the value that should be used instead. A configuration value of RIL_RADIO_TECHNOLOGY_UNKNOWN:0 means there is no replacement value and that the default assumption for phone type (GSM) should be used.

Constant Value: "volte_replacement_rat_int"

KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL

Added in API level 24
String KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL

Whether cellular data is required to access visual voicemail.

Constant Value: "vvm_cellular_data_required_bool"

KEY_VVM_DESTINATION_NUMBER_STRING

Added in API level 23
String KEY_VVM_DESTINATION_NUMBER_STRING

The carrier number mobile outgoing (MO) sms messages are sent to.

Constant Value: "vvm_destination_number_string"

KEY_VVM_PORT_NUMBER_INT

Added in API level 23
String KEY_VVM_PORT_NUMBER_INT

The port through which the mobile outgoing (MO) sms messages are sent through.

Constant Value: "vvm_port_number_int"

KEY_VVM_PREFETCH_BOOL

Added in API level 24
String KEY_VVM_PREFETCH_BOOL

Whether to prefetch audio data on new voicemail arrival, defaulted to true.

Constant Value: "vvm_prefetch_bool"

KEY_VVM_TYPE_STRING

Added in API level 23
String KEY_VVM_TYPE_STRING

The type of visual voicemail protocol the carrier adheres to. See TelephonyManager for possible values. For example VVM_TYPE_OMTP.

Constant Value: "vvm_type_string"

KEY_WORLD_PHONE_BOOL

Added in API level 23
String KEY_WORLD_PHONE_BOOL

Flag indicating if the phone is a world phone

Constant Value: "world_phone_bool"

Public methods

getConfig

Added in API level 23
PersistableBundle getConfig ()

Gets the configuration values for the default subscription.

Requires Permission: READ_PHONE_STATE

Returns
PersistableBundle

See also:

getConfigForSubId

Added in API level 23
PersistableBundle getConfigForSubId (int subId)

Gets the configuration values for a particular subscription, which is associated with a specific SIM card. If an invalid subId is used, the returned config will contain default values.

Requires Permission: READ_PHONE_STATE

Parameters
subId int: the subscription ID, normally obtained from SubscriptionManager.
Returns
PersistableBundle A PersistableBundle containing the config for the given subId, or default values for an invalid subId.

notifyConfigChangedForSubId

Added in API level 23
void notifyConfigChangedForSubId (int subId)

Calling this method triggers telephony services to fetch the current carrier configuration.

Normally this does not need to be called because the platform reloads config on its own. This should be called by a carrier service app if it wants to update config at an arbitrary moment.

Requires that the calling app has carrier privileges.

Parameters
subId int

See also:

Hooray!