CarrierConfigManager
public
class
CarrierConfigManager
extends Object
java.lang.Object | |
↳ | android.telephony.CarrierConfigManager |
Provides access to telephony configuration values that are carrier-specific.
Requires the PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION
feature which can be detected using PackageManager.hasSystemFeature(String)
.
Summary
Nested classes | |
---|---|
class |
CarrierConfigManager.Apn
Configs used for APN setup. |
class |
CarrierConfigManager.Bsf
This groups the BSF (BootStrapping Function) related configs. |
interface |
CarrierConfigManager.CarrierConfigChangeListener
Listener interface to get a notification when the carrier configurations have changed. |
class |
CarrierConfigManager.Gps
GPS configs. |
class |
CarrierConfigManager.Ims
Configs used by the IMS stack. |
class |
CarrierConfigManager.ImsEmergency
Emergency Call/E911. |
class |
CarrierConfigManager.ImsRtt
IMS RTT configs. |
class |
CarrierConfigManager.ImsServiceEntitlement
Configs used by ImsServiceEntitlement. |
class |
CarrierConfigManager.ImsSms
IMS SMS configs. |
class |
CarrierConfigManager.ImsSs
IMS supplementary services configs. |
class |
CarrierConfigManager.ImsVoice
IMS Voice configs. |
class |
CarrierConfigManager.ImsVt
IMS Video Telephony configs. |
class |
CarrierConfigManager.ImsWfc
WiFi Calling. |
class |
CarrierConfigManager.Iwlan
Configs used for epdg tunnel bring up. |
Constants | |
---|---|
String |
ACTION_CARRIER_CONFIG_CHANGED
This intent is broadcast by the system when carrier config changes. |
int |
CARRIER_NR_AVAILABILITY_NSA
Indicates CARRIER_NR_AVAILABILITY_NSA determine that the carrier enable the non-standalone (NSA) mode of 5G NR. |
int |
CARRIER_NR_AVAILABILITY_SA
Indicates CARRIER_NR_AVAILABILITY_SA determine that the carrier enable the standalone (SA) mode of 5G NR. |
int |
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_ONLY
Specifies SPN format of displaying carrier name only. |
int |
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_WITH_BRANDING
Specifies SPN format of displaying carrier name along with "Cross-SIM calling". |
int |
DATA_CYCLE_THRESHOLD_DISABLED
Flag indicating that a data cycle threshold should be disabled. |
int |
DATA_CYCLE_USE_PLATFORM_DEFAULT
When |
String |
ENABLE_EAP_METHOD_PREFIX_BOOL
Specifies whether the system should prefix the EAP method to the anonymous identity. |
String |
EXTRA_REBROADCAST_ON_UNLOCK
|
String |
EXTRA_SLOT_INDEX
Extra included in |
String |
EXTRA_SUBSCRIPTION_INDEX
Optional extra included in |
String |
IMSI_KEY_AVAILABILITY_INT
Identifies if the key is available for WLAN or EPDG or both. |
String |
KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS reference signal received power (SSRSRP) thresholds. |
String |
KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS reference signal received quality (SSRSRQ) thresholds. |
String |
KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS signal-to-noise and interference ratio (SSSINR) thresholds. |
String |
KEY_ADDITIONAL_CALL_SETTING_BOOL
Does not display additional call setting for IMS phone based on GSM Phone |
String |
KEY_ADDITIONAL_SETTINGS_CALLER_ID_VISIBILITY_BOOL
Boolean indicating if the "Caller ID" item is visible in the Additional Settings menu. |
String |
KEY_ADDITIONAL_SETTINGS_CALL_WAITING_VISIBILITY_BOOL
Boolean indicating if the "Call Waiting" item is visible in the Additional Settings menu. |
String |
KEY_ALLOW_ADDING_APNS_BOOL
Allow user to add APNs |
String |
KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL
When true, indicates that adding a call is disabled when there is an ongoing video call or when there is an ongoing call on wifi which was downgraded from video and VoWifi is turned off. |
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_HOLD_CALL_DURING_EMERGENCY_BOOL
Flag indicating whether or not an ongoing call will be held when an outgoing emergency call is placed. |
String |
KEY_ALLOW_HOLD_VIDEO_CALL_BOOL
When |
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_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL
Flag indicating whether the carrier supports merging wifi calls when VoWIFI is disabled. |
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_ALLOW_VIDEO_CALLING_FALLBACK_BOOL
Whether system apps are allowed to use fallback if carrier video call is not available. |
String |
KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL
Boolean indicating if show data RAT icon on status bar even when data is disabled. |
String |
KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL
This constant was deprecated in API level 30. The allow alerts option is always shown now. No longer need a config for that. |
String |
KEY_ALWAYS_SHOW_PRIMARY_SIGNAL_BAR_IN_OPPORTUNISTIC_NETWORK_BOOLEAN
Indicates when a carrier has a primary subscription and an opportunistic subscription active, and when Internet data is switched to opportunistic network, whether to still show signal bar of primary network. |
String |
KEY_APN_EXPAND_BOOL
Control whether users can edit APNs in Settings. |
String |
KEY_APN_SETTINGS_DEFAULT_APN_TYPES_STRING_ARRAY
Default value of APN types field if not specified by user when adding/modifying an APN. |
String |
KEY_AUTO_RETRY_ENABLED_BOOL
Flag indicating if auto retry is enabled |
String |
KEY_CALL_BARRING_DEFAULT_SERVICE_CLASS_INT
Specifies the service class for call barring service. |
String |
KEY_CALL_BARRING_SUPPORTS_DEACTIVATE_ALL_BOOL
Flag indicating whether or not deactivating all call barring features via the "Call Barring" settings menu is supported. |
String |
KEY_CALL_BARRING_SUPPORTS_PASSWORD_CHANGE_BOOL
Flag indicating whether or not changing the call barring password via the "Call Barring" settings menu is supported. |
String |
KEY_CALL_BARRING_VISIBILITY_BOOL
Boolean indicating if the "Call barring" item is visible in the Call Settings menu. |
String |
KEY_CALL_COMPOSER_PICTURE_SERVER_URL_STRING
Indicates the carrier server url that serves the call composer picture. |
String |
KEY_CALL_FORWARDING_BLOCKS_WHILE_ROAMING_STRING_ARRAY
An array containing custom call forwarding number prefixes that will be blocked while the device is reporting that it is roaming. |
String |
KEY_CALL_REDIRECTION_SERVICE_COMPONENT_NAME_STRING
Specifies a carrier-defined |
String |
KEY_CAPABILITIES_EXEMPT_FROM_SINGLE_DC_CHECK_INT_ARRAY
Only apply if |
String |
KEY_CARRIER_ALLOW_DEFLECT_IMS_CALL_BOOL
Flag indicating whether the carrier supports call deflection for an incoming IMS call. |
String |
KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL
Flag specifying whether IMS service can be turned off. |
String |
KEY_CARRIER_APP_REQUIRED_DURING_SIM_SETUP_BOOL
Determines whether the carrier app needed to be involved when users try to finish setting up the SIM card to get network service. |
String |
KEY_CARRIER_CALL_SCREENING_APP_STRING
The Component Name of a carrier-provided CallScreeningService implementation. |
String |
KEY_CARRIER_CERTIFICATE_STRING_ARRAY
Holds the list of carrier certificate hashes, followed by optional package names. |
String |
KEY_CARRIER_CONFIG_APPLIED_BOOL
Determines whether any carrier has been identified and its specific config has been applied, default to false. |
String |
KEY_CARRIER_CONFIG_VERSION_STRING
Specifies a value that identifies the version of the carrier configuration that is currently in use. |
String |
KEY_CARRIER_CROSS_SIM_IMS_AVAILABLE_BOOL
Flag specifying whether Cross SIM over IMS should be available for carrier. |
String |
KEY_CARRIER_DATA_CALL_PERMANENT_FAILURE_STRINGS
This constant was deprecated in API level 34. This API key was added in mistake and is not used anymore by the telephony data frameworks. |
String |
KEY_CARRIER_DEFAULT_ACTIONS_ON_DCFAILURE_STRING_ARRAY
Defines carrier-specific actions which act upon CARRIER_SIGNAL_REQUEST_NETWORK_FAILED
and configured signal args:
android.telephony.TelephonyManager#EXTRA_APN_TYPE,
android.telephony.TelephonyManager#EXTRA_ERROR_CODE
used for customization of the default carrier app
Format:
{
"APN_1, ERROR_CODE_1 : CARRIER_ACTION_IDX_1, CARRIER_ACTION_IDX_2...",
"APN_1, ERROR_CODE_2 : CARRIER_ACTION_IDX_1 "
}
Where |
String |
KEY_CARRIER_DEFAULT_ACTIONS_ON_DEFAULT_NETWORK_AVAILABLE
Defines carrier-specific actions which act upon com.android.internal.telephony.CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE, used for customization of the default carrier app. |
String |
KEY_CARRIER_DEFAULT_ACTIONS_ON_REDIRECTION_STRING_ARRAY
Defines carrier-specific actions which act upon com.android.internal.telephony.CARRIER_SIGNAL_REDIRECTED, used for customization of the default carrier app. |
String |
KEY_CARRIER_DEFAULT_ACTIONS_ON_RESET
Defines carrier-specific actions which act upon CARRIER_SIGNAL_RESET, used for customization of the default carrier app. |
String |
KEY_CARRIER_DEFAULT_REDIRECTION_URL_STRING_ARRAY
Defines a list of acceptable redirection url for default carrier app. |
String |
KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL
Default WFC_IMS_enabled: true VoWiFi by default is on false VoWiFi by default is off |
String |
KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
Default mode for WFC over IMS on home network:
|
String |
KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT
Default mode for WFC over IMS on roaming network. |
String |
KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL
This constant was deprecated
in API level 30.
Use |
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
|
String |
KEY_CARRIER_INSTANT_LETTERING_ESCAPED_CHARS_STRING
When IMS instant lettering is available for a carrier (see
|
String |
KEY_CARRIER_INSTANT_LETTERING_INVALID_CHARS_STRING
When IMS instant lettering is available for a carrier (see
|
String |
KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT
When IMS instant lettering is available for a carrier (see
|
String |
KEY_CARRIER_METERED_APN_TYPES_STRINGS
A string array indicating the default APN types that are metered by the carrier. |
String |
KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS
A string array indicating the default APN types that are roaming-metered by the carrier. |
String |
KEY_CARRIER_NAME_OVERRIDE_BOOL
Unconditionally override the carrier name string using #KEY_CARRIER_NAME_STRING. |
String |
KEY_CARRIER_NAME_STRING
String to identify carrier name in CarrierConfig app. |
String |
KEY_CARRIER_NR_AVAILABILITIES_INT_ARRAY
A list of carrier nr availability is used to determine whether the carrier enable the non-standalone (NSA) mode of 5G NR, standalone (SA) mode of 5G NR The value of list is
|
String |
KEY_CARRIER_PROVISIONS_WIFI_MERGED_NETWORKS_BOOL
Indicates whether or not the carrier will provision merged carrier Wi-Fi offload networks. |
String |
KEY_CARRIER_RCS_PROVISIONING_REQUIRED_BOOL
Flag specifying whether provisioning is required for RCS. |
String |
KEY_CARRIER_SERVICE_NAME_STRING_ARRAY
String array containing the list of names for service numbers provided by carriers. |
String |
KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
String array containing the list of service numbers provided by carriers. |
String |
KEY_CARRIER_SETTINGS_ACTIVITY_COMPONENT_NAME_STRING
Flatten |
String |
KEY_CARRIER_SETTINGS_ENABLE_BOOL
Display carrier settings menu if true |
String |
KEY_CARRIER_SUPPORTED_SATELLITE_SERVICES_PER_PROVIDER_BUNDLE
A PersistableBundle that contains a list of key-value pairs, where the values are integer arrays. |
String |
KEY_CARRIER_SUPPORTS_OPP_DATA_AUTO_PROVISIONING_BOOL
Configuration to indicate that the carrier supports opportunistic data auto provisioning. |
String |
KEY_CARRIER_SUPPORTS_SS_OVER_UT_BOOL
Flag indicating whether or not the carrier supports Supplementary Services over the UT interface for this subscription. |
String |
KEY_CARRIER_SUPPORTS_TETHERING_BOOL
Flag indicating if the carrier supports tethering of mobile data. |
String |
KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL
Flag specifying whether IMS should be the first phone attempted for E911 even if the phone is not in service. |
String |
KEY_CARRIER_USSD_METHOD_INT
Specify the method of selection for UE sending USSD requests. |
String |
KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL
This constant was deprecated
in API level 33.
Use |
String |
KEY_CARRIER_VOLTE_AVAILABLE_BOOL
Flag specifying whether VoLTE should be available for carrier, independent of carrier provisioning. |
String |
KEY_CARRIER_VOLTE_OVERRIDE_WFC_PROVISIONING_BOOL
Flag specifying if WFC provisioning depends on VoLTE provisioning. |
String |
KEY_CARRIER_VOLTE_PROVISIONED_BOOL
This constant was deprecated
in API level 33.
Use |
String |
KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
This constant was deprecated
in API level 33.
Use |
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
This constant was deprecated
in API level 26.
use |
String |
KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY
A list of the carrier's visual voicemail app package names 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_3WAYCALL_FLASH_DELAY_INT
For carriers which require an empty flash to be sent before sending the normal 3-way calling flash, the duration in milliseconds of the empty flash to send. |
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_MODE_INT
The CDMA roaming mode (aka CDMA system select). |
String |
KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
Override the platform's notion of a network operator being considered roaming. |
String |
KEY_CELLULAR_SERVICE_CAPABILITIES_INT_ARRAY
An array of cellular services supported by a subscription. |
String |
KEY_CELLULAR_USAGE_SETTING_INT
Controls the cellular usage setting. |
String |
KEY_CHECK_PRICING_WITH_CARRIER_FOR_DATA_ROAMING_BOOL
Determines whether we should show a warning asking the user to check with their carrier on pricing when the user enabled data roaming, default to false. |
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_CONFIG_IMS_MMTEL_PACKAGE_OVERRIDE_STRING
The package name containing the ImsService that will be bound to the telephony framework to support IMS MMTEL feature functionality instead of the device default ImsService for this subscription. |
String |
KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING
This constant was deprecated
in API level 30.
Use |
String |
KEY_CONFIG_IMS_RCS_PACKAGE_OVERRIDE_STRING
The package name containing the ImsService that will be bound to the telephony framework to support IMS RCS feature functionality instead of the device default ImsService for this subscription. |
String |
KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING
Override the package that will manage |
String |
KEY_CONFIG_TELEPHONY_USE_OWN_NUMBER_FOR_VOICEMAIL_BOOL
Flag that specifies to use the user's own phone number as the voicemail number when there is no pre-loaded voicemail number on the SIM card. |
String |
KEY_CONFIG_WIFI_DISABLE_IN_ECBM
Flag to indicate if Wi-Fi needs to be disabled in ECBM. |
String |
KEY_CROSS_SIM_SPN_FORMAT_INT
Indexes of SPN format strings in crossSimSpnFormats. |
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_DATA_LIMIT_NOTIFICATION_BOOL
Controls if the device should automatically notify the user as they reach their cellular data limit. |
String |
KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG
Controls the cellular data limit. |
String |
KEY_DATA_RAPID_NOTIFICATION_BOOL
Controls if the device should automatically notify the user when rapid cellular data usage is observed. |
String |
KEY_DATA_SWITCH_VALIDATION_MIN_INTERVAL_MILLIS_LONG
Data switch validation minimal interval, in milliseconds. |
String |
KEY_DATA_SWITCH_VALIDATION_TIMEOUT_LONG
Upon data switching between subscriptions within a carrier group, if switch depends on validation result, this value defines customized value of how long we wait for validation success before we fail and revoke the switch. |
String |
KEY_DATA_WARNING_NOTIFICATION_BOOL
Controls if the device should automatically notify the user as they reach their cellular data warning. |
String |
KEY_DATA_WARNING_THRESHOLD_BYTES_LONG
Controls the data usage warning. |
String |
KEY_DEFAULT_SIM_CALL_MANAGER_STRING
The default sim call manager to use when the default dialer doesn't implement one. |
String |
KEY_DEFAULT_VM_NUMBER_ROAMING_AND_IMS_UNREGISTERED_STRING
Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default voicemail number while the device is both roaming and not registered for IMS. |
String |
KEY_DEFAULT_VM_NUMBER_STRING
Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default voicemail number. |
String |
KEY_DIAL_STRING_REPLACE_STRING_ARRAY
Specifies a map from dialstrings to replacements for roaming network service numbers which cannot be replaced on the carrier side. |
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_DISABLE_CHARGE_INDICATION_BOOL
The flag to disable the popup dialog which warns the user of data charges. |
String |
KEY_DISABLE_SUPPLEMENTARY_SERVICES_IN_AIRPLANE_MODE_BOOL
Boolean indicating the Supplementary Services(SS) is disable when airplane mode on in the Call Settings menu. |
String |
KEY_DISCONNECT_CAUSE_PLAY_BUSYTONE_INT_ARRAY
DisconnectCause array to play busy tone. |
String |
KEY_DISPLAY_CALL_STRENGTH_INDICATOR_BOOL
Determine whether or not to display a call strength indicator for this carrier in the System UI. |
String |
KEY_DISPLAY_HD_AUDIO_PROPERTY_BOOL
Determines whether High Definition audio property is displayed in the dialer UI. |
String |
KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL
When |
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_EDITABLE_VOICEMAIL_NUMBER_BOOL
Since the default voicemail number is empty, if a SIM card does not have a voicemail number available the user cannot use voicemail. |
String |
KEY_EDITABLE_VOICEMAIL_NUMBER_SETTING_BOOL
Determine whether user can edit voicemail number in Settings. |
String |
KEY_EDITABLE_WFC_MODE_BOOL
Determine whether user can switch Wi-Fi preferred or Cellular preferred in calling preference. |
String |
KEY_EDITABLE_WFC_ROAMING_MODE_BOOL
Determine whether user can change Wi-Fi Calling preference in roaming. |
String |
KEY_EMERGENCY_NOTIFICATION_DELAY_INT
Time delay (in ms) after which we show the notification for emergency calls, while the device is registered over WFC. |
String |
KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY
Indicates zero or more emergency number prefix(es), because some carrier requires if users dial an emergency number address with a specific prefix, the combination of the prefix and the address is also a valid emergency number to dial. |
String |
KEY_ENABLE_CROSS_SIM_CALLING_ON_OPPORTUNISTIC_DATA_BOOL
Flag specifying whether cross sim calling on opportunistic data is supported for carrier. |
String |
KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL
If true, enable vibration (haptic feedback) for key presses in the EmergencyDialer activity. |
String |
KEY_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL
Sets the default state for the "Enhanced 4G LTE" or "Advanced Calling" mode toggle set by the user. |
String |
KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT
The index indicates the carrier specified title string of Enhanced 4G LTE Mode settings. |
String |
KEY_ESIM_DOWNLOAD_RETRY_BACKOFF_TIMER_SEC_INT
This timer value is used in the eSIM Exponential Backoff download retry algorithm. |
String |
KEY_ESIM_MAX_DOWNLOAD_RETRY_ATTEMPTS_INT
If eSIM profile download fails then, the number of retry attempts by UE will be based on this configuration. |
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_ENHANCED_4G_LTE_BOOL
Determines whether the Enhanced 4G LTE toggle will be shown in the settings. |
String |
KEY_HIDE_IMS_APN_BOOL
Determine whether IMS apn can be shown. |
String |
KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL
Boolean indicating if LTE+ icon should be shown if available. |
String |
KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL
Determine whether preferred network type can be shown. |
String |
KEY_HIDE_PRESET_APN_DETAILS_BOOL
Flag to hide Preset APN details. |
String |
KEY_HIDE_SIM_LOCK_SETTINGS_BOOL
Control whether users can reach the SIM lock settings. |
String |
KEY_HIDE_TTY_HCO_VCO_WITH_RTT_BOOL
Indicates if the TTY HCO and VCO options should be hidden in the accessibility menu if the device is capable of RTT. |
String |
KEY_IGNORE_DATA_ENABLED_CHANGED_FOR_VIDEO_CALLS
When |
String |
KEY_IGNORE_RTT_MODE_SETTING_BOOL
When |
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_CONFERENCE_SIZE_LIMIT_INT
Determines the maximum number of participants the carrier supports for a conference call. |
String |
KEY_IMS_DTMF_TONE_DELAY_INT
Specifies the amount of gap to be added in millis between DTMF tones. |
String |
KEY_INCLUDE_LTE_FOR_NR_ADVANCED_THRESHOLD_BANDWIDTH_BOOL
Indicating whether to include LTE cell bandwidths when determining whether the aggregated cell bandwidth meets the required threshold for NR advanced. |
String |
KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL
Determines whether a maximum size limit for IMS conference calls is enforced on the device. |
String |
KEY_IS_OPPORTUNISTIC_SUBSCRIPTION_BOOL
A boolean property indicating whether this subscription should be managed as an opportunistic subscription. |
String |
KEY_LTE_ENABLED_BOOL
Boolean to decide whether LTE is enabled. |
String |
KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY
A list of 4 customized LTE Reference Signal Received Quality (RSRQ) thresholds. |
String |
KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY
A list of 4 customized LTE Reference Signal Signal to Noise Ratio (RSSNR) thresholds. |
String |
KEY_MDN_IS_ADDITIONAL_VOICEMAIL_NUMBER_BOOL
When checking if a given number is the voicemail number, if this flag is true then in addition to comparing the given number to the voicemail number, we also compare it to the mdn. |
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_CLOSE_CONNECTION_BOOL
If true, add "Connection: close" header to MMS HTTP requests so the connection is immediately closed (disabling keep-alive). |
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_NETWORK_RELEASE_TIMEOUT_MILLIS_INT
Waiting time in milliseconds used before releasing an MMS data call. |
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_MONTHLY_DATA_CYCLE_DAY_INT
The day of the month (1-31) on which the data cycle rolls over. |
String |
KEY_NTN_LTE_RSRP_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. |
String |
KEY_NTN_LTE_RSRQ_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. |
String |
KEY_NTN_LTE_RSSNR_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. |
String |
KEY_ONLY_AUTO_SELECT_IN_HOME_NETWORK_BOOL
Only allow auto selection in Advanced Network Settings when in home network. |
String |
KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY
List of network type constants which support only a single data connection at a time. |
String |
KEY_OPERATOR_SELECTION_EXPAND_BOOL
Control whether users can choose a network operator. |
String |
KEY_OPPORTUNISTIC_NETWORK_BACKOFF_TIME_LONG
Controls back off time in milli seconds for switching back to opportunistic subscription. |
String |
KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_EXIT_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before switching data from opportunistic network to primary network. |
String |
KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before switching data to an opportunistic network. |
String |
KEY_OPPORTUNISTIC_NETWORK_ENTRY_OR_EXIT_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before attaching to a network. |
String |
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_BANDWIDTH_INT
Controls bandwidth threshold in Kbps at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data. |
String |
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSRP_INT
Controls RSRP threshold, in dBm, at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data. |
String |
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSSNR_INT
Controls RSSNR threshold, in dB, at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data. |
String |
KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT
Controls RSRP threshold, in dBm, below which OpportunisticNetworkService will decide whether the opportunistic network available is not good enough for internet data. |
String |
KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT
Controls RSSNR threshold, in dB, below which OpportunisticNetworkService will decide whether the opportunistic network available is not good enough for internet data. |
String |
KEY_OPPORTUNISTIC_NETWORK_MAX_BACKOFF_TIME_LONG
Controls the max back off time in milli seconds for switching back to opportunistic subscription. |
String |
KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG
Controls the ping pong determination of opportunistic network. |
String |
KEY_PARAMETERS_USED_FOR_NTN_LTE_SIGNAL_BAR_INT
This threshold is used when connected to a non-terrestrial LTE network. |
String |
KEY_PING_TEST_BEFORE_DATA_SWITCH_BOOL
Controls whether to do ping test before switching data to opportunistic network. |
String |
KEY_PREFER_2G_BOOL
Used in the Preferred Network Types menu to determine if the 2G option is displayed. |
String |
KEY_PREFER_3G_VISIBILITY_BOOL
Used in the Preferred Network Types menu to determine if the 3G option is displayed. |
String |
KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT
The maximum number of times in a day that we display the notification for a performance boost
via premium capabilities when
|
String |
KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT
The maximum number of times in a month that we display the notification for a performance
boost via premium capabilities when
|
String |
KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG
The amount of time in milliseconds within which the network must set up a slicing
configuration for the premium capability after
|
String |
KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
The amount of time in milliseconds that the notification for a performance boost via
premium capabilities should be blocked when
|
String |
KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG
The amount of time in milliseconds the notification for a performance boost via
premium capabilities will be visible to the user after
|
String |
KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
The amount of time in milliseconds that the purchase request should be throttled when
|
String |
KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING
The URL to redirect to when the user clicks on the notification for a performance boost via
premium capabilities after applications call
|
String |
KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL
Whether to allow premium capabilities to be purchased when the device is connected to LTE. |
String |
KEY_PREVENT_CLIR_ACTIVATION_AND_DEACTIVATION_CODE_BOOL
Flag specifying whether to prevent sending CLIR activation("*31#") and deactivation("#31#") code only without dialing number. |
String |
KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY
A list of failure cause codes that will trigger a modem restart when telephony receiving one of those during data setup. |
String |
KEY_RATCHET_NR_ADVANCED_BANDWIDTH_IF_RRC_IDLE_BOOL
Indicating whether to ratchet the aggregated cell bandwidths on receiving new values when the device is in RRC IDLE mode. |
String |
KEY_RCS_CONFIG_SERVER_URL_STRING
The RCS configuration server URL. |
String |
KEY_READ_ONLY_APN_FIELDS_STRING_ARRAY
APN fields that user is not allowed to modify. |
String |
KEY_READ_ONLY_APN_TYPES_STRING_ARRAY
APN types that user is not allowed to modify. |
String |
KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL
Flag to require or skip entitlement checks. |
String |
KEY_RESTART_RADIO_ON_PDP_FAIL_REGULAR_DEACTIVATION_BOOL
This constant was deprecated
in API level 29.
Use |
String |
KEY_RTT_AUTO_UPGRADE_BOOL
Indicates if the carrier supports auto-upgrading a call to RTT when receiving a call from a RTT-supported device. |
String |
KEY_RTT_DOWNGRADE_SUPPORTED_BOOL
Indicates if the carrier supports downgrading a RTT call to a voice call during the call. |
String |
KEY_RTT_SUPPORTED_BOOL
Flag indicating whether the carrier supports RTT over IMS. |
String |
KEY_RTT_SUPPORTED_FOR_VT_BOOL
Indicates if the carrier supports RTT during a video call. |
String |
KEY_RTT_SUPPORTED_WHILE_ROAMING_BOOL
Indicates whether RTT is supported while roaming. |
String |
KEY_RTT_UPGRADE_SUPPORTED_BOOL
Indicates if the carrier supports upgrading a voice call to an RTT call during the call. |
String |
KEY_RTT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_VT_CALL_BOOL
Indicates if the carrier supports upgrading a call that was previously a VT call to RTT. |
String |
KEY_SATELLITE_ATTACH_SUPPORTED_BOOL
This config enables modem to scan satellite PLMNs specified as per
|
String |
KEY_SATELLITE_CONNECTION_HYSTERESIS_SEC_INT
The carrier-enabled satellite connection hysteresis time in seconds for which the device continues in satellite mode after it loses the connection with the satellite network. |
String |
KEY_SATELLITE_ENTITLEMENT_STATUS_REFRESH_DAYS_INT
An integer key holds the time interval for refreshing or re-querying the satellite entitlement status from the entitlement server to ensure it is the latest. |
String |
KEY_SATELLITE_ENTITLEMENT_SUPPORTED_BOOL
This configuration enables device to query the entitlement server to get the satellite configuration. |
String |
KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL
Boolean indicating if default data account should show 4G icon when in 3G. |
String |
KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL
Boolean indicating if default data account should show LTE or 4G icon. |
String |
KEY_SHOW_APN_SETTING_CDMA_BOOL
Show APN Settings for some CDMA carriers |
String |
KEY_SHOW_BLOCKING_PAY_PHONE_OPTION_BOOL
Flag specifying whether to show blocking pay phone option in blocked numbers screen. |
String |
KEY_SHOW_CALL_BLOCKING_DISABLED_NOTIFICATION_ALWAYS_BOOL
Flag specifying whether to show notification(call blocking disabled) when Enhanced Call Blocking(KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL) is enabled and making emergency call. |
String |
KEY_SHOW_CDMA_CHOICES_BOOL
Show cdma network mode choices 1x, 3G, global etc. |
String |
KEY_SHOW_FORWARDED_NUMBER_BOOL
Flag specifying whether to show forwarded number on call-in-progress screen. |
String |
KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL
Flag specifying whether ICCID is showed in SIM Status screen, default to false. |
String |
KEY_SHOW_IMS_REGISTRATION_STATUS_BOOL
Flag specifying whether IMS registration state menu is shown in Status Info setting, default to false. |
String |
KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL
If true, show an onscreen "Dial" button in the dialer. |
String |
KEY_SHOW_ROAMING_INDICATOR_BOOL
Config to show the roaming indicator (i.e. |
String |
KEY_SHOW_SIGNAL_STRENGTH_IN_SIM_STATUS_BOOL
Flag specifying whether the |
String |
KEY_SHOW_VIDEO_CALL_CHARGES_ALERT_DIALOG_BOOL
Flag specifying whether to show an alert dialog for video call charges. |
String |
KEY_SHOW_WFC_LOCATION_PRIVACY_POLICY_BOOL
Determines whether wifi calling location privacy policy is shown. |
String |
KEY_SIMPLIFIED_NETWORK_SETTINGS_BOOL
This constant was deprecated in API level 34. Never implemented. Has no behavior impact when override. DO NOT USE. |
String |
KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING
String to override sim country iso. |
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_SMDP_SERVER_ADDRESS_STRING
SMDP+ server address for downloading opportunistic eSIM profile. |
String |
KEY_SMS_REQUIRES_DESTINATION_NUMBER_CONVERSION_BOOL
Determines if the carrier requires converting the destination number before sending out an SMS. |
String |
KEY_SUBSCRIPTION_GROUP_UUID_STRING
The UUID of a Group of related subscriptions in which to place the current subscription. |
String |
KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY
A list of premium capabilities the carrier supports. |
String |
KEY_SUPPORTS_BUSINESS_CALL_COMPOSER_BOOL
Indicates if the carrier supports a business call composer. |
String |
KEY_SUPPORTS_CALL_COMPOSER_BOOL
Indicates if the carrier supports call composer. |
String |
KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_DTMF_BOOL
Indicates whether the carrier supports the use of DTMF digits A-D for the purpose of device to device communication while in a call. |
String |
KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_RTP_BOOL
Indicates whether the carrier supports the use of RFC8285 compliant RTP header extensions for the purpose of device to device communication while in a call. |
String |
KEY_SUPPORTS_SDP_NEGOTIATION_OF_D2D_RTP_HEADER_EXTENSIONS_BOOL
Indicates whether the carrier supports the negotiations of RFC8285 compliant RTP header extensions supported on a call during the Session Description Protocol (SDP). |
String |
KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL
Indicates whether the carrier supports 3gpp call forwarding MMI codes while roaming. |
String |
KEY_SUPPORT_ADD_CONFERENCE_PARTICIPANTS_BOOL
Determines whether conference participants can be added to existing call to form an adhoc conference call (in contrast to merging calls to form a conference). |
String |
KEY_SUPPORT_ADHOC_CONFERENCE_CALLS_BOOL
Determines whether adhoc conference calls are supported by a carrier. |
String |
KEY_SUPPORT_CLIR_NETWORK_DEFAULT_BOOL
Flag indicating whether to support "Network default" option in Caller ID settings for Calling Line Identification Restriction (CLIR). |
String |
KEY_SUPPORT_CONFERENCE_CALL_BOOL
Determines whether conference calls are supported by a carrier. |
String |
KEY_SUPPORT_EMERGENCY_SMS_OVER_IMS_BOOL
Flag indicating whether or not sending emergency SMS messages over IMS is supported when in LTE/limited LTE (Emergency only) service mode.. |
String |
KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL
Determines whether to enable enhanced call blocking feature on the device. |
String |
KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL
Determines whether the IMS conference merge process supports and returns its participants data. |
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_SUPPORT_TDSCDMA_BOOL
Boolean to decide whether TD-SCDMA is supported. |
String |
KEY_SUPPORT_TDSCDMA_ROAMING_NETWORKS_STRING_ARRAY
A list of mcc/mnc that support TD-SCDMA for device when connect to the roaming network. |
String |
KEY_SWITCH_DATA_TO_PRIMARY_IF_PRIMARY_IS_OOS_BOOL
Controls whether to switch data to primary from opportunistic subscription if primary is out of service. |
String |
KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL
Flag indicating whether some telephony logic will treat a call which was formerly a video call as if it is still a video call. |
String |
KEY_TTY_SUPPORTED_BOOL
Boolean flag indicating whether the carrier supports TTY. |
String |
KEY_UNLOGGABLE_NUMBERS_STRING_ARRAY
A string array containing numbers that shouldn't be included in the call log. |
String |
KEY_USE_ACS_FOR_RCS_BOOL
Indicates if auto-configuration server is used for the RCS config Reference: GSMA RCC.14 |
String |
KEY_USE_HFA_FOR_PROVISIONING_BOOL
CDMA activation goes through HFA |
String |
KEY_USE_IP_FOR_CALLING_INDICATOR_BOOL
Determines whether or not to use (IP) data connectivity as a supplemental condition to control the visibility of the no-calling indicator for this carrier in the System UI. |
String |
KEY_USE_OTASP_FOR_PROVISIONING_BOOL
CDMA activation goes through OTASP. |
String |
KEY_USE_RCS_PRESENCE_BOOL
This constant was deprecated
in API level 31.
No longer used in framework code, however it may still be used by applications
that have not updated their code. This config should still be set to |
String |
KEY_USE_RCS_SIP_OPTIONS_BOOL
Flag indicating whether the carrier supports RCS SIP OPTIONS indication for User Capability Exchange (UCE). |
String |
KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
Flag specifying whether the carrier will use the WFC home network mode in roaming network. |
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_VONR_ENABLED_BOOL
Flag specifying whether VoNR should be enabled for carrier. |
String |
KEY_VONR_ON_BY_DEFAULT_BOOL
Boolean indicating the default VoNR user preference setting. |
String |
KEY_VONR_SETTING_VISIBILITY_BOOL
Boolean indicating if the VoNR setting is visible in the Call Settings menu. |
String |
KEY_VT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_RTT_CALL_BOOL
Indicates if the carrier supports upgrading a call that was previously an RTT call to VT. |
String |
KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL
Whether cellular data is required to access visual voicemail. |
String |
KEY_VVM_CLIENT_PREFIX_STRING
The default OMTP visual voicemail client prefix to use. |
String |
KEY_VVM_DESTINATION_NUMBER_STRING
The carrier number mobile outgoing (MO) sms messages are sent to. |
String |
KEY_VVM_DISABLED_CAPABILITIES_STRING_ARRAY
A set of capabilities that should not be used even if it is reported by the visual voicemail IMAP CAPABILITY command. |
String |
KEY_VVM_LEGACY_MODE_ENABLED_BOOL
Whether legacy mode should be used when the visual voicemail client is disabled. |
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_SSL_ENABLED_BOOL
Whether to use SSL to connect to the visual voicemail IMAP server. |
String |
KEY_VVM_TYPE_STRING
The type of visual voicemail protocol the carrier adheres to. |
String |
KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING
The Component Name of the activity that can setup the emergency address for WiFi Calling as per carrier requirement. |
String |
KEY_WORLD_MODE_ENABLED_BOOL
Boolean to decide whether world mode is enabled. |
String |
KEY_WORLD_PHONE_BOOL
Flag indicating if the phone is a world phone |
String |
REMOVE_GROUP_UUID_STRING
Passing this value as |
int |
SERVICE_CLASS_NONE
Service class flag if no specific service class is specified. |
int |
SERVICE_CLASS_VOICE
Service class flag for voice telephony. |
int |
USSD_OVER_CS_ONLY
Only send USSD over CS. |
int |
USSD_OVER_CS_PREFERRED
Only send USSD over IMS while CS is out of service, otherwise send USSD over CS. |
int |
USSD_OVER_IMS_ONLY
Only send USSD over IMS and disallow silent redial over CS. |
int |
USSD_OVER_IMS_PREFERRED
Send USSD over IMS or CS while IMS is out of service or silent redial over CS if needed. |
Public methods | |
---|---|
PersistableBundle
|
getConfig(String... keys)
Gets the configuration values of the specified config keys applied for the default subscription. |
PersistableBundle
|
getConfig()
This method was deprecated
in API level 34.
use |
PersistableBundle
|
getConfigByComponentForSubId(String prefix, int subId)
Gets the configuration values for a component using its prefix. |
PersistableBundle
|
getConfigForSubId(int subId, String... keys)
Gets the configuration values of the specified keys for a particular subscription. |
PersistableBundle
|
getConfigForSubId(int subId)
This method was deprecated
in API level 34.
Use |
static
boolean
|
isConfigForIdentifiedCarrier(PersistableBundle bundle)
Determines whether a configuration |
void
|
notifyConfigChangedForSubId(int subId)
Calling this method triggers telephony services to fetch the current carrier configuration. |
void
|
registerCarrierConfigChangeListener(Executor executor, CarrierConfigManager.CarrierConfigChangeListener listener)
Register a |
void
|
unregisterCarrierConfigChangeListener(CarrierConfigManager.CarrierConfigChangeListener listener)
Unregister the |
Inherited methods | |
---|---|
Constants
ACTION_CARRIER_CONFIG_CHANGED
public static final String ACTION_CARRIER_CONFIG_CHANGED
This intent is broadcast by the system when carrier config changes. An int is specified in
EXTRA_SLOT_INDEX
to indicate the slot index that this is for. An optional int extra
EXTRA_SUBSCRIPTION_INDEX
is included to indicate the subscription index if a valid
one is available for the slot index. An optional int extra
TelephonyManager#EXTRA_CARRIER_ID
is included to indicate the carrier id for the
changed carrier configuration. An optional int extra
TelephonyManager#EXTRA_SPECIFIC_CARRIER_ID
is included to indicate the precise
carrier id for the changed carrier configuration.
Constant Value: "android.telephony.action.CARRIER_CONFIG_CHANGED"
CARRIER_NR_AVAILABILITY_NSA
public static final int CARRIER_NR_AVAILABILITY_NSA
Indicates CARRIER_NR_AVAILABILITY_NSA determine that the carrier enable the non-standalone (NSA) mode of 5G NR.
Constant Value: 1 (0x00000001)
CARRIER_NR_AVAILABILITY_SA
public static final int CARRIER_NR_AVAILABILITY_SA
Indicates CARRIER_NR_AVAILABILITY_SA determine that the carrier enable the standalone (SA) mode of 5G NR.
Constant Value: 2 (0x00000002)
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_ONLY
public static final int CROSS_SIM_SPN_FORMAT_CARRIER_NAME_ONLY
Specifies SPN format of displaying carrier name only.
Constant Value: 0 (0x00000000)
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_WITH_BRANDING
public static final int CROSS_SIM_SPN_FORMAT_CARRIER_NAME_WITH_BRANDING
Specifies SPN format of displaying carrier name along with "Cross-SIM calling".
Constant Value: 1 (0x00000001)
DATA_CYCLE_THRESHOLD_DISABLED
public static final int DATA_CYCLE_THRESHOLD_DISABLED
Flag indicating that a data cycle threshold should be disabled.
If KEY_DATA_WARNING_THRESHOLD_BYTES_LONG
is set to this value, the platform's
default data warning, if one exists, will be disabled. A user selected data warning will not
be overridden.
If KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG
is set to this value, the platform's
default data limit, if one exists, will be disabled. A user selected data limit will not be
overridden.
Constant Value: -2 (0xfffffffe)
DATA_CYCLE_USE_PLATFORM_DEFAULT
public static final int DATA_CYCLE_USE_PLATFORM_DEFAULT
When KEY_MONTHLY_DATA_CYCLE_DAY_INT
, KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG
,
or KEY_DATA_WARNING_THRESHOLD_BYTES_LONG
are set to this value, the platform default
value will be used for that key.
Constant Value: -1 (0xffffffff)
ENABLE_EAP_METHOD_PREFIX_BOOL
public static final String ENABLE_EAP_METHOD_PREFIX_BOOL
Specifies whether the system should prefix the EAP method to the anonymous identity. The following prefix will be added if this key is set to TRUE: EAP-AKA: "0" EAP-SIM: "1" EAP-AKA_PRIME: "6"
Constant Value: "enable_eap_method_prefix_bool"
EXTRA_REBROADCAST_ON_UNLOCK
public static final String EXTRA_REBROADCAST_ON_UNLOCK
ACTION_CARRIER_CONFIG_CHANGED
is broadcast once on device bootup and then again when
the device is unlocked. Direct-Boot-aware applications may use the first broadcast as an
early signal that the carrier config has been loaded, but other applications will only
receive the second broadcast, when the device is unlocked.
This extra is included in ACTION_CARRIER_CONFIG_CHANGED
to indicate whether this is
a rebroadcast on unlock.
Constant Value: "android.telephony.extra.REBROADCAST_ON_UNLOCK"
EXTRA_SLOT_INDEX
public static final String EXTRA_SLOT_INDEX
Extra included in ACTION_CARRIER_CONFIG_CHANGED
to indicate the slot index that the
broadcast is for.
Constant Value: "android.telephony.extra.SLOT_INDEX"
EXTRA_SUBSCRIPTION_INDEX
public static final String EXTRA_SUBSCRIPTION_INDEX
Optional extra included in ACTION_CARRIER_CONFIG_CHANGED
to indicate the
subscription index that the broadcast is for, if a valid one is available.
Constant Value: "android.telephony.extra.SUBSCRIPTION_INDEX"
IMSI_KEY_AVAILABILITY_INT
public static final String IMSI_KEY_AVAILABILITY_INT
Identifies if the key is available for WLAN or EPDG or both. The value is a bitmask. 0 indicates that neither EPDG or WLAN is enabled. 1 indicates that key type TelephonyManager#KEY_TYPE_EPDG is enabled. 2 indicates that key type TelephonyManager#KEY_TYPE_WLAN is enabled. 3 indicates that both are enabled.
Constant Value: "imsi_key_availability_int"
KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY
public static final String KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS reference signal received power (SSRSRP) thresholds.
Reference: 3GPP TS 38.215
4 threshold integers must be within the boundaries [-140 dB, -44 dB], and the levels are:
- "NONE: [-140, threshold1)"
- "POOR: [threshold1, threshold2)"
- "MODERATE: [threshold2, threshold3)"
- "GOOD: [threshold3, threshold4)"
- "EXCELLENT: [threshold4, -44]"
This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "5g_nr_ssrsrp_thresholds_int_array"
KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY
public static final String KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS reference signal received quality (SSRSRQ) thresholds.
Reference: 3GPP TS 38.215; 3GPP TS 38.133 section 10
4 threshold integers must be within the boundaries [-43 dB, 20 dB], and the levels are:
- "NONE: [-43, threshold1)"
- "POOR: [threshold1, threshold2)"
- "MODERATE: [threshold2, threshold3)"
- "GOOD: [threshold3, threshold4)"
- "EXCELLENT: [threshold4, 20]"
This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "5g_nr_ssrsrq_thresholds_int_array"
KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY
public static final String KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY
List of 4 customized 5G SS signal-to-noise and interference ratio (SSSINR) thresholds.
Reference: 3GPP TS 38.215, 3GPP TS 38.133 10.1.16.1
4 threshold integers must be within the boundaries [-23 dB, 40 dB], and the levels are:
- "NONE: [-23, threshold1)"
- "POOR: [threshold1, threshold2)"
- "MODERATE: [threshold2, threshold3)"
- "GOOD: [threshold3, threshold4)"
- "EXCELLENT: [threshold4, 40]"
This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "5g_nr_sssinr_thresholds_int_array"
KEY_ADDITIONAL_CALL_SETTING_BOOL
public static final String KEY_ADDITIONAL_CALL_SETTING_BOOL
Does not display additional call setting for IMS phone based on GSM Phone
Constant Value: "additional_call_setting_bool"
KEY_ADDITIONAL_SETTINGS_CALLER_ID_VISIBILITY_BOOL
public static final String KEY_ADDITIONAL_SETTINGS_CALLER_ID_VISIBILITY_BOOL
Boolean indicating if the "Caller ID" item is visible in the Additional Settings menu. true means visible. false means gone. The default value is true.
Constant Value: "additional_settings_caller_id_visibility_bool"
KEY_ADDITIONAL_SETTINGS_CALL_WAITING_VISIBILITY_BOOL
public static final String KEY_ADDITIONAL_SETTINGS_CALL_WAITING_VISIBILITY_BOOL
Boolean indicating if the "Call Waiting" item is visible in the Additional Settings menu. true means visible. false means gone. The default value is true.
Constant Value: "additional_settings_call_waiting_visibility_bool"
KEY_ALLOW_ADDING_APNS_BOOL
public static final String KEY_ALLOW_ADDING_APNS_BOOL
Allow user to add APNs
Constant Value: "allow_adding_apns_bool"
KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL
public static final String KEY_ALLOW_ADD_CALL_DURING_VIDEO_CALL_BOOL
When true, indicates that adding a call is disabled when there is an ongoing video call or when there is an ongoing call on wifi which was downgraded from video and VoWifi is turned off.
Constant Value: "allow_add_call_during_video_call"
KEY_ALLOW_EMERGENCY_NUMBERS_IN_CALL_LOG_BOOL
public static final 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
public static final 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_HOLD_CALL_DURING_EMERGENCY_BOOL
public static final String KEY_ALLOW_HOLD_CALL_DURING_EMERGENCY_BOOL
Flag indicating whether or not an ongoing call will be held when an outgoing emergency call is placed. If true, ongoing calls will be put on hold when an emergency call is placed. If false, placing an emergency call will trigger the disconnect of all ongoing calls before the emergency call is placed.
Constant Value: "allow_hold_call_during_emergency_bool"
KEY_ALLOW_HOLD_VIDEO_CALL_BOOL
public static final String KEY_ALLOW_HOLD_VIDEO_CALL_BOOL
When true
, indicates that video calls can be put on hold in order to swap to another
call (e.g. a new outgoing call).
When false
, indicates that video calls will be disconnected when swapping to another
call.
This is true
by default.
Constant Value: "allow_hold_video_call_bool"
KEY_ALLOW_LOCAL_DTMF_TONES_BOOL
public static final 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_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL
public static final String KEY_ALLOW_MERGE_WIFI_CALLS_WHEN_VOWIFI_OFF_BOOL
Flag indicating whether the carrier supports merging wifi calls when VoWIFI is disabled. This can happen in the case of a carrier which allows offloading video calls to WIFI separately of whether voice over wifi is enabled. In such a scenario when two video calls are downgraded to voice, they remain over wifi. However, if VoWIFI is disabled, these calls cannot be merged.
Constant Value: "allow_merge_wifi_calls_when_vowifi_off_bool"
KEY_ALLOW_NON_EMERGENCY_CALLS_IN_ECM_BOOL
public static final 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_ALLOW_VIDEO_CALLING_FALLBACK_BOOL
public static final String KEY_ALLOW_VIDEO_CALLING_FALLBACK_BOOL
Whether system apps are allowed to use fallback if carrier video call is not available.
Defaults to true
.
Constant Value: "allow_video_calling_fallback_bool"
KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL
public static final String KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL
Boolean indicating if show data RAT icon on status bar even when data is disabled.
Constant Value: "always_show_data_rat_icon_bool"
KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL
public static final String KEY_ALWAYS_SHOW_EMERGENCY_ALERT_ONOFF_BOOL
This constant was deprecated
in API level 30.
The allow alerts option is always shown now. No longer need a config for that.
The default flag specifying whether "Allow alerts" option will be always shown in emergency alerts settings regardless developer options is turned on or not.
Constant Value: "always_show_emergency_alert_onoff_bool"
KEY_ALWAYS_SHOW_PRIMARY_SIGNAL_BAR_IN_OPPORTUNISTIC_NETWORK_BOOLEAN
public static final String KEY_ALWAYS_SHOW_PRIMARY_SIGNAL_BAR_IN_OPPORTUNISTIC_NETWORK_BOOLEAN
Indicates when a carrier has a primary subscription and an opportunistic subscription active, and when Internet data is switched to opportunistic network, whether to still show signal bar of primary network. By default it will be false, meaning whenever data is going over opportunistic network, signal bar will reflect signal strength and rat icon of that network.
Constant Value: "always_show_primary_signal_bar_in_opportunistic_network_boolean"
KEY_APN_EXPAND_BOOL
public static final String KEY_APN_EXPAND_BOOL
Control whether users can edit APNs in Settings.
Constant Value: "apn_expand_bool"
KEY_APN_SETTINGS_DEFAULT_APN_TYPES_STRING_ARRAY
public static final String KEY_APN_SETTINGS_DEFAULT_APN_TYPES_STRING_ARRAY
Default value of APN types field if not specified by user when adding/modifying an APN.
Constant Value: "apn_settings_default_apn_types_string_array"
KEY_AUTO_RETRY_ENABLED_BOOL
public static final String KEY_AUTO_RETRY_ENABLED_BOOL
Flag indicating if auto retry is enabled
Constant Value: "auto_retry_enabled_bool"
KEY_CALL_BARRING_DEFAULT_SERVICE_CLASS_INT
public static final String KEY_CALL_BARRING_DEFAULT_SERVICE_CLASS_INT
Specifies the service class for call barring service. Default value is
SERVICE_CLASS_VOICE
.
The value set as below:
Constant Value: "call_barring_default_service_class_int"
KEY_CALL_BARRING_SUPPORTS_DEACTIVATE_ALL_BOOL
public static final String KEY_CALL_BARRING_SUPPORTS_DEACTIVATE_ALL_BOOL
Flag indicating whether or not deactivating all call barring features via the "Call Barring" settings menu is supported. If true, the option will be visible in the "Call Barring" settings menu. If false, the option will not be visible. Enabled by default.
Constant Value: "call_barring_supports_deactivate_all_bool"
KEY_CALL_BARRING_SUPPORTS_PASSWORD_CHANGE_BOOL
public static final String KEY_CALL_BARRING_SUPPORTS_PASSWORD_CHANGE_BOOL
Flag indicating whether or not changing the call barring password via the "Call Barring" settings menu is supported. If true, the option will be visible in the "Call Barring" settings menu. If false, the option will not be visible. Enabled by default.
Constant Value: "call_barring_supports_password_change_bool"
KEY_CALL_BARRING_VISIBILITY_BOOL
public static final String KEY_CALL_BARRING_VISIBILITY_BOOL
Boolean indicating if the "Call barring" item is visible in the Call Settings menu. If true, the "Call Barring" menu will be visible. If false, the menu will be gone. Disabled by default.
Constant Value: "call_barring_visibility_bool"
KEY_CALL_COMPOSER_PICTURE_SERVER_URL_STRING
public static final String KEY_CALL_COMPOSER_PICTURE_SERVER_URL_STRING
Indicates the carrier server url that serves the call composer picture.
Constant Value: "call_composer_picture_server_url_string"
KEY_CALL_FORWARDING_BLOCKS_WHILE_ROAMING_STRING_ARRAY
public static final String KEY_CALL_FORWARDING_BLOCKS_WHILE_ROAMING_STRING_ARRAY
An array containing custom call forwarding number prefixes that will be blocked while the
device is reporting that it is roaming. By default, there are no custom call
forwarding prefixes and none of these numbers will be filtered. If one or more entries are
present, the system will not complete the call and display an error message.
To display a message to the user when call forwarding fails for 3gpp MMI codes while roaming,
use the KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL
option instead.
Constant Value: "call_forwarding_blocks_while_roaming_string_array"
KEY_CALL_REDIRECTION_SERVICE_COMPONENT_NAME_STRING
public static final String KEY_CALL_REDIRECTION_SERVICE_COMPONENT_NAME_STRING
Specifies a carrier-defined CallRedirectionService
which Telecom
will bind to for outgoing calls. An empty string indicates that no carrier-defined
CallRedirectionService
is specified.
Constant Value: "call_redirection_service_component_name_string"
KEY_CAPABILITIES_EXEMPT_FROM_SINGLE_DC_CHECK_INT_ARRAY
public static final String KEY_CAPABILITIES_EXEMPT_FROM_SINGLE_DC_CHECK_INT_ARRAY
Only apply if KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY
specifies the network types that
support a single data connection at a time. This key defines a list of network capabilities
which, if requested, will exempt the request from single data connection checks.
See also:
Constant Value: "capabilities_exempt_from_single_dc_check_int_array"
KEY_CARRIER_ALLOW_DEFLECT_IMS_CALL_BOOL
public static final String KEY_CARRIER_ALLOW_DEFLECT_IMS_CALL_BOOL
Flag indicating whether the carrier supports call deflection for an incoming IMS call.
Constant Value: "carrier_allow_deflect_ims_call_bool"
KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL
public static final 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_APP_REQUIRED_DURING_SIM_SETUP_BOOL
public static final String KEY_CARRIER_APP_REQUIRED_DURING_SIM_SETUP_BOOL
Determines whether the carrier app needed to be involved when users try to finish setting up the SIM card to get network service.
Constant Value: "carrier_app_required_during_setup_bool"
KEY_CARRIER_CALL_SCREENING_APP_STRING
public static final String KEY_CARRIER_CALL_SCREENING_APP_STRING
The Component Name of a carrier-provided CallScreeningService implementation. Telecom will
bind to CallScreeningService
for ALL incoming calls and provide
the carrier
CallScreeningService with the opportunity to allow or block calls.
The String includes the package name/the class name.
Example:
Using ComponentName#flattenToString()
to convert a ComponentName object to String.
Using ComponentName#unflattenFromString(String)
to convert a String object to a
ComponentName.
Constant Value: "call_screening_app"
KEY_CARRIER_CERTIFICATE_STRING_ARRAY
public static final String KEY_CARRIER_CERTIFICATE_STRING_ARRAY
Holds the list of carrier certificate hashes, followed by optional package names. Format: "sha1/256" or "sha1/256:package1,package2,package3..." Note that each carrier has its own hashes.
Constant Value: "carrier_certificate_string_array"
KEY_CARRIER_CONFIG_APPLIED_BOOL
public static final String KEY_CARRIER_CONFIG_APPLIED_BOOL
Determines whether any carrier has been identified and its specific config has been applied, default to false.
Constant Value: "carrier_config_applied_bool"
KEY_CARRIER_CONFIG_VERSION_STRING
public static final String KEY_CARRIER_CONFIG_VERSION_STRING
Specifies a value that identifies the version of the carrier configuration that is currently in use. This string is displayed on the UI. The format of the string is not specified.
Constant Value: "carrier_config_version_string"
KEY_CARRIER_CROSS_SIM_IMS_AVAILABLE_BOOL
public static final String KEY_CARRIER_CROSS_SIM_IMS_AVAILABLE_BOOL
Flag specifying whether Cross SIM over IMS should be available for carrier.
When false
the carrier does not support cross SIM calling.
When true
the carrier does support cross sim calling, where available
Constant Value: "carrier_cross_sim_ims_available_bool"
KEY_CARRIER_DATA_CALL_PERMANENT_FAILURE_STRINGS
public static final String KEY_CARRIER_DATA_CALL_PERMANENT_FAILURE_STRINGS
This constant was deprecated
in API level 34.
This API key was added in mistake and is not used anymore by the telephony data
frameworks.
Data call setup permanent failure causes by the carrier.
Constant Value: "carrier_data_call_permanent_failure_strings"
KEY_CARRIER_DEFAULT_ACTIONS_ON_DCFAILURE_STRING_ARRAY
public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_DCFAILURE_STRING_ARRAY
Defines carrier-specific actions which act upon CARRIER_SIGNAL_REQUEST_NETWORK_FAILED
and configured signal args:
android.telephony.TelephonyManager#EXTRA_APN_TYPE,
android.telephony.TelephonyManager#EXTRA_ERROR_CODE
used for customization of the default carrier app
Format:
{
"APN_1, ERROR_CODE_1 : CARRIER_ACTION_IDX_1, CARRIER_ACTION_IDX_2...",
"APN_1, ERROR_CODE_2 : CARRIER_ACTION_IDX_1 "
}
Where APN_1
is an integer defined in ApnSetting
(e.g. ApnSetting.TYPE_DEFAULT
ERROR_CODE_1
is an integer defined in android.telephony.DataFailCause
Example:
android.telephony.DataFailCause#MISSING_UNKNOWN_APN
CARRIER_ACTION_IDX_1
is an integer defined in
com.android.carrierdefaultapp.CarrierActionUtils
Example:
com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_DISABLE_METERED_APNS
disables metered APNs
Constant Value: "carrier_default_actions_on_dcfailure_string_array"
KEY_CARRIER_DEFAULT_ACTIONS_ON_DEFAULT_NETWORK_AVAILABLE
public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_DEFAULT_NETWORK_AVAILABLE
Defines carrier-specific actions which act upon
com.android.internal.telephony.CARRIER_SIGNAL_DEFAULT_NETWORK_AVAILABLE,
used for customization of the default carrier app.
Format:
{
"true : CARRIER_ACTION_IDX_1",
"false: CARRIER_ACTION_IDX_2"
}
Where true
is a boolean indicates default network available/unavailable
Where CARRIER_ACTION_IDX
is an integer defined in
com.android.carrierdefaultapp.CarrierActionUtils CarrierActionUtils
Example:
com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_ENABLE_DEFAULT_URL_HANDLER
enables the app as the default URL handler
Constant Value: "carrier_default_actions_on_default_network_available_string_array"
KEY_CARRIER_DEFAULT_ACTIONS_ON_REDIRECTION_STRING_ARRAY
public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_REDIRECTION_STRING_ARRAY
Defines carrier-specific actions which act upon
com.android.internal.telephony.CARRIER_SIGNAL_REDIRECTED, used for customization of the
default carrier app.
Format: "CARRIER_ACTION_IDX, ..."
Where CARRIER_ACTION_IDX
is an integer defined in
com.android.carrierdefaultapp.CarrierActionUtils
Example:
com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_DISABLE_METERED_APNS
disables metered APNs
Constant Value: "carrier_default_actions_on_redirection_string_array"
KEY_CARRIER_DEFAULT_ACTIONS_ON_RESET
public static final String KEY_CARRIER_DEFAULT_ACTIONS_ON_RESET
Defines carrier-specific actions which act upon CARRIER_SIGNAL_RESET,
used for customization of the default carrier app.
Format: "CARRIER_ACTION_IDX, ..."
Where CARRIER_ACTION_IDX
is an integer defined in
com.android.carrierdefaultapp.CarrierActionUtils
Example:
com.android.carrierdefaultapp.CarrierActionUtils#CARRIER_ACTION_CANCEL_ALL_NOTIFICATIONS
clears all notifications on reset
Constant Value: "carrier_default_actions_on_reset_string_array"
KEY_CARRIER_DEFAULT_REDIRECTION_URL_STRING_ARRAY
public static final String KEY_CARRIER_DEFAULT_REDIRECTION_URL_STRING_ARRAY
Defines a list of acceptable redirection url for default carrier app.
Constant Value: "carrier_default_redirection_url_string_array"
KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL
public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL
Default WFC_IMS_enabled: true VoWiFi by default is on false VoWiFi by default is off
Constant Value: "carrier_default_wfc_ims_enabled_bool"
KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
public static final String KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
Default mode for WFC over IMS on home network:
- 0: Wi-Fi only
- 1: prefer mobile network
- 2: prefer Wi-Fi
Constant Value: "carrier_default_wfc_ims_mode_int"
KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT
public static final String KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT
Default mode for WFC over IMS on roaming network.
See KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
for meaning of values.
Constant Value: "carrier_default_wfc_ims_roaming_mode_int"
KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL
public static final String KEY_CARRIER_FORCE_DISABLE_ETWS_CMAS_TEST_BOOL
This constant was deprecated
in API level 30.
Use com.android.cellbroadcastreceiver.CellBroadcastReceiver
resource
show_test_settings
to control whether to show test alert settings or not.
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
public static final 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
public static final 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
public static final 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 byte. 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
public static final 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
public static final 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 String#matches(String)
.
Constant Value: "carrier_instant_lettering_invalid_chars_string"
KEY_CARRIER_INSTANT_LETTERING_LENGTH_LIMIT_INT
public static final 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_METERED_APN_TYPES_STRINGS
public static final String KEY_CARRIER_METERED_APN_TYPES_STRINGS
A string array indicating the default APN types that are metered by the carrier.
The string in the array is the name of the APN type. For example, "default" for
ApnSetting#TYPE_DEFAULT
, "mms" for ApnSetting#TYPE_MMS
, etc.
The default value is {"default", "mms", "dun", "supl"}
.
See also:
ApnSetting.TYPE_DEFAULT
ApnSetting.TYPE_MMS
ApnSetting.TYPE_SUPL
ApnSetting.TYPE_DUN
ApnSetting.TYPE_HIPRI
ApnSetting.TYPE_FOTA
ApnSetting.TYPE_IMS
ApnSetting.TYPE_CBS
ApnSetting.TYPE_IA
ApnSetting.TYPE_EMERGENCY
ApnSetting.TYPE_MCX
ApnSetting.TYPE_XCAP
ApnSetting.TYPE_BIP
ApnSetting.TYPE_VSIM
ApnSetting.TYPE_ENTERPRISE
Constant Value: "carrier_metered_apn_types_strings"
KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS
public static final String KEY_CARRIER_METERED_ROAMING_APN_TYPES_STRINGS
A string array indicating the default APN types that are roaming-metered by the carrier.
The string in the array is the name of the APN type. For example, "default" for
ApnSetting#TYPE_DEFAULT
, "mms" for ApnSetting#TYPE_MMS
, etc.
The default value is {"default", "mms", "dun", "supl"}
.
See also:
ApnSetting.TYPE_DEFAULT
ApnSetting.TYPE_MMS
ApnSetting.TYPE_SUPL
ApnSetting.TYPE_DUN
ApnSetting.TYPE_HIPRI
ApnSetting.TYPE_FOTA
ApnSetting.TYPE_IMS
ApnSetting.TYPE_CBS
ApnSetting.TYPE_IA
ApnSetting.TYPE_EMERGENCY
ApnSetting.TYPE_MCX
ApnSetting.TYPE_XCAP
ApnSetting.TYPE_BIP
ApnSetting.TYPE_VSIM
ApnSetting.TYPE_ENTERPRISE
Constant Value: "carrier_metered_roaming_apn_types_strings"
KEY_CARRIER_NAME_OVERRIDE_BOOL
public static final String KEY_CARRIER_NAME_OVERRIDE_BOOL
Unconditionally override the carrier name string using #KEY_CARRIER_NAME_STRING. If true, then the carrier name string will be #KEY_CARRIER_NAME_STRING, unconditionally.
If false, then the override will be performed conditionally and the #KEY_CARRIER_NAME_STRING will have the lowest-precedence; it will only be used in the event that the name string would otherwise be empty, allowing it to serve as a last-resort. If used, this value functions in place of the SPN on any/all ICC records for the corresponding subscription.
Constant Value: "carrier_name_override_bool"
KEY_CARRIER_NAME_STRING
public static final String KEY_CARRIER_NAME_STRING
String to identify carrier name in CarrierConfig app. This string overrides SPN if #KEY_CARRIER_NAME_OVERRIDE_BOOL is true; otherwise, it will be used if its value is provided and SPN is unavailable
Constant Value: "carrier_name_string"
KEY_CARRIER_NR_AVAILABILITIES_INT_ARRAY
public static final String KEY_CARRIER_NR_AVAILABILITIES_INT_ARRAY
A list of carrier nr availability is used to determine whether the carrier enable the non-standalone (NSA) mode of 5G NR, standalone (SA) mode of 5G NR
The value of list is
CARRIER_NR_AVAILABILITY_NSA
, or CARRIER_NR_AVAILABILITY_SA
.
For example, if both NSA and SA are used, the list value is {
CARRIER_NR_AVAILABILITY_NSA
,CARRIER_NR_AVAILABILITY_SA
}.
If the carrier doesn't support 5G NR, the value is the empty array.
If the key is invalid or not configured, the default value {
CARRIER_NR_AVAILABILITY_NSA
,CARRIER_NR_AVAILABILITY_SA
} will apply.
Constant Value: "carrier_nr_availabilities_int_array"
KEY_CARRIER_PROVISIONS_WIFI_MERGED_NETWORKS_BOOL
public static final String KEY_CARRIER_PROVISIONS_WIFI_MERGED_NETWORKS_BOOL
Indicates whether or not the carrier will provision merged carrier Wi-Fi offload networks. Such networks are considered part of the core carrier network. This configuration will be use to gate whether such configurations are allowed to the carrier and correspondingly enable UI elements which are required for such configurations.
Constant Value: "carrier_provisions_wifi_merged_networks_bool"
KEY_CARRIER_RCS_PROVISIONING_REQUIRED_BOOL
public static final String KEY_CARRIER_RCS_PROVISIONING_REQUIRED_BOOL
Flag specifying whether provisioning is required for RCS.
Constant Value: "carrier_rcs_provisioning_required_bool"
KEY_CARRIER_SERVICE_NAME_STRING_ARRAY
public static final String KEY_CARRIER_SERVICE_NAME_STRING_ARRAY
String array containing the list of names for service numbers provided by carriers. This key
should be used with KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
. The names provided in
this array will be mapped 1:1 with the numbers provided in the KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
array.
The data would be considered valid if and only if:
- The number of items in both the arrays are equal
- The data added to the
KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
array is valid. SeeKEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
for more information.
Example:
<string-array name="carrier_service_name_array" num="2">
<item value="Police"/>
<item value="Ambulance"/>
</string-array>
Constant Value: "carrier_service_name_array"
KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
public static final String KEY_CARRIER_SERVICE_NUMBER_STRING_ARRAY
String array containing the list of service numbers provided by carriers. This key should be
used with KEY_CARRIER_SERVICE_NAME_STRING_ARRAY
. The numbers provided in this array
will be mapped 1:1 with the names provided in the KEY_CARRIER_SERVICE_NAME_STRING_ARRAY
array.
The data would be considered valid if and only if:
- The number of items in both the arrays are equal
- The item should contain dialable characters only which includes 0-9, -, *, #, (, ), SPACE.
Example:
<string-array name="carrier_service_number_array" num="2">
<item value="*123"/>
<item value="+ (111) 111-111"/>
</string-array>
Constant Value: "carrier_service_number_array"
KEY_CARRIER_SETTINGS_ACTIVITY_COMPONENT_NAME_STRING
public static final String KEY_CARRIER_SETTINGS_ACTIVITY_COMPONENT_NAME_STRING
Flatten ComponentName
of the carrier's settings activity.
Constant Value: "carrier_settings_activity_component_name_string"
KEY_CARRIER_SETTINGS_ENABLE_BOOL
public static final String KEY_CARRIER_SETTINGS_ENABLE_BOOL
Display carrier settings menu if true
Constant Value: "carrier_settings_enable_bool"
KEY_CARRIER_SUPPORTED_SATELLITE_SERVICES_PER_PROVIDER_BUNDLE
public static final String KEY_CARRIER_SUPPORTED_SATELLITE_SERVICES_PER_PROVIDER_BUNDLE
A PersistableBundle that contains a list of key-value pairs, where the values are integer arrays.
Keys are the PLMNs of satellite providers as strings and values are integer arrays of supported services with the following value:
- 1 =
NetworkRegistrationInfo.SERVICE_TYPE_VOICE
- 2 =
NetworkRegistrationInfo.SERVICE_TYPE_DATA
- 3 =
NetworkRegistrationInfo.SERVICE_TYPE_SMS
- 4 =
NetworkRegistrationInfo.SERVICE_TYPE_VIDEO
- 5 =
NetworkRegistrationInfo.SERVICE_TYPE_EMERGENCY
- 6 =
NetworkRegistrationInfo.SERVICE_TYPE_MMS
An example config for two PLMNs "123411" and "123412":
<carrier_config>
<pbundle_as_map name="carrier_supported_satellite_services_per_provider_bundle">
<int-array name = "123411" num = "2">
<item value = "3"/>
<item value = "5"/>
</int-array>
<int-array name = "123412" num = "1">
<item value = "3"/>
</int-array>
</pbundle_as_map>
</carrier_config>
This config is empty by default.
Constant Value: "carrier_supported_satellite_services_per_provider_bundle"
KEY_CARRIER_SUPPORTS_OPP_DATA_AUTO_PROVISIONING_BOOL
public static final String KEY_CARRIER_SUPPORTS_OPP_DATA_AUTO_PROVISIONING_BOOL
Configuration to indicate that the carrier supports opportunistic data auto provisioning. Based on this flag, the device downloads and activates corresponding opportunistic profile.
Constant Value: "carrier_supports_opp_data_auto_provisioning_bool"
KEY_CARRIER_SUPPORTS_SS_OVER_UT_BOOL
public static final String KEY_CARRIER_SUPPORTS_SS_OVER_UT_BOOL
Flag indicating whether or not the carrier supports Supplementary Services over the UT
interface for this subscription.
If true, the device will use Supplementary Services over UT when provisioned (see
KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL
). If false, this device will fallback to
circuit switch for supplementary services and will disable this capability for IMS entirely.
The default value for this key is false
.
Constant Value: "carrier_supports_ss_over_ut_bool"
KEY_CARRIER_SUPPORTS_TETHERING_BOOL
public static final String KEY_CARRIER_SUPPORTS_TETHERING_BOOL
Flag indicating if the carrier supports tethering of mobile data.
Constant Value: "carrier_supports_tethering_bool"
KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL
public static final String KEY_CARRIER_USE_IMS_FIRST_FOR_EMERGENCY_BOOL
Flag specifying whether IMS should be the first phone attempted for E911 even if the phone is not in service.
Constant Value: "carrier_use_ims_first_for_emergency_bool"
KEY_CARRIER_USSD_METHOD_INT
public static final String KEY_CARRIER_USSD_METHOD_INT
Specify the method of selection for UE sending USSD requests. The default value is
USSD_OVER_CS_PREFERRED
.
Available options:
Constant Value: "carrier_ussd_method_int"
KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL
public static final String KEY_CARRIER_UT_PROVISIONING_REQUIRED_BOOL
This constant was deprecated
in API level 33.
Use Ims#KEY_MMTEL_REQUIRES_PROVISIONING_BUNDLE
instead for
determining if UT requires provisioning.
Flag indicating whether or not the IMS MmTel UT capability requires carrier provisioning
before it can be set as enabled.
If true, the UT capability will be set to false for the newly loaded subscription
and will require the carrier provisioning app to set the persistent provisioning result.
If false, the platform will not wait for provisioning status updates for the UT capability
and enable the UT over IMS capability for the subscription when the subscription is loaded.
The default value for this key is false
.
Constant Value: "carrier_ut_provisioning_required_bool"
KEY_CARRIER_VOLTE_AVAILABLE_BOOL
public static final 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_OVERRIDE_WFC_PROVISIONING_BOOL
public static final String KEY_CARRIER_VOLTE_OVERRIDE_WFC_PROVISIONING_BOOL
Flag specifying if WFC provisioning depends on VoLTE provisioning.
false
: default value; honor actual WFC provisioning state.
true
: when VoLTE is not provisioned, treat WFC as not provisioned; when VoLTE is
provisioned, honor actual WFC provisioning state.
As of now, Verizon is the only carrier enforcing this dependency in their
WFC awareness and activation requirements.
Constant Value: "carrier_volte_override_wfc_provisioning_bool"
KEY_CARRIER_VOLTE_PROVISIONED_BOOL
public static final String KEY_CARRIER_VOLTE_PROVISIONED_BOOL
This constant was deprecated
in API level 33.
Use Ims#KEY_CARRIER_RCS_PROVISIONING_REQUIRED_BOOL
instead.
This flag specifies whether VoLTE availability is based on provisioning. By default this is false. Used for UCE to determine if EAB provisioning checks should be based on provisioning.
Constant Value: "carrier_volte_provisioned_bool"
KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
public static final String KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL
This constant was deprecated
in API level 33.
Use Ims#KEY_MMTEL_REQUIRES_PROVISIONING_BUNDLE
instead for
finer-grained control.
changing carrier_volte_provisioning_required_bool requires changes to
mmtel_requires_provisioning_bundle and vice versa
Ims#KEY_MMTEL_REQUIRES_PROVISIONING_BUNDLE
Flag specifying whether provisioning is required for VoLTE, Video Telephony, and WiFi Calling. Combines VoLTE, VT, VoWiFI calling provisioning into one parameter.
Constant Value: "carrier_volte_provisioning_required_bool"
KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
public static final 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
public static final 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
public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING
This constant was deprecated
in API level 26.
use KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY
.
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_VVM_PACKAGE_NAME_STRING_ARRAY
public static final String KEY_CARRIER_VVM_PACKAGE_NAME_STRING_ARRAY
A list of the carrier's visual voicemail app package names to ensure that dialer visual voicemail and carrier visual voicemail are not active at the same time.
Constant Value: "carrier_vvm_package_name_string_array"
KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL
public static final 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
public static final 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_3WAYCALL_FLASH_DELAY_INT
public static final String KEY_CDMA_3WAYCALL_FLASH_DELAY_INT
For carriers which require an empty flash to be sent before sending the normal 3-way calling
flash, the duration in milliseconds of the empty flash to send. When 0
, no empty
flash is sent.
Constant Value: "cdma_3waycall_flash_delay_int"
KEY_CDMA_DTMF_TONE_DELAY_INT
public static final 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
public static final 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_MODE_INT
public static final String KEY_CDMA_ROAMING_MODE_INT
The CDMA roaming mode (aka CDMA system select).
The value should be one of the CDMA_ROAMING_MODE_ constants in TelephonyManager
.
Values other than TelephonyManager#CDMA_ROAMING_MODE_RADIO_DEFAULT
(which is the
default) will take precedence over user selection.
See also:
Constant Value: "cdma_roaming_mode_int"
KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY
public static final 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_CELLULAR_SERVICE_CAPABILITIES_INT_ARRAY
public static final String KEY_CELLULAR_SERVICE_CAPABILITIES_INT_ARRAY
An array of cellular services supported by a subscription.
Permissible values include:
SubscriptionManager#SERVICE_CAPABILITY_VOICE
for voice servicesSubscriptionManager#SERVICE_CAPABILITY_SMS
for SMS servicesSubscriptionManager#SERVICE_CAPABILITY_DATA
for data services
Carrier-specific factors may influence how these services are supported. Therefore, modifying this carrier configuration might not always enable the specified services. These capability bitmasks should be considered as indicators of a carrier's preferred services to enhance user experience, rather than as absolute platform guarantees.
Device-level service capabilities, defined by
TelephonyManager#isDeviceVoiceCapable
and
TelephonyManager#isDeviceSmsCapable
, take precedence over these subscription-level
settings. For instance, a device where TelephonyManager#isDeviceVoiceCapable
returns
false may not be able to make voice calls, even if subscribed to a service marked as
voice-capable.
To determine a subscription's cellular service capabilities, use
SubscriptionInfo#getServiceCapabilities()
. To track changes in services, register
a SubscriptionManager.OnSubscriptionsChangedListener
and invoke the
same method in its callback.
Emergency service availability may not depend on the cellular service capabilities.
For example, emergency calls might be possible on a subscription even if it lacks
SubscriptionManager#SERVICE_CAPABILITY_VOICE
.
If unset, the default value is \u201c[1, 2, 3]\u201d (supports all cellular services).
See also:
Constant Value: "cellular_service_capabilities_int_array"
KEY_CELLULAR_USAGE_SETTING_INT
public static final String KEY_CELLULAR_USAGE_SETTING_INT
Controls the cellular usage setting. The usage setting indicates whether a device will remain attached to a network based on the primary use case for the service. A device will detach and search for a more-preferred network if the primary use case (voice or data) is not satisfied. Depending on the type of device, it may operate in a voice or data-centric mode by default.
Sets the usage setting in accordance with 3gpp 24.301 sec 4.3 and 3gpp 24.501 sec 4.3.
Also refer to "UE's usage setting" as defined in 3gpp 24.301 section 3.1 and 3gpp 23.221
Annex A.
Either omit this key or pass a value of
unknown
to preserve the current setting.
Devices that support configuration of the cellular usage setting, including devices
with HAL capability to set the cellular usage setting, must honor this setting accordingly.
default
,
voice-centric
,
or data-centric
.
See also:
Constant Value: "cellular_usage_setting_int"
KEY_CHECK_PRICING_WITH_CARRIER_FOR_DATA_ROAMING_BOOL
public static final String KEY_CHECK_PRICING_WITH_CARRIER_FOR_DATA_ROAMING_BOOL
Determines whether we should show a warning asking the user to check with their carrier on pricing when the user enabled data roaming, default to false.
Constant Value: "check_pricing_with_carrier_data_roaming_bool"
KEY_CI_ACTION_ON_SYS_UPDATE_BOOL
public static final 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
public static final 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
public static final 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
public static final 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_CONFIG_IMS_MMTEL_PACKAGE_OVERRIDE_STRING
public static final String KEY_CONFIG_IMS_MMTEL_PACKAGE_OVERRIDE_STRING
The package name containing the ImsService that will be bound to the telephony framework to support IMS MMTEL feature functionality instead of the device default ImsService for this subscription.
Constant Value: "config_ims_mmtel_package_override_string"
KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING
public static final String KEY_CONFIG_IMS_PACKAGE_OVERRIDE_STRING
This constant was deprecated
in API level 30.
Use KEY_CONFIG_IMS_MMTEL_PACKAGE_OVERRIDE_STRING
and
KEY_CONFIG_IMS_RCS_PACKAGE_OVERRIDE_STRING
instead to configure these values
separately. If any of those values are not empty, they will override this value.
The package name containing the ImsService that will be bound to the telephony framework to support both IMS MMTEL and RCS feature functionality instead of the device default ImsService for this subscription.
Constant Value: "config_ims_package_override_string"
KEY_CONFIG_IMS_RCS_PACKAGE_OVERRIDE_STRING
public static final String KEY_CONFIG_IMS_RCS_PACKAGE_OVERRIDE_STRING
The package name containing the ImsService that will be bound to the telephony framework to support IMS RCS feature functionality instead of the device default ImsService for this subscription.
Constant Value: "config_ims_rcs_package_override_string"
KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING
public static final String KEY_CONFIG_PLANS_PACKAGE_OVERRIDE_STRING
Override the package that will manage SubscriptionPlan
information instead of the CarrierService
that defines this
value.
See also:
Constant Value: "config_plans_package_override_string"
KEY_CONFIG_TELEPHONY_USE_OWN_NUMBER_FOR_VOICEMAIL_BOOL
public static final String KEY_CONFIG_TELEPHONY_USE_OWN_NUMBER_FOR_VOICEMAIL_BOOL
Flag that specifies to use the user's own phone number as the voicemail number when there is no pre-loaded voicemail number on the SIM card.
KEY_DEFAULT_VM_NUMBER_STRING
takes precedence over this flag.
If false, the system default (*86) will be used instead.
Constant Value: "config_telephony_use_own_number_for_voicemail_bool"
KEY_CONFIG_WIFI_DISABLE_IN_ECBM
public static final String KEY_CONFIG_WIFI_DISABLE_IN_ECBM
Flag to indicate if Wi-Fi needs to be disabled in ECBM.
Constant Value: "config_wifi_disable_in_ecbm"
KEY_CROSS_SIM_SPN_FORMAT_INT
public static final String KEY_CROSS_SIM_SPN_FORMAT_INT
Indexes of SPN format strings in crossSimSpnFormats.
Available options are:
-
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_ONLY
: %s -
CROSS_SIM_SPN_FORMAT_CARRIER_NAME_WITH_BRANDING
: %s Cross-SIM Calling
Constant Value: "cross_sim_spn_format_int"
KEY_CSP_ENABLED_BOOL
public static final 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_DATA_LIMIT_NOTIFICATION_BOOL
public static final String KEY_DATA_LIMIT_NOTIFICATION_BOOL
Controls if the device should automatically notify the user as they reach
their cellular data limit. When set to false
the carrier is
expected to have implemented their own notification mechanism. true
by default.
Constant Value: "data_limit_notification_bool"
KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG
public static final String KEY_DATA_LIMIT_THRESHOLD_BYTES_LONG
Controls the cellular data limit.
If the user uses more than this amount of data in their billing cycle, as defined by
KEY_MONTHLY_DATA_CYCLE_DAY_INT
, cellular data will be turned off by the user's
phone. If the value is set to DATA_CYCLE_THRESHOLD_DISABLED
, the data limit will be
disabled.
This setting may be overridden by explicit user choice. By default,
DATA_CYCLE_USE_PLATFORM_DEFAULT
will be used.
Constant Value: "data_limit_threshold_bytes_long"
KEY_DATA_RAPID_NOTIFICATION_BOOL
public static final String KEY_DATA_RAPID_NOTIFICATION_BOOL
Controls if the device should automatically notify the user when rapid
cellular data usage is observed. When set to false
the carrier is
expected to have implemented their own notification mechanism. true
by default.
Constant Value: "data_rapid_notification_bool"
KEY_DATA_SWITCH_VALIDATION_MIN_INTERVAL_MILLIS_LONG
public static final String KEY_DATA_SWITCH_VALIDATION_MIN_INTERVAL_MILLIS_LONG
Data switch validation minimal interval, in milliseconds. If a connection to the default (Internet) PDN for the current subscription is validated on a given operator within a given tracking area, re-validations to that matching operator will be skipped if they would occur within the specified interval. Instead, the connection will automatically considered validated. If the network was validated within the interval but the latest validation result was false, the validation will not be skipped. If not set or set to 0, validation will not be skipped. The valid range of value is between 0 millisecond and 24 hours, inclusive in both sides. The default value is 24 hours.
Constant Value: "data_switch_validation_min_gap_long"
KEY_DATA_SWITCH_VALIDATION_TIMEOUT_LONG
public static final String KEY_DATA_SWITCH_VALIDATION_TIMEOUT_LONG
Upon data switching between subscriptions within a carrier group, if switch depends on validation result, this value defines customized value of how long we wait for validation success before we fail and revoke the switch. Time out is in milliseconds.
Constant Value: "data_switch_validation_timeout_long"
KEY_DATA_WARNING_NOTIFICATION_BOOL
public static final String KEY_DATA_WARNING_NOTIFICATION_BOOL
Controls if the device should automatically notify the user as they reach
their cellular data warning. When set to false
the carrier is
expected to have implemented their own notification mechanism. true
by default.
Constant Value: "data_warning_notification_bool"
KEY_DATA_WARNING_THRESHOLD_BYTES_LONG
public static final String KEY_DATA_WARNING_THRESHOLD_BYTES_LONG
Controls the data usage warning.
If the user uses more than this amount of data in their billing cycle, as defined by
KEY_MONTHLY_DATA_CYCLE_DAY_INT
, the user will be alerted about the usage.
If the value is set to DATA_CYCLE_THRESHOLD_DISABLED
, the data usage warning will
be disabled.
This setting may be overridden by explicit user choice. By default,
DATA_CYCLE_USE_PLATFORM_DEFAULT
will be used.
Constant Value: "data_warning_threshold_bytes_long"
KEY_DEFAULT_SIM_CALL_MANAGER_STRING
public static final 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_DEFAULT_VM_NUMBER_ROAMING_AND_IMS_UNREGISTERED_STRING
public static final String KEY_DEFAULT_VM_NUMBER_ROAMING_AND_IMS_UNREGISTERED_STRING
Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default voicemail number while the device is both roaming and not registered for IMS. When empty string, no default voicemail number is specified for roaming network and unregistered state in IMS.
Constant Value: "default_vm_number_roaming_and_ims_unregistered_string"
KEY_DEFAULT_VM_NUMBER_STRING
public static final String KEY_DEFAULT_VM_NUMBER_STRING
Where there is no preloaded voicemail number on a SIM card, specifies the carrier's default voicemail number. When empty string, no default voicemail number is specified.
Constant Value: "default_vm_number_string"
KEY_DIAL_STRING_REPLACE_STRING_ARRAY
public static final String KEY_DIAL_STRING_REPLACE_STRING_ARRAY
Specifies a map from dialstrings to replacements for roaming network service numbers which cannot be replaced on the carrier side.
Individual entries have the format: [dialstring to replace]:[replacement]
Constant Value: "dial_string_replace_string_array"
KEY_DISABLE_CDMA_ACTIVATION_CODE_BOOL
public static final 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_DISABLE_CHARGE_INDICATION_BOOL
public static final String KEY_DISABLE_CHARGE_INDICATION_BOOL
The flag to disable the popup dialog which warns the user of data charges.
Constant Value: "disable_charge_indication_bool"
KEY_DISABLE_SUPPLEMENTARY_SERVICES_IN_AIRPLANE_MODE_BOOL
public static final String KEY_DISABLE_SUPPLEMENTARY_SERVICES_IN_AIRPLANE_MODE_BOOL
Boolean indicating the Supplementary Services(SS) is disable when airplane mode on in the
Call Settings menu.
true
: SS is disable when airplane mode on.
false
: SS is enable when airplane mode on.
The default value for this key is false
Constant Value: "disable_supplementary_services_in_airplane_mode_bool"
KEY_DISCONNECT_CAUSE_PLAY_BUSYTONE_INT_ARRAY
public static final String KEY_DISCONNECT_CAUSE_PLAY_BUSYTONE_INT_ARRAY
DisconnectCause array to play busy tone. Value should be array of
DisconnectCause
.
Constant Value: "disconnect_cause_play_busytone_int_array"
KEY_DISPLAY_CALL_STRENGTH_INDICATOR_BOOL
public static final String KEY_DISPLAY_CALL_STRENGTH_INDICATOR_BOOL
Determine whether or not to display a call strength indicator for this carrier in the System UI. Disabling the indication may be reasonable if the carrier's calling is not integrated into the Android telephony stack (e.g. it is OTT). true: Use telephony APIs to detect the current networking medium of calling and display a UI indication based on the current strength (e.g. signal level) of that medium. false: Do not display the call strength indicator.
Constant Value: "display_call_strength_indicator_bool"
KEY_DISPLAY_HD_AUDIO_PROPERTY_BOOL
public static final String KEY_DISPLAY_HD_AUDIO_PROPERTY_BOOL
Determines whether High Definition audio property is displayed in the dialer UI.
If false
, remove the HD audio property from the connection so that HD audio related
UI is not displayed. If true
, keep HD audio property as it is configured.
Constant Value: "display_hd_audio_property_bool"
KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL
public static final String KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL
When true
, if the user is in an ongoing video call over WIFI and answers an incoming
audio call, the video call will be disconnected before the audio call is answered. This is
in contrast to the usual expected behavior where a foreground video call would be put into
the background and held when an incoming audio call is answered.
Constant Value: "drop_video_call_when_answering_audio_call_bool"
KEY_DTMF_TYPE_ENABLED_BOOL
public static final 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
public static final 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 for below cases:
1) 0 <= VALUE <= 604800(one week): the value will be used as the duration directly.
2) VALUE > 604800(one week): will use the default value as duration instead.
3) VALUE < 0: block will be disabled forever until user re-enable block manually,
the suggested value to disable forever is -1.
See android.provider.BlockedNumberContract#notifyEmergencyContact(Context)
See android.provider.BlockedNumberContract#isBlocked(Context, String)
.
Constant Value: "duration_blocking_disabled_after_emergency_int"
KEY_EDITABLE_ENHANCED_4G_LTE_BOOL
public static final 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_EDITABLE_VOICEMAIL_NUMBER_BOOL
public static final String KEY_EDITABLE_VOICEMAIL_NUMBER_BOOL
Since the default voicemail number is empty, if a SIM card does not have a voicemail number available the user cannot use voicemail. This flag allows the user to edit the voicemail number in such cases, and is false by default.
Constant Value: "editable_voicemail_number_bool"
KEY_EDITABLE_VOICEMAIL_NUMBER_SETTING_BOOL
public static final String KEY_EDITABLE_VOICEMAIL_NUMBER_SETTING_BOOL
Determine whether user can edit voicemail number in Settings.
Constant Value: "editable_voicemail_number_setting_bool"
KEY_EDITABLE_WFC_MODE_BOOL
public static final String KEY_EDITABLE_WFC_MODE_BOOL
Determine whether user can switch Wi-Fi preferred or Cellular preferred in calling preference. Some operators support Wi-Fi Calling only, not VoLTE. They don't need "Cellular preferred" option. In this case, set uneditable attribute for preferred preference.
Constant Value: "editable_wfc_mode_bool"
KEY_EDITABLE_WFC_ROAMING_MODE_BOOL
public static final String KEY_EDITABLE_WFC_ROAMING_MODE_BOOL
Determine whether user can change Wi-Fi Calling preference in roaming.
false
- roaming preference cannot be changed by user independently. If
KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
is false,
KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_MODE_INT
is used as the default
value. If KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
is
true, roaming preference is the same as home preference and
KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
is used as the default value.
true
- roaming preference can be changed by user independently if
KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
is false. If
KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
is true, this
configuration is ignored and roaming preference cannot be changed.
Constant Value: "editable_wfc_roaming_mode_bool"
KEY_EMERGENCY_NOTIFICATION_DELAY_INT
public static final String KEY_EMERGENCY_NOTIFICATION_DELAY_INT
Time delay (in ms) after which we show the notification for emergency calls, while the device is registered over WFC. Default value is -1, which indicates that this notification is not pertinent for a particular carrier. We've added a delay to prevent false positives.
Constant Value: "emergency_notification_delay_int"
KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY
public static final String KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY
Indicates zero or more emergency number prefix(es), because some carrier requires if users dial an emergency number address with a specific prefix, the combination of the prefix and the address is also a valid emergency number to dial. For example, an emergency number prefix is 318, and the emergency number is 911. Both 318911 and 911 can be dialed by users for emergency call. An empty array of string indicates that current carrier does not have this requirement.
Constant Value: "emergency_number_prefix_string_array"
KEY_ENABLE_CROSS_SIM_CALLING_ON_OPPORTUNISTIC_DATA_BOOL
public static final String KEY_ENABLE_CROSS_SIM_CALLING_ON_OPPORTUNISTIC_DATA_BOOL
Flag specifying whether cross sim calling on opportunistic data is supported for carrier.
When false
the carrier does not support cross sim calling on opportunistic data.
When true
the carrier does support cross sim calling on opportunistic data.
Constant Value: "enable_cross_sim_calling_on_opportunistic_data_bool"
KEY_ENABLE_DIALER_KEY_VIBRATION_BOOL
public static final 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_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL
public static final String KEY_ENHANCED_4G_LTE_ON_BY_DEFAULT_BOOL
Sets the default state for the "Enhanced 4G LTE" or "Advanced Calling" mode toggle set by the
user. When this is true
, this mode by default is on, otherwise if false
,
this mode by default is off.
Constant Value: "enhanced_4g_lte_on_by_default_bool"
KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT
public static final String KEY_ENHANCED_4G_LTE_TITLE_VARIANT_INT
The index indicates the carrier specified title string of Enhanced 4G LTE Mode settings. Default value is 0, which indicates the default title string.
Constant Value: "enhanced_4g_lte_title_variant_int"
KEY_ESIM_DOWNLOAD_RETRY_BACKOFF_TIMER_SEC_INT
public static final String KEY_ESIM_DOWNLOAD_RETRY_BACKOFF_TIMER_SEC_INT
This timer value is used in the eSIM Exponential Backoff download retry algorithm. Value should be in seconds.
- When the first download failure occurs, retry download after BACKOFF_TIMER_VALUE seconds.
- If download fails again then, retry after either BACKOFF_TIMER_VALUE, 2xBACKOFF_TIMER_VALUE, or 3xBACKOFF_TIMER_VALUE seconds.
- In general after the cth failed attempt, retry after k * BACKOFF_TIMER_VALUE
seconds, where k is a random integer between 1 and 2^c \u2212 1. Max c value is
KEY_ESIM_MAX_DOWNLOAD_RETRY_ATTEMPTS_INT
Constant Value: "esim_download_retry_backoff_timer_sec_int"
KEY_ESIM_MAX_DOWNLOAD_RETRY_ATTEMPTS_INT
public static final String KEY_ESIM_MAX_DOWNLOAD_RETRY_ATTEMPTS_INT
If eSIM profile download fails then, the number of retry attempts by UE will be based on this configuration. If download still fails even after the MAX attempts configured by this item then the retry is postponed until next device bootup.
Constant Value: "esim_max_download_retry_attempts_int"
KEY_FORCE_HOME_NETWORK_BOOL
public static final 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
public static final 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
public static final 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
public static final 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
public static final 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
public static final 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_ENHANCED_4G_LTE_BOOL
public static final String KEY_HIDE_ENHANCED_4G_LTE_BOOL
Determines whether the Enhanced 4G LTE toggle will be shown in the settings. When this
option is true
, the toggle will be hidden regardless of whether the device and
carrier supports 4G LTE or not.
Constant Value: "hide_enhanced_4g_lte_bool"
KEY_HIDE_IMS_APN_BOOL
public static final String KEY_HIDE_IMS_APN_BOOL
Determine whether IMS apn can be shown.
Constant Value: "hide_ims_apn_bool"
KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL
public static final String KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL
Boolean indicating if LTE+ icon should be shown if available.
Constant Value: "hide_lte_plus_data_icon_bool"
KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL
public static final String KEY_HIDE_PREFERRED_NETWORK_TYPE_BOOL
Determine whether preferred network type can be shown.
Constant Value: "hide_preferred_network_type_bool"
KEY_HIDE_PRESET_APN_DETAILS_BOOL
public static final String KEY_HIDE_PRESET_APN_DETAILS_BOOL
Flag to hide Preset APN details. If true, user cannot enter ApnEditor view of Preset APN, and cannot view details of the APN. If false, user can enter ApnEditor view of Preset APN. Default value is false.
Constant Value: "hide_preset_apn_details_bool"
KEY_HIDE_SIM_LOCK_SETTINGS_BOOL
public static final String KEY_HIDE_SIM_LOCK_SETTINGS_BOOL
Control whether users can reach the SIM lock settings.
Constant Value: "hide_sim_lock_settings_bool"
KEY_HIDE_TTY_HCO_VCO_WITH_RTT_BOOL
public static final String KEY_HIDE_TTY_HCO_VCO_WITH_RTT_BOOL
Indicates if the TTY HCO and VCO options should be hidden in the accessibility menu if the device is capable of RTT.
Constant Value: "hide_tty_hco_vco_with_rtt"
KEY_IGNORE_DATA_ENABLED_CHANGED_FOR_VIDEO_CALLS
public static final String KEY_IGNORE_DATA_ENABLED_CHANGED_FOR_VIDEO_CALLS
When true
, changes to the mobile data enabled switch will not cause the VT
registration state to change. That is, turning on or off mobile data will not cause VT to be
enabled or disabled.
When false
, disabling mobile data will cause VT to be de-registered.
Constant Value: "ignore_data_enabled_changed_for_video_calls"
KEY_IGNORE_RTT_MODE_SETTING_BOOL
public static final String KEY_IGNORE_RTT_MODE_SETTING_BOOL
When true
, the phone will always tell the IMS stack to keep RTT enabled and
determine on a per-call basis (based on extras from the dialer app) whether a call should be
an RTT call or not.
When false
, the old behavior is used, where the toggle in accessibility settings is
used to set the IMS stack's RTT enabled state.
Constant Value: "ignore_rtt_mode_setting_bool"
KEY_IGNORE_SIM_NETWORK_LOCKED_EVENTS_BOOL
public static final 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_CONFERENCE_SIZE_LIMIT_INT
public static final String KEY_IMS_CONFERENCE_SIZE_LIMIT_INT
Determines the maximum number of participants the carrier supports for a conference call.
This number is exclusive of the current device. A conference between 3 devices, for example,
would have a size limit of 2 participants.
Enforced when KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL
is true
.
Constant Value: "ims_conference_size_limit_int"
KEY_IMS_DTMF_TONE_DELAY_INT
public static final 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_INCLUDE_LTE_FOR_NR_ADVANCED_THRESHOLD_BANDWIDTH_BOOL
public static final String KEY_INCLUDE_LTE_FOR_NR_ADVANCED_THRESHOLD_BANDWIDTH_BOOL
Indicating whether to include LTE cell bandwidths when determining whether the aggregated cell bandwidth meets the required threshold for NR advanced.
Constant Value: "include_lte_for_nr_advanced_threshold_bandwidth_bool"
KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL
public static final String KEY_IS_IMS_CONFERENCE_SIZE_ENFORCED_BOOL
Determines whether a maximum size limit for IMS conference calls is enforced on the device.
When true
, IMS conference calls will be limited to at most
KEY_IMS_CONFERENCE_SIZE_LIMIT_INT
participants. When false
, no attempt is
made to limit the number of participants in a conference (the carrier will raise an error
when an attempt is made to merge too many participants into a conference).
Note: The maximum size of a conference can ONLY be supported where
KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL
is true
since the platform
needs conference event package data to accurately know the number of participants in the
conference.
Constant Value: "is_ims_conference_size_enforced_bool"
KEY_IS_OPPORTUNISTIC_SUBSCRIPTION_BOOL
public static final String KEY_IS_OPPORTUNISTIC_SUBSCRIPTION_BOOL
A boolean property indicating whether this subscription should be managed as an opportunistic subscription. If true, then this subscription will be selected based on available coverage and will not be available for a user in settings menus for selecting macro network providers. If unset, defaults to \u201cfalse\u201d.
This key will work all the way back to Build.VERSION_CODES.Q
.
Constant Value: "is_opportunistic_subscription_bool"
KEY_LTE_ENABLED_BOOL
public static final String KEY_LTE_ENABLED_BOOL
Boolean to decide whether LTE is enabled.
Constant Value: "lte_enabled_bool"
KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY
public static final String KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY
A list of 4 customized LTE Reference Signal Received Quality (RSRQ) thresholds. Reference: TS 136.133 v12.6.0 section 9.1.7 - RSRQ Measurement Report Mapping. 4 threshold integers must be within the boundaries [-34 dB, 3 dB], and the levels are: "NONE: [-34, threshold1)" "POOR: [threshold1, threshold2)" "MODERATE: [threshold2, threshold3)" "GOOD: [threshold3, threshold4)" "EXCELLENT: [threshold4, 3]" This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "lte_rsrq_thresholds_int_array"
KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY
public static final String KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY
A list of 4 customized LTE Reference Signal Signal to Noise Ratio (RSSNR) thresholds. 4 threshold integers must be within the boundaries [-20 dB, 30 dB], and the levels are: "NONE: [-20, threshold1)" "POOR: [threshold1, threshold2)" "MODERATE: [threshold2, threshold3)" "GOOD: [threshold3, threshold4)" "EXCELLENT: [threshold4, 30]" This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "lte_rssnr_thresholds_int_array"
KEY_MDN_IS_ADDITIONAL_VOICEMAIL_NUMBER_BOOL
public static final String KEY_MDN_IS_ADDITIONAL_VOICEMAIL_NUMBER_BOOL
When checking if a given number is the voicemail number, if this flag is true then in addition to comparing the given number to the voicemail number, we also compare it to the mdn. If this flag is false, the given number is only compared to the voicemail number. By default this value is false.
Constant Value: "mdn_is_additional_voicemail_number_bool"
KEY_MMS_ALIAS_ENABLED_BOOL
public static final String KEY_MMS_ALIAS_ENABLED_BOOL
Constant Value: "aliasEnabled"
KEY_MMS_ALIAS_MAX_CHARS_INT
public static final String KEY_MMS_ALIAS_MAX_CHARS_INT
Constant Value: "aliasMaxChars"
KEY_MMS_ALIAS_MIN_CHARS_INT
public static final String KEY_MMS_ALIAS_MIN_CHARS_INT
Constant Value: "aliasMinChars"
KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL
public static final String KEY_MMS_ALLOW_ATTACH_AUDIO_BOOL
Constant Value: "allowAttachAudio"
KEY_MMS_APPEND_TRANSACTION_ID_BOOL
public static final String KEY_MMS_APPEND_TRANSACTION_ID_BOOL
Constant Value: "enabledTransID"
KEY_MMS_CLOSE_CONNECTION_BOOL
public static final String KEY_MMS_CLOSE_CONNECTION_BOOL
If true, add "Connection: close" header to MMS HTTP requests so the connection is immediately closed (disabling keep-alive).
Constant Value: "mmsCloseConnection"
KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING
public static final String KEY_MMS_EMAIL_GATEWAY_NUMBER_STRING
Constant Value: "emailGatewayNumber"
KEY_MMS_GROUP_MMS_ENABLED_BOOL
public static final String KEY_MMS_GROUP_MMS_ENABLED_BOOL
Constant Value: "enableGroupMms"
KEY_MMS_HTTP_PARAMS_STRING
public static final String KEY_MMS_HTTP_PARAMS_STRING
Constant Value: "httpParams"
KEY_MMS_HTTP_SOCKET_TIMEOUT_INT
public static final String KEY_MMS_HTTP_SOCKET_TIMEOUT_INT
Constant Value: "httpSocketTimeout"
KEY_MMS_MAX_IMAGE_HEIGHT_INT
public static final String KEY_MMS_MAX_IMAGE_HEIGHT_INT
Constant Value: "maxImageHeight"
KEY_MMS_MAX_IMAGE_WIDTH_INT
public static final String KEY_MMS_MAX_IMAGE_WIDTH_INT
Constant Value: "maxImageWidth"
KEY_MMS_MAX_MESSAGE_SIZE_INT
public static final String KEY_MMS_MAX_MESSAGE_SIZE_INT
Constant Value: "maxMessageSize"
KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT
public static final String KEY_MMS_MESSAGE_TEXT_MAX_SIZE_INT
Constant Value: "maxMessageTextSize"
KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL
public static final String KEY_MMS_MMS_DELIVERY_REPORT_ENABLED_BOOL
Constant Value: "enableMMSDeliveryReports"
KEY_MMS_MMS_ENABLED_BOOL
public static final String KEY_MMS_MMS_ENABLED_BOOL
Constant Value: "enabledMMS"
KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL
public static final String KEY_MMS_MMS_READ_REPORT_ENABLED_BOOL
Constant Value: "enableMMSReadReports"
KEY_MMS_MULTIPART_SMS_ENABLED_BOOL
public static final String KEY_MMS_MULTIPART_SMS_ENABLED_BOOL
Constant Value: "enableMultipartSMS"
KEY_MMS_NAI_SUFFIX_STRING
public static final String KEY_MMS_NAI_SUFFIX_STRING
Constant Value: "naiSuffix"
KEY_MMS_NETWORK_RELEASE_TIMEOUT_MILLIS_INT
public static final String KEY_MMS_NETWORK_RELEASE_TIMEOUT_MILLIS_INT
Waiting time in milliseconds used before releasing an MMS data call. Not tearing down an MMS data connection immediately helps to reduce the message delivering latency if messaging continues between all parties in the conversation since the same data connection can be reused for further messages. This timer will control how long the data call will be kept alive before being torn down.
Constant Value: "mms_network_release_timeout_millis_int"
KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL
public static final String KEY_MMS_NOTIFY_WAP_MMSC_ENABLED_BOOL
Constant Value: "enabledNotifyWapMMSC"
KEY_MMS_RECIPIENT_LIMIT_INT
public static final String KEY_MMS_RECIPIENT_LIMIT_INT
Constant Value: "recipientLimit"
KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL
public static final String KEY_MMS_SEND_MULTIPART_SMS_AS_SEPARATE_MESSAGES_BOOL
Constant Value: "sendMultipartSmsAsSeparateMessages"
KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL
public static final String KEY_MMS_SHOW_CELL_BROADCAST_APP_LINKS_BOOL
Constant Value: "config_cellBroadcastAppLinks"
KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL
public static final String KEY_MMS_SMS_DELIVERY_REPORT_ENABLED_BOOL
Constant Value: "enableSMSDeliveryReports"
KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT
public static final String KEY_MMS_SMS_TO_MMS_TEXT_LENGTH_THRESHOLD_INT
Constant Value: "smsToMmsTextLengthThreshold"
KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT
public static final String KEY_MMS_SMS_TO_MMS_TEXT_THRESHOLD_INT
Constant Value: "smsToMmsTextThreshold"
KEY_MMS_SUBJECT_MAX_LENGTH_INT
public static final String KEY_MMS_SUBJECT_MAX_LENGTH_INT
Constant Value: "maxSubjectLength"
KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL
public static final String KEY_MMS_SUPPORT_HTTP_CHARSET_HEADER_BOOL
Constant Value: "supportHttpCharsetHeader"
KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL
public static final String KEY_MMS_SUPPORT_MMS_CONTENT_DISPOSITION_BOOL
Constant Value: "supportMmsContentDisposition"
KEY_MMS_UA_PROF_TAG_NAME_STRING
public static final String KEY_MMS_UA_PROF_TAG_NAME_STRING
Constant Value: "uaProfTagName"
KEY_MMS_UA_PROF_URL_STRING
public static final String KEY_MMS_UA_PROF_URL_STRING
Constant Value: "uaProfUrl"
KEY_MMS_USER_AGENT_STRING
public static final String KEY_MMS_USER_AGENT_STRING
Constant Value: "userAgent"
KEY_MONTHLY_DATA_CYCLE_DAY_INT
public static final String KEY_MONTHLY_DATA_CYCLE_DAY_INT
The day of the month (1-31) on which the data cycle rolls over.
If the current month does not have this day, the cycle will roll over at the start of the next month.
This setting may be still overridden by explicit user choice. By default,
DATA_CYCLE_USE_PLATFORM_DEFAULT
will be used.
Constant Value: "monthly_data_cycle_day_int"
KEY_NTN_LTE_RSRP_THRESHOLDS_INT_ARRAY
public static final String KEY_NTN_LTE_RSRP_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. A list of 4 NTN LTE RSRP thresholds above which a signal level is considered POOR, MODERATE, GOOD, or EXCELLENT, to be used in SignalStrength reporting. Note that the min and max thresholds are fixed at -140 and -44, as explained in TS 136.133 9.1.4 - RSRP Measurement Report Mapping.
See SignalStrength#MAX_LTE_RSRP and SignalStrength#MIN_LTE_RSRP. Any signal level outside these boundaries is considered invalid.
Constant Value: "ntn_lte_rsrp_thresholds_int_array"
KEY_NTN_LTE_RSRQ_THRESHOLDS_INT_ARRAY
public static final String KEY_NTN_LTE_RSRQ_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. A list of 4 customized NTN LTE Reference Signal Received Quality (RSRQ) thresholds. Reference: TS 136.133 v12.6.0 section 9.1.7 - RSRQ Measurement Report Mapping. 4 threshold integers must be within the boundaries [-34 dB, 3 dB], and the levels are: "NONE: [-34, threshold1)" "POOR: [threshold1, threshold2)" "MODERATE: [threshold2, threshold3)" "GOOD: [threshold3, threshold4)" "EXCELLENT: [threshold4, 3]" This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "ntn_lte_rsrq_thresholds_int_array"
KEY_NTN_LTE_RSSNR_THRESHOLDS_INT_ARRAY
public static final String KEY_NTN_LTE_RSSNR_THRESHOLDS_INT_ARRAY
This threshold is used when connected to a non-terrestrial LTE network. A list of 4 customized NTN LTE Reference Signal Signal to Noise Ratio (RSSNR) thresholds. 4 threshold integers must be within the boundaries [-20 dB, 30 dB], and the levels are: "NONE: [-20, threshold1)" "POOR: [threshold1, threshold2)" "MODERATE: [threshold2, threshold3)" "GOOD: [threshold3, threshold4)" "EXCELLENT: [threshold4, 30]" This key is considered invalid if the format is violated. If the key is invalid or not configured, a default value set will apply.
Constant Value: "ntn_lte_rssnr_thresholds_int_array"
KEY_ONLY_AUTO_SELECT_IN_HOME_NETWORK_BOOL
public static final String KEY_ONLY_AUTO_SELECT_IN_HOME_NETWORK_BOOL
Only allow auto selection in Advanced Network Settings when in home network. Manual selection is allowed when in roaming network.
Constant Value: "only_auto_select_in_home_network"
KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY
public static final String KEY_ONLY_SINGLE_DC_ALLOWED_INT_ARRAY
List of network type constants which support only a single data connection at a time. Some carriers do not support multiple PDP on UMTS.
Constant Value: "only_single_dc_allowed_int_array"
KEY_OPERATOR_SELECTION_EXPAND_BOOL
public static final String KEY_OPERATOR_SELECTION_EXPAND_BOOL
Control whether users can choose a network operator.
Constant Value: "operator_selection_expand_bool"
KEY_OPPORTUNISTIC_NETWORK_BACKOFF_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_BACKOFF_TIME_LONG
Controls back off time in milli seconds for switching back to
opportunistic subscription. This time will be added to
CarrierConfigManager#KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG
to
determine hysteresis time if there is ping pong situation
(determined by system app or 1st party app) between primary and opportunistic
subscription. Ping ping situation is defined in
#KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG.
If ping pong situation continuous #KEY_OPPORTUNISTIC_NETWORK_BACKOFF_TIME_LONG
will be added to previously determined hysteresis time.
Constant Value: "opportunistic_network_backoff_time_long"
KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_EXIT_HYSTERESIS_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_EXIT_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before switching data from opportunistic network to primary network.
Constant Value: "opportunistic_network_data_switch_exit_hysteresis_time_long"
KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_DATA_SWITCH_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before switching data to an opportunistic network.
Constant Value: "opportunistic_network_data_switch_hysteresis_time_long"
KEY_OPPORTUNISTIC_NETWORK_ENTRY_OR_EXIT_HYSTERESIS_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_OR_EXIT_HYSTERESIS_TIME_LONG
Controls hysteresis time in milli seconds for which OpportunisticNetworkService will wait before attaching to a network.
Constant Value: "opportunistic_network_entry_or_exit_hysteresis_time_long"
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_BANDWIDTH_INT
public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_BANDWIDTH_INT
Controls bandwidth threshold in Kbps at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data.
Constant Value: "opportunistic_network_entry_threshold_bandwidth_int"
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSRP_INT
public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSRP_INT
Controls RSRP threshold, in dBm, at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data.
The value of CellSignalStrengthLte#getRsrp()
will be compared with this
threshold.
Constant Value: "opportunistic_network_entry_threshold_rsrp_int"
KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSSNR_INT
public static final String KEY_OPPORTUNISTIC_NETWORK_ENTRY_THRESHOLD_RSSNR_INT
Controls RSSNR threshold, in dB, at which OpportunisticNetworkService will decide whether the opportunistic network is good enough for internet data.
The value of CellSignalStrengthLte#getRssnr()
will be compared with this
threshold.
Constant Value: "opportunistic_network_entry_threshold_rssnr_int"
KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT
public static final String KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT
Controls RSRP threshold, in dBm, below which OpportunisticNetworkService will decide whether the opportunistic network available is not good enough for internet data.
The value of CellSignalStrengthLte#getRsrp()
will be compared with this
threshold.
Constant Value: "opportunistic_network_exit_threshold_rsrp_int"
KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT
public static final String KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT
Controls RSSNR threshold, in dB, below which OpportunisticNetworkService will decide whether the opportunistic network available is not good enough for internet data.
The value of CellSignalStrengthLte#getRssnr()
will be compared with this
threshold.
Constant Value: "opportunistic_network_exit_threshold_rssnr_int"
KEY_OPPORTUNISTIC_NETWORK_MAX_BACKOFF_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_MAX_BACKOFF_TIME_LONG
Controls the max back off time in milli seconds for switching back to opportunistic subscription. This time will be the max hysteresis that can be determined irrespective of there is continuous ping pong situation or not as described in #KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG and #KEY_OPPORTUNISTIC_NETWORK_BACKOFF_TIME_LONG.
Constant Value: "opportunistic_network_max_backoff_time_long"
KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG
public static final String KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG
Controls the ping pong determination of opportunistic network. If opportunistic network is determined as out of service or below #KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSRP_INT or #KEY_OPPORTUNISTIC_NETWORK_EXIT_THRESHOLD_RSSNR_INT within #KEY_OPPORTUNISTIC_NETWORK_PING_PONG_TIME_LONG of switching to opportunistic network, it will be determined as ping pong situation by system app or 1st party app.
Constant Value: "opportunistic_network_ping_pong_time_long"
KEY_PARAMETERS_USED_FOR_NTN_LTE_SIGNAL_BAR_INT
public static final String KEY_PARAMETERS_USED_FOR_NTN_LTE_SIGNAL_BAR_INT
This threshold is used when connected to a non-terrestrial LTE network. Bit-field integer to determine whether to use Reference Signal Received Power (RSRP), Reference Signal Received Quality (RSRQ), or/and Reference Signal Signal to Noise Ratio (RSSNR) for the number of NTN LTE signal bars and signal criteria reporting enabling.
If a measure is not set, signal criteria reporting from modem will not be triggered and not be used for calculating signal level. If multiple measures are set bit, the parameter whose value is smallest is used to indicate the signal level.
- RSRP = 1 << 0
- RSRQ = 1 << 1
- RSSNR = 1 << 2
The value of this key must be bitwise OR of CellSignalStrengthLte#USE_RSRP, CellSignalStrengthLte#USE_RSRQ, CellSignalStrengthLte#USE_RSSNR.
For example, if both RSRP and RSRQ are used, the value of key is 3 (1 << 0 | 1 << 1). If the key is invalid or not configured, a default value (RSRP = 1 << 0) will apply.
Constant Value: "parameters_used_for_ntn_lte_signal_bar_int"
KEY_PING_TEST_BEFORE_DATA_SWITCH_BOOL
public static final String KEY_PING_TEST_BEFORE_DATA_SWITCH_BOOL
Controls whether to do ping test before switching data to opportunistic network. This carrier config is used to disable this feature.
Constant Value: "ping_test_before_data_switch_bool"
KEY_PREFER_2G_BOOL
public static final String KEY_PREFER_2G_BOOL
Used in the Preferred Network Types menu to determine if the 2G option is displayed. Value defaults to false as of Android T to discourage the use of insecure 2G protocols.
Constant Value: "prefer_2g_bool"
KEY_PREFER_3G_VISIBILITY_BOOL
public static final String KEY_PREFER_3G_VISIBILITY_BOOL
Used in the Preferred Network Types menu to determine if the 3G option is displayed.
Constant Value: "prefer_3g_visibility_bool"
KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT
public static final String KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT
The maximum number of times in a day that we display the notification for a performance boost
via premium capabilities when
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
returns a failure due to user action or timeout.
The default value is 2 times.
See also:
Constant Value: "premium_capability_maximum_daily_notification_count_int"
KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT
public static final String KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT
The maximum number of times in a month that we display the notification for a performance
boost via premium capabilities when
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
returns a failure due to user action or timeout.
The default value is 10 times.
See also:
Constant Value: "premium_capability_maximum_monthly_notification_count_int"
KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG
public static final String KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG
The amount of time in milliseconds within which the network must set up a slicing
configuration for the premium capability after
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
returns TelephonyManager#PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS
.
During the setup time, calls to
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
will return
TelephonyManager#PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP
.
If the network fails to set up a slicing configuration for the premium capability within the
setup time, subsequent purchase requests will be allowed to go through again.
The default value is 5 minutes.
Constant Value: "premium_capability_network_setup_time_millis_long"
KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
public static final String KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
The amount of time in milliseconds that the notification for a performance boost via
premium capabilities should be blocked when
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
returns a failure due to user action or timeout.
The maximum number of performance boost notifications to show the user are defined in
KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT
and
KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT
.
The default value is 30 minutes.
See also:
Constant Value: "premium_capability_notification_backoff_hysteresis_time_millis_long"
KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG
public static final String KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG
The amount of time in milliseconds the notification for a performance boost via
premium capabilities will be visible to the user after
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
requests user action to purchase the boost from the carrier. Once the timeout expires,
the performance boost notification will be automatically dismissed and the request will fail
with TelephonyManager#PURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUT
.
The default value is 30 minutes.
Constant Value: "premium_capability_notification_display_timeout_millis_long"
KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
public static final String KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG
The amount of time in milliseconds that the purchase request should be throttled when
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
returns a failure due to the carrier.
The default value is 30 minutes.
See also:
Constant Value: "premium_capability_purchase_condition_backoff_hysteresis_time_millis_long"
KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING
public static final String KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING
The URL to redirect to when the user clicks on the notification for a performance boost via
premium capabilities after applications call
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
.
If the URL is empty or invalid, the purchase request will return
TelephonyManager#PURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTED
.
This is empty by default.
Constant Value: "premium_capability_purchase_url_string"
KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL
public static final String KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL
Whether to allow premium capabilities to be purchased when the device is connected to LTE.
If this is true
, applications can call
TelephonyManager#purchasePremiumCapability(int, Executor, Consumer)
when connected to TelephonyManager#NETWORK_TYPE_LTE
to purchase and use
premium capabilities.
If this is false
, applications can only purchase and use premium capabilities when
connected to TelephonyManager#NETWORK_TYPE_NR
.
This is false
by default.
Constant Value: "premium_capability_supported_on_lte_bool"
KEY_PREVENT_CLIR_ACTIVATION_AND_DEACTIVATION_CODE_BOOL
public static final String KEY_PREVENT_CLIR_ACTIVATION_AND_DEACTIVATION_CODE_BOOL
Flag specifying whether to prevent sending CLIR activation("*31#") and deactivation("#31#")
code only without dialing number.
When true
, these are prevented, false
otherwise.
Constant Value: "prevent_clir_activation_and_deactivation_code_bool"
KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY
public static final String KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY
A list of failure cause codes that will trigger a modem restart when telephony receiving one of those during data setup. The cause codes are defined in 3GPP TS 24.008 Annex I and TS 24.301 Annex B.
Constant Value: "radio_restart_failure_causes_int_array"
KEY_RATCHET_NR_ADVANCED_BANDWIDTH_IF_RRC_IDLE_BOOL
public static final String KEY_RATCHET_NR_ADVANCED_BANDWIDTH_IF_RRC_IDLE_BOOL
Indicating whether to ratchet the aggregated cell bandwidths on receiving new values when
the device is in RRC IDLE mode.
The aggregated cell bandwidths are used for determining NR advanced state.
If this is true
, we will only update the aggregate cell bandwidths if the new
aggregate is higher than the current aggregate and the anchor NR cell is the same.
If this is false
, we will always update the aggregate cell bandwidths when receiving
new values.
Constant Value: "ratchet_nr_advanced_bandwidth_if_rrc_idle_bool"
KEY_RCS_CONFIG_SERVER_URL_STRING
public static final String KEY_RCS_CONFIG_SERVER_URL_STRING
The RCS configuration server URL. This URL is used to initiate RCS provisioning.
Constant Value: "rcs_config_server_url_string"
KEY_READ_ONLY_APN_FIELDS_STRING_ARRAY
public static final String KEY_READ_ONLY_APN_FIELDS_STRING_ARRAY
APN fields that user is not allowed to modify.
Constant Value: "read_only_apn_fields_string_array"
KEY_READ_ONLY_APN_TYPES_STRING_ARRAY
public static final String KEY_READ_ONLY_APN_TYPES_STRING_ARRAY
APN types that user is not allowed to modify.
Constant Value: "read_only_apn_types_string_array"
KEY_REQUIRE_ENTITLEMENT_CHECKS_BOOL
public static final 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_RESTART_RADIO_ON_PDP_FAIL_REGULAR_DEACTIVATION_BOOL
public static final String KEY_RESTART_RADIO_ON_PDP_FAIL_REGULAR_DEACTIVATION_BOOL
This constant was deprecated
in API level 29.
Use KEY_RADIO_RESTART_FAILURE_CAUSES_INT_ARRAY
instead
Flag indicating whether radio is to be restarted on error PDP_FAIL_REGULAR_DEACTIVATION This is false by default.
Constant Value: "restart_radio_on_pdp_fail_regular_deactivation_bool"
KEY_RTT_AUTO_UPGRADE_BOOL
public static final String KEY_RTT_AUTO_UPGRADE_BOOL
Indicates if the carrier supports auto-upgrading a call to RTT when receiving a call from a RTT-supported device.
Constant Value: "rtt_auto_upgrade_bool"
KEY_RTT_DOWNGRADE_SUPPORTED_BOOL
public static final String KEY_RTT_DOWNGRADE_SUPPORTED_BOOL
Indicates if the carrier supports downgrading a RTT call to a voice call during the call.
Constant Value: "rtt_downgrade_supported_bool"
KEY_RTT_SUPPORTED_BOOL
public static final String KEY_RTT_SUPPORTED_BOOL
Flag indicating whether the carrier supports RTT over IMS.
Constant Value: "rtt_supported_bool"
KEY_RTT_SUPPORTED_FOR_VT_BOOL
public static final String KEY_RTT_SUPPORTED_FOR_VT_BOOL
Indicates if the carrier supports RTT during a video call.
Constant Value: "rtt_supported_for_vt_bool"
KEY_RTT_SUPPORTED_WHILE_ROAMING_BOOL
public static final String KEY_RTT_SUPPORTED_WHILE_ROAMING_BOOL
Indicates whether RTT is supported while roaming.
Constant Value: "rtt_supported_while_roaming_bool"
KEY_RTT_UPGRADE_SUPPORTED_BOOL
public static final String KEY_RTT_UPGRADE_SUPPORTED_BOOL
Indicates if the carrier supports upgrading a voice call to an RTT call during the call.
Constant Value: "rtt_upgrade_supported_bool"
KEY_RTT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_VT_CALL_BOOL
public static final String KEY_RTT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_VT_CALL_BOOL
Indicates if the carrier supports upgrading a call that was previously a VT call to RTT.
Constant Value: "rtt_upgrade_supported_for_downgraded_vt_call"
KEY_SATELLITE_ATTACH_SUPPORTED_BOOL
public static final String KEY_SATELLITE_ATTACH_SUPPORTED_BOOL
This config enables modem to scan satellite PLMNs specified as per
KEY_CARRIER_SUPPORTED_SATELLITE_SERVICES_PER_PROVIDER_BUNDLE
and attach to same
in case cellular networks are not enabled. This will need specific agreement between
satellite provider and the carrier before enabling this flag.
The default value is false.
Constant Value: "satellite_attach_supported_bool"
KEY_SATELLITE_CONNECTION_HYSTERESIS_SEC_INT
public static final String KEY_SATELLITE_CONNECTION_HYSTERESIS_SEC_INT
The carrier-enabled satellite connection hysteresis time in seconds for which the device continues in satellite mode after it loses the connection with the satellite network.
If the device is in satellite mode, the following actions will be taken by the device:
- System UI will continue showing the satellite icon.
- When there is an ongoing emergency call, and the IMS is not registered, and cellular
service is not available, and the device is in satellite mode, a timer with a duration
defined by the overlay config
config_emergency_call_wait_for_connection_timeout_millis
will be started. When the timer expires, Telephony will send the eventTelephonyManager#EVENT_DISPLAY_EMERGENCY_MESSAGE
to Dialer, which will then prompt users to switch to using satellite emergency messaging.
The default value is 300 seconds.
Constant Value: "satellite_connection_hysteresis_sec_int"
KEY_SATELLITE_ENTITLEMENT_STATUS_REFRESH_DAYS_INT
public static final String KEY_SATELLITE_ENTITLEMENT_STATUS_REFRESH_DAYS_INT
An integer key holds the time interval for refreshing or re-querying the satellite entitlement status from the entitlement server to ensure it is the latest. The default value is 7 days.
Constant Value: "satellite_entitlement_status_refresh_days_int"
KEY_SATELLITE_ENTITLEMENT_SUPPORTED_BOOL
public static final String KEY_SATELLITE_ENTITLEMENT_SUPPORTED_BOOL
This configuration enables device to query the entitlement server to get the satellite configuration. This will need agreement the carrier before enabling this flag. The default value is false.
Constant Value: "satellite_entitlement_supported_bool"
KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL
public static final String KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL
Boolean indicating if default data account should show 4G icon when in 3G.
Constant Value: "show_4g_for_3g_data_icon_bool"
KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL
public static final String KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL
Boolean indicating if default data account should show LTE or 4G icon.
Constant Value: "show_4g_for_lte_data_icon_bool"
KEY_SHOW_APN_SETTING_CDMA_BOOL
public static final String KEY_SHOW_APN_SETTING_CDMA_BOOL
Show APN Settings for some CDMA carriers
Constant Value: "show_apn_setting_cdma_bool"
KEY_SHOW_BLOCKING_PAY_PHONE_OPTION_BOOL
public static final String KEY_SHOW_BLOCKING_PAY_PHONE_OPTION_BOOL
Flag specifying whether to show blocking pay phone option in blocked numbers screen. Only show the option if payphone call presentation is present in the carrier's region.
Constant Value: "show_blocking_pay_phone_option_bool"
KEY_SHOW_CALL_BLOCKING_DISABLED_NOTIFICATION_ALWAYS_BOOL
public static final String KEY_SHOW_CALL_BLOCKING_DISABLED_NOTIFICATION_ALWAYS_BOOL
Flag specifying whether to show notification(call blocking disabled) when Enhanced Call Blocking(KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL) is enabled and making emergency call. When true, notification is shown always. When false, notification is shown only when any setting of "Enhanced Blocked number" is enabled.
Constant Value: "show_call_blocking_disabled_notification_always_bool"
KEY_SHOW_CDMA_CHOICES_BOOL
public static final String KEY_SHOW_CDMA_CHOICES_BOOL
Show cdma network mode choices 1x, 3G, global etc.
Constant Value: "show_cdma_choices_bool"
KEY_SHOW_FORWARDED_NUMBER_BOOL
public static final String KEY_SHOW_FORWARDED_NUMBER_BOOL
Flag specifying whether to show forwarded number on call-in-progress screen. When true, forwarded number is shown. When false, forwarded number is not shown.
Constant Value: "show_forwarded_number_bool"
KEY_SHOW_ICCID_IN_SIM_STATUS_BOOL
public static final 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_IMS_REGISTRATION_STATUS_BOOL
public static final String KEY_SHOW_IMS_REGISTRATION_STATUS_BOOL
Flag specifying whether IMS registration state menu is shown in Status Info setting, default to false.
Constant Value: "show_ims_registration_status_bool"
KEY_SHOW_ONSCREEN_DIAL_BUTTON_BOOL
public static final 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_SHOW_ROAMING_INDICATOR_BOOL
public static final String KEY_SHOW_ROAMING_INDICATOR_BOOL
Config to show the roaming indicator (i.e. the "R" icon) from the status bar when roaming.
The roaming indicator will be shown if this is true
and will not be shown if this is
false
.
Constant Value: "show_roaming_indicator_bool"
KEY_SHOW_SIGNAL_STRENGTH_IN_SIM_STATUS_BOOL
public static final String KEY_SHOW_SIGNAL_STRENGTH_IN_SIM_STATUS_BOOL
Flag specifying whether the SignalStrength
is shown in the SIM
Status screen. The default value is true.
Constant Value: "show_signal_strength_in_sim_status_bool"
KEY_SHOW_VIDEO_CALL_CHARGES_ALERT_DIALOG_BOOL
public static final String KEY_SHOW_VIDEO_CALL_CHARGES_ALERT_DIALOG_BOOL
Flag specifying whether to show an alert dialog for video call charges.
By default this value is false
.
Constant Value: "show_video_call_charges_alert_dialog_bool"
KEY_SHOW_WFC_LOCATION_PRIVACY_POLICY_BOOL
public static final String KEY_SHOW_WFC_LOCATION_PRIVACY_POLICY_BOOL
Determines whether wifi calling location privacy policy is shown.
Constant Value: "show_wfc_location_privacy_policy_bool"
KEY_SIMPLIFIED_NETWORK_SETTINGS_BOOL
public static final String KEY_SIMPLIFIED_NETWORK_SETTINGS_BOOL
This constant was deprecated
in API level 34.
Never implemented. Has no behavior impact when override. DO NOT USE.
Control whether users receive a simplified network settings UI and improved network selection.
Constant Value: "simplified_network_settings_bool"
KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING
public static final String KEY_SIM_COUNTRY_ISO_OVERRIDE_STRING
String to override sim country iso.
Sim country iso is based on sim MCC which is coarse and doesn't work with dual IMSI SIM where
a SIM can have multiple MCC from different countries.
Instead, each sim carrier should have a single country code, apply per carrier based iso
code as an override. The overridden value can be read from
TelephonyManager#getSimCountryIso()
and SubscriptionInfo#getCountryIso()
Constant Value: "sim_country_iso_override_string"
KEY_SIM_NETWORK_UNLOCK_ALLOW_DISMISS_BOOL
public static final 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_SMDP_SERVER_ADDRESS_STRING
public static final String KEY_SMDP_SERVER_ADDRESS_STRING
SMDP+ server address for downloading opportunistic eSIM profile. FQDN (Fully Qualified Domain Name) of the SM-DP+ (e.g., smdp.gsma.com) restricted to the Alphanumeric mode character set defined in table 5 of ISO/IEC 18004 excluding '$'.
Constant Value: "smdp_server_address_string"
KEY_SMS_REQUIRES_DESTINATION_NUMBER_CONVERSION_BOOL
public static final String KEY_SMS_REQUIRES_DESTINATION_NUMBER_CONVERSION_BOOL
Determines if the carrier requires converting the destination number before sending out an SMS. Certain networks and numbering plans require different formats.
Constant Value: "sms_requires_destination_number_conversion_bool"
KEY_SUBSCRIPTION_GROUP_UUID_STRING
public static final String KEY_SUBSCRIPTION_GROUP_UUID_STRING
The UUID of a Group of related subscriptions in which to place the current subscription. A grouped subscription will behave for billing purposes and other UI purposes as though it is a transparent extension of other subscriptions in the group.
If set to REMOVE_GROUP_UUID_STRING
, then the subscription will be removed from
its current group.
This key will work all the way back to Build.VERSION_CODES.Q
.
Constant Value: "subscription_group_uuid_string"
KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY
public static final String KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY
A list of premium capabilities the carrier supports. Applications can prompt users to
purchase these premium capabilities from their carrier for a performance boost.
Valid values are any of TelephonyManager
's PREMIUM_CAPABILITY_*
constants.
This is empty by default, indicating that no premium capabilities are supported.
See also:
Constant Value: "supported_premium_capabilities_int_array"
KEY_SUPPORTS_BUSINESS_CALL_COMPOSER_BOOL
public static final String KEY_SUPPORTS_BUSINESS_CALL_COMPOSER_BOOL
Indicates if the carrier supports a business call composer.
Constant Value: "supports_business_call_composer_bool"
KEY_SUPPORTS_CALL_COMPOSER_BOOL
public static final String KEY_SUPPORTS_CALL_COMPOSER_BOOL
Indicates if the carrier supports call composer.
Constant Value: "supports_call_composer_bool"
KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_DTMF_BOOL
public static final String KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_DTMF_BOOL
Indicates whether the carrier supports the use of DTMF digits A-D for the purpose of device to device communication while in a call.
Constant Value: "supports_device_to_device_communication_using_dtmf_bool"
KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_RTP_BOOL
public static final String KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_RTP_BOOL
Indicates whether the carrier supports the use of RFC8285 compliant RTP header extensions for the purpose of device to device communication while in a call.
See also KEY_SUPPORTS_SDP_NEGOTIATION_OF_D2D_RTP_HEADER_EXTENSIONS_BOOL
.
Constant Value: "supports_device_to_device_communication_using_rtp_bool"
KEY_SUPPORTS_SDP_NEGOTIATION_OF_D2D_RTP_HEADER_EXTENSIONS_BOOL
public static final String KEY_SUPPORTS_SDP_NEGOTIATION_OF_D2D_RTP_HEADER_EXTENSIONS_BOOL
Indicates whether the carrier supports the negotiations of RFC8285 compliant RTP header
extensions supported on a call during the Session Description Protocol (SDP). This option
is only used when KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_RTP_BOOL
is
true
.
When true
, the RTP header extensions the platform uses for device to device
communication will be offered to the remote end during the SDP negotiation process.
When false
, the RTP header extensions will not be negotiated during the SDP
negotiation process and the platform will send RTP header extensions without prior
negotiation if KEY_SUPPORTS_DEVICE_TO_DEVICE_COMMUNICATION_USING_RTP_BOOL
is
true
.
Constant Value: "supports_sdp_negotiation_of_d2d_rtp_header_extensions_bool"
KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL
public static final String KEY_SUPPORT_3GPP_CALL_FORWARDING_WHILE_ROAMING_BOOL
Indicates whether the carrier supports 3gpp call forwarding MMI codes while roaming. If false, the user will be notified that call forwarding is not available when the MMI code fails.
Constant Value: "support_3gpp_call_forwarding_while_roaming_bool"
KEY_SUPPORT_ADD_CONFERENCE_PARTICIPANTS_BOOL
public static final String KEY_SUPPORT_ADD_CONFERENCE_PARTICIPANTS_BOOL
Determines whether conference participants can be added to existing call to form an adhoc
conference call (in contrast to merging calls to form a conference). When true
,
adding conference participants to existing call is supported, false otherwise
.
Constant Value: "support_add_conference_participants_bool"
KEY_SUPPORT_ADHOC_CONFERENCE_CALLS_BOOL
public static final String KEY_SUPPORT_ADHOC_CONFERENCE_CALLS_BOOL
Determines whether adhoc conference calls are supported by a carrier. When true
,
adhoc conference calling is supported, false otherwise
.
Constant Value: "support_adhoc_conference_calls_bool"
KEY_SUPPORT_CLIR_NETWORK_DEFAULT_BOOL
public static final String KEY_SUPPORT_CLIR_NETWORK_DEFAULT_BOOL
Flag indicating whether to support "Network default" option in Caller ID settings for Calling Line Identification Restriction (CLIR).
Constant Value: "support_clir_network_default_bool"
KEY_SUPPORT_CONFERENCE_CALL_BOOL
public static final 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_EMERGENCY_SMS_OVER_IMS_BOOL
public static final String KEY_SUPPORT_EMERGENCY_SMS_OVER_IMS_BOOL
Flag indicating whether or not sending emergency SMS messages over IMS is supported when in LTE/limited LTE (Emergency only) service mode..
Constant Value: "support_emergency_sms_over_ims_bool"
KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL
public static final String KEY_SUPPORT_ENHANCED_CALL_BLOCKING_BOOL
Determines whether to enable enhanced call blocking feature on the device. android.provider.BlockedNumberContract.SystemContract#ENHANCED_SETTING_KEY_BLOCK_UNREGISTERED android.provider.BlockedNumberContract.SystemContract#ENHANCED_SETTING_KEY_BLOCK_PRIVATE android.provider.BlockedNumberContract.SystemContract#ENHANCED_SETTING_KEY_BLOCK_PAYPHONE android.provider.BlockedNumberContract.SystemContract#ENHANCED_SETTING_KEY_BLOCK_UNKNOWN android.provider.BlockedNumberContract.SystemContract#ENHANCED_SETTING_KEY_BLOCK_UNAVAILABLE
1. For Single SIM(SS) device, it can be customized in both carrier_config_mccmnc.xml and vendor.xml.
2. For Dual SIM(DS) device, it should be customized in vendor.xml, since call blocking function is used regardless of SIM.
If true
enable enhanced call blocking feature on the device, false
otherwise.
Constant Value: "support_enhanced_call_blocking_bool"
KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL
public static final String KEY_SUPPORT_IMS_CONFERENCE_EVENT_PACKAGE_BOOL
Determines whether the IMS conference merge process supports and returns its participants
data. When true
, on merge complete, conference call would have a list of its
participants returned in XML format, false otherwise
.
Constant Value: "support_ims_conference_event_package_bool"
KEY_SUPPORT_PAUSE_IMS_VIDEO_CALLS_BOOL
public static final 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
public static final 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_SUPPORT_TDSCDMA_BOOL
public static final String KEY_SUPPORT_TDSCDMA_BOOL
Boolean to decide whether TD-SCDMA is supported.
Constant Value: "support_tdscdma_bool"
KEY_SUPPORT_TDSCDMA_ROAMING_NETWORKS_STRING_ARRAY
public static final String KEY_SUPPORT_TDSCDMA_ROAMING_NETWORKS_STRING_ARRAY
A list of mcc/mnc that support TD-SCDMA for device when connect to the roaming network.
Constant Value: "support_tdscdma_roaming_networks_string_array"
KEY_SWITCH_DATA_TO_PRIMARY_IF_PRIMARY_IS_OOS_BOOL
public static final String KEY_SWITCH_DATA_TO_PRIMARY_IF_PRIMARY_IS_OOS_BOOL
Controls whether to switch data to primary from opportunistic subscription if primary is out of service. This control only affects system or 1st party app initiated data switch, but will not override data switch initiated by privileged carrier apps This carrier config is used to disable this feature.
Constant Value: "switch_data_to_primary_if_primary_is_oos_bool"
KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL
public static final String KEY_TREAT_DOWNGRADED_VIDEO_CALLS_AS_VIDEO_CALLS_BOOL
Flag indicating whether some telephony logic will treat a call which was formerly a video
call as if it is still a video call. When true
:
Logic which will automatically drop a video call which takes place over WIFI when a
voice call is answered (see KEY_DROP_VIDEO_CALL_WHEN_ANSWERING_AUDIO_CALL_BOOL
.
Logic which determines whether the user can use TTY calling.
Constant Value: "treat_downgraded_video_calls_as_video_calls_bool"
KEY_TTY_SUPPORTED_BOOL
public static final String KEY_TTY_SUPPORTED_BOOL
Boolean flag indicating whether the carrier supports TTY.
Note that KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
controls availability of TTY over
VoLTE; if this carrier configuration is disabled, then
KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL
is also implicitly disabled.
TelecomManager#isTtySupported()
should be used to determine if a device supports TTY,
and this carrier config key should be used to see if the current carrier supports it.
Constant Value: "tty_supported_bool"
KEY_UNLOGGABLE_NUMBERS_STRING_ARRAY
public static final String KEY_UNLOGGABLE_NUMBERS_STRING_ARRAY
A string array containing numbers that shouldn't be included in the call log.
Constant Value: "unloggable_numbers_string_array"
KEY_USE_ACS_FOR_RCS_BOOL
public static final String KEY_USE_ACS_FOR_RCS_BOOL
Indicates if auto-configuration server is used for the RCS config Reference: GSMA RCC.14
Constant Value: "use_acs_for_rcs_bool"
KEY_USE_HFA_FOR_PROVISIONING_BOOL
public static final String KEY_USE_HFA_FOR_PROVISIONING_BOOL
CDMA activation goes through HFA
Constant Value: "use_hfa_for_provisioning_bool"
KEY_USE_IP_FOR_CALLING_INDICATOR_BOOL
public static final String KEY_USE_IP_FOR_CALLING_INDICATOR_BOOL
Determines whether or not to use (IP) data connectivity as a supplemental condition to control the visibility of the no-calling indicator for this carrier in the System UI. Setting the configuration to true may make sense for carriers that provide OTT calling. Config = true: show no-calling indication only if telephony does not have voice registration and if no (IP) data connectivity is available. Config = false: show no-calling indication only if telephony does not have voice registration.
Constant Value: "use_ip_for_calling_indicator_bool"
KEY_USE_OTASP_FOR_PROVISIONING_BOOL
public static final String KEY_USE_OTASP_FOR_PROVISIONING_BOOL
CDMA activation goes through OTASP.
Constant Value: "use_otasp_for_provisioning_bool"
KEY_USE_RCS_PRESENCE_BOOL
public static final String KEY_USE_RCS_PRESENCE_BOOL
This constant was deprecated
in API level 31.
No longer used in framework code, however it may still be used by applications
that have not updated their code. This config should still be set to true
if
Ims#KEY_RCS_BULK_CAPABILITY_EXCHANGE_BOOL
is set to true
and
Ims#KEY_ENABLE_PRESENCE_CAPABILITY_EXCHANGE_BOOL
is set to true
.
Flag indicating whether or not the carrier supports the periodic exchange of phone numbers in the user's address book with the carrier's presence server in order to retrieve the RCS capabilities for each contact used in the RCS User Capability Exchange (UCE) procedure. See RCC.71, section 3 for more information.
The flag Ims#KEY_ENABLE_PRESENCE_PUBLISH_BOOL
must also be enabled if this flag is
enabled, as sending a periodic SIP PUBLISH with this device's RCS capabilities is a
requirement for capability exchange to begin.
When presence is supported, the device should use the
ContactsContract.DataColumns.CARRIER_PRESENCE
bit mask and set the
ContactsContract.DataColumns.CARRIER_PRESENCE_VT_CAPABLE
bit to indicate
whether each contact supports video calling. The UI is made aware that presence is enabled
via PhoneAccount.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_USE_RCS_SIP_OPTIONS_BOOL
public static final String KEY_USE_RCS_SIP_OPTIONS_BOOL
Flag indicating whether the carrier supports RCS SIP OPTIONS indication for User Capability Exchange (UCE).
Constant Value: "use_rcs_sip_options_bool"
KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
public static final String KEY_USE_WFC_HOME_NETWORK_MODE_IN_ROAMING_NETWORK_BOOL
Flag specifying whether the carrier will use the
WFC home network mode in roaming network.
false
- roaming preference can be selected separately from the home preference.
true
- roaming preference is the same as home preference and
KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT
is used as the default value.
Constant Value: "use_wfc_home_network_mode_in_roaming_network_bool"
KEY_VOICEMAIL_NOTIFICATION_PERSISTENT_BOOL
public static final 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
public static final 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
public static final 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_VONR_ENABLED_BOOL
public static final String KEY_VONR_ENABLED_BOOL
Flag specifying whether VoNR should be enabled for carrier. If true, VoNr will be enabled. If false, hard disabled. Disabled by default.
Constant Value: "vonr_enabled_bool"
KEY_VONR_ON_BY_DEFAULT_BOOL
public static final String KEY_VONR_ON_BY_DEFAULT_BOOL
Boolean indicating the default VoNR user preference setting. If true, the VoNR setting will be enabled. If false, it will be disabled initially. Enabled by default.
Constant Value: "vonr_on_by_default_bool"
KEY_VONR_SETTING_VISIBILITY_BOOL
public static final String KEY_VONR_SETTING_VISIBILITY_BOOL
Boolean indicating if the VoNR setting is visible in the Call Settings menu.
If this flag is set and VoNR is enabled for this carrier (see KEY_VONR_ENABLED_BOOL
)
the VoNR setting menu will be visible. If KEY_VONR_ENABLED_BOOL
or
this setting is false, the menu will be gone.
Enabled by default.
Constant Value: "vonr_setting_visibility_bool"
KEY_VT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_RTT_CALL_BOOL
public static final String KEY_VT_UPGRADE_SUPPORTED_FOR_DOWNGRADED_RTT_CALL_BOOL
Indicates if the carrier supports upgrading a call that was previously an RTT call to VT.
Constant Value: "vt_upgrade_supported_for_downgraded_rtt_call"
KEY_VVM_CELLULAR_DATA_REQUIRED_BOOL
public static final 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_CLIENT_PREFIX_STRING
public static final String KEY_VVM_CLIENT_PREFIX_STRING
The default OMTP visual voicemail client prefix to use. Defaulted to "//VVM"
Constant Value: "vvm_client_prefix_string"
KEY_VVM_DESTINATION_NUMBER_STRING
public static final 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_DISABLED_CAPABILITIES_STRING_ARRAY
public static final String KEY_VVM_DISABLED_CAPABILITIES_STRING_ARRAY
A set of capabilities that should not be used even if it is reported by the visual voicemail IMAP CAPABILITY command.
Constant Value: "vvm_disabled_capabilities_string_array"
KEY_VVM_LEGACY_MODE_ENABLED_BOOL
public static final String KEY_VVM_LEGACY_MODE_ENABLED_BOOL
Whether legacy mode should be used when the visual voicemail client is disabled.
Legacy mode is a mode that on the carrier side visual voicemail is still activated, but on the client side all network operations are disabled. SMSs are still monitored so a new message SYNC SMS will be translated to show a message waiting indicator, like traditional voicemails.
This is for carriers that does not support VVM deactivation so voicemail can continue to function without the data cost.
Constant Value: "vvm_legacy_mode_enabled_bool"
KEY_VVM_PORT_NUMBER_INT
public static final 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
public static final String KEY_VVM_PREFETCH_BOOL
Whether to prefetch audio data on new voicemail arrival, defaulted to true.
Constant Value: "vvm_prefetch_bool"
KEY_VVM_SSL_ENABLED_BOOL
public static final String KEY_VVM_SSL_ENABLED_BOOL
Whether to use SSL to connect to the visual voicemail IMAP server. Defaulted to false.
Constant Value: "vvm_ssl_enabled_bool"
KEY_VVM_TYPE_STRING
public static final String KEY_VVM_TYPE_STRING
The type of visual voicemail protocol the carrier adheres to. See TelephonyManager
for possible values. For example TelephonyManager#VVM_TYPE_OMTP
.
Constant Value: "vvm_type_string"
KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING
public static final String KEY_WFC_EMERGENCY_ADDRESS_CARRIER_APP_STRING
The Component Name of the activity that can setup the emergency address for WiFi Calling as per carrier requirement.
Constant Value: "wfc_emergency_address_carrier_app_string"
KEY_WORLD_MODE_ENABLED_BOOL
public static final String KEY_WORLD_MODE_ENABLED_BOOL
Boolean to decide whether world mode is enabled.
Constant Value: "world_mode_enabled_bool"
KEY_WORLD_PHONE_BOOL
public static final String KEY_WORLD_PHONE_BOOL
Flag indicating if the phone is a world phone
Constant Value: "world_phone_bool"
REMOVE_GROUP_UUID_STRING
public static final String REMOVE_GROUP_UUID_STRING
Passing this value as KEY_SUBSCRIPTION_GROUP_UUID_STRING
will remove the
subscription from a group instead of adding it to a group.
This value will work all the way back to Build.VERSION_CODES.Q
.
Constant Value: "00000000-0000-0000-0000-000000000000"
SERVICE_CLASS_NONE
public static final int SERVICE_CLASS_NONE
Service class flag if no specific service class is specified. Reference: 3GPP TS 27.007 Section 7.4 Facility lock +CLCK
Constant Value: 0 (0x00000000)
SERVICE_CLASS_VOICE
public static final int SERVICE_CLASS_VOICE
Service class flag for voice telephony. Reference: 3GPP TS 27.007 Section 7.4 Facility lock +CLCK
Constant Value: 1 (0x00000001)
USSD_OVER_CS_ONLY
public static final int USSD_OVER_CS_ONLY
Only send USSD over CS.
KEY_CARRIER_USSD_METHOD_INT
Constant Value: 2 (0x00000002)
USSD_OVER_CS_PREFERRED
public static final int USSD_OVER_CS_PREFERRED
Only send USSD over IMS while CS is out of service, otherwise send USSD over CS.
KEY_CARRIER_USSD_METHOD_INT
Constant Value: 0 (0x00000000)
USSD_OVER_IMS_ONLY
public static final int USSD_OVER_IMS_ONLY
Only send USSD over IMS and disallow silent redial over CS.
KEY_CARRIER_USSD_METHOD_INT
Constant Value: 3 (0x00000003)
USSD_OVER_IMS_PREFERRED
public static final int USSD_OVER_IMS_PREFERRED
Send USSD over IMS or CS while IMS is out of service or silent redial over CS if needed.
KEY_CARRIER_USSD_METHOD_INT
Constant Value: 1 (0x00000001)
Public methods
getConfig
public PersistableBundle getConfig (String... keys)
Gets the configuration values of the specified config keys applied for the default subscription.
If the value for the key can't be found, the returned bundle will filter the key out.
After using this method to get the configuration bundle, isConfigForIdentifiedCarrier(android.os.PersistableBundle)
should be called to confirm whether any
carrier specific configuration has been applied.
Note that on success, the key/value for KEY_CARRIER_CONFIG_VERSION_STRING
and
KEY_CARRIER_CONFIG_APPLIED_BOOL
are always in the returned bundle, no matter if
they were explicitly requested.
Requires Permission:
READ_PHONE_STATE
, or the calling app
has carrier privileges for the default subscription (see
TelephonyManager#hasCarrierPrivileges()
).
Requires Manifest.permission.READ_PHONE_STATE
or carrier privileges
Parameters | |
---|---|
keys |
String : The config keys to retrieve values
This value cannot be null . |
Returns | |
---|---|
PersistableBundle |
A PersistableBundle with key/value mapping for the specified carrier
configs on success, or an empty (but never null) bundle on failure. |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
getConfig
public PersistableBundle getConfig ()
This method was deprecated
in API level 34.
use getConfig(java.lang.String)
instead.
Gets the configuration values for the default subscription. After using this method to get
the configuration bundle, isConfigForIdentifiedCarrier(android.os.PersistableBundle)
should be
called to confirm whether any carrier specific configuration has been applied.
Requires Permission:
READ_PHONE_STATE
, or the calling app
has carrier privileges (see TelephonyManager#hasCarrierPrivileges()
).
Requires Manifest.permission.READ_PHONE_STATE
Returns | |
---|---|
PersistableBundle |
This value may be null . |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
See also:
getConfigByComponentForSubId
public PersistableBundle getConfigByComponentForSubId (String prefix, int subId)
Gets the configuration values for a component using its prefix.
Requires Permission:
READ_PHONE_STATE
, or the calling app
has carrier privileges (see TelephonyManager#hasCarrierPrivileges()
).
Requires Manifest.permission.READ_PHONE_STATE
Parameters | |
---|---|
prefix |
String : prefix of the component.
This value cannot be null . |
subId |
int : the subscription ID, normally obtained from SubscriptionManager . |
Returns | |
---|---|
PersistableBundle |
This value may be null . |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
See also:
getConfigForSubId
public PersistableBundle getConfigForSubId (int subId, String... keys)
Gets the configuration values of the specified keys for a particular subscription.
If an invalid subId is used, the returned configuration will contain default values for the specified keys. If the value for the key can't be found, the returned configuration will filter the key out.
After using this method to get the configuration bundle,
isConfigForIdentifiedCarrier(android.os.PersistableBundle)
should be called to confirm whether
any carrier specific configuration has been applied.
Note that on success, the key/value for KEY_CARRIER_CONFIG_VERSION_STRING
and
KEY_CARRIER_CONFIG_APPLIED_BOOL
are always in the returned bundle, no matter if they
were explicitly requested.
Requires Permission:
READ_PHONE_STATE
, or the calling app
has carrier privileges on the specified subscription (see
TelephonyManager#hasCarrierPrivileges()
).
Requires Manifest.permission.READ_PHONE_STATE
or carrier privileges
Parameters | |
---|---|
subId |
int : The subscription ID on which the carrier config should be retrieved. |
keys |
String : The carrier config keys to retrieve values.
This value cannot be null . |
Returns | |
---|---|
PersistableBundle |
A PersistableBundle with key/value mapping for the specified configuration
on success, or an empty (but never null) bundle on failure (for example, when the calling app
has no permission). |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
getConfigForSubId
public PersistableBundle getConfigForSubId (int subId)
This method was deprecated
in API level 34.
Use getConfigForSubId(int, java.lang.String)
instead.
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. After using this method to get the configuration bundle,
isConfigForIdentifiedCarrier(android.os.PersistableBundle)
should be called to confirm whether
any carrier specific configuration has been applied.
Requires Permission:
READ_PHONE_STATE
, or the calling app
has carrier privileges (see TelephonyManager#hasCarrierPrivileges()
).
Requires Manifest.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.
This value may be null . |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
isConfigForIdentifiedCarrier
public static boolean isConfigForIdentifiedCarrier (PersistableBundle bundle)
Determines whether a configuration PersistableBundle
obtained from
getConfig()
or getConfigForSubId(int)
corresponds to an identified carrier.
When an app receives the CarrierConfigManager#ACTION_CARRIER_CONFIG_CHANGED
broadcast which informs it that the carrier configuration has changed, it is possible
that another reload of the carrier configuration has begun since the intent was sent.
In this case, the carrier configuration the app fetches (e.g. via getConfig()
)
may not represent the configuration for the current carrier. It should be noted that it
does not necessarily mean the configuration belongs to current carrier when this function
return true because it may belong to another previous identified carrier. Users should
always call getConfig()
or getConfigForSubId(int)
after receiving the
broadcast ACTION_CARRIER_CONFIG_CHANGED
.
After using getConfig()
or getConfigForSubId(int)
an app should always
use this method to confirm whether any carrier specific configuration has been applied.
Especially when an app misses the broadcast ACTION_CARRIER_CONFIG_CHANGED
but it
still needs to get the current configuration, it must use this method to verify whether the
configuration is default or carrier overridden.
Parameters | |
---|---|
bundle |
PersistableBundle : the configuration bundle to be checked. |
Returns | |
---|---|
boolean |
boolean true if any carrier specific configuration bundle has been applied, false otherwise or the bundle is null. |
notifyConfigChangedForSubId
public 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 Permission:
MODIFY_PHONE_STATE
, or the calling app
has carrier privileges (see TelephonyManager#hasCarrierPrivileges()
).
This method returns before the reload has completed, and CarrierService.onLoadConfig(CarrierIdentifier)
will be called from an arbitrary thread.
Requires Manifest.permission.MODIFY_PHONE_STATE
Parameters | |
---|---|
subId |
int |
Throws | |
---|---|
UnsupportedOperationException |
If the device does not have
PackageManager#FEATURE_TELEPHONY_SUBSCRIPTION . |
registerCarrierConfigChangeListener
public void registerCarrierConfigChangeListener (Executor executor, CarrierConfigManager.CarrierConfigChangeListener listener)
Register a CarrierConfigChangeListener
to get a notification when carrier
configurations have changed.
Parameters | |
---|---|
executor |
Executor : The executor on which the listener will be called.
This value cannot be null .
Callback and listener events are dispatched through this
Executor , providing an easy way to control which thread is
used. To dispatch events through the main thread of your
application, you can use
Context.getMainExecutor() .
Otherwise, provide an Executor that dispatches to an appropriate thread. |
listener |
CarrierConfigManager.CarrierConfigChangeListener : The CarrierConfigChangeListener called when carrier configs has changed.
This value cannot be null . |
unregisterCarrierConfigChangeListener
public void unregisterCarrierConfigChangeListener (CarrierConfigManager.CarrierConfigChangeListener listener)
Unregister the CarrierConfigChangeListener
to stop notification on carrier
configurations change.
Parameters | |
---|---|
listener |
CarrierConfigManager.CarrierConfigChangeListener : The CarrierConfigChangeListener which was registered with method
registerCarrierConfigChangeListener(java.util.concurrent.Executor, android.telephony.CarrierConfigManager.CarrierConfigChangeListener) .
This value cannot be null . |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-06-18 UTC.