Settings
class Settings
kotlin.Any | |
↳ | android.provider.Settings |
The Settings provider contains global system-level device preferences.
Summary
Nested classes | |
---|---|
Global system settings, containing preferences that always apply identically to all defined users. |
|
Common base for tables of name/value settings. |
|
A Settings panel is floating UI that contains a fixed subset of settings to address a particular user problem. |
|
Secure system settings, containing system preferences that applications can read but are not allowed to write. |
|
System settings, containing miscellaneous system preferences. |
Constants | |
---|---|
static String |
Activity Action: Show settings for accessibility modules. |
static String |
Activity Action: Show add account screen for creating a new account. |
static String |
Activity Action: Show settings to allow configuration of Advanced memory protection. |
static String |
Activity Action: Show settings to allow entering/exiting airplane mode. |
static String |
Activity Action: Show app listing settings, filtered by those that send notifications. |
static String |
Activity Action: Show settings to allow configuration of APNs. |
static String |
Activity Action: Show screen of details about a particular application. |
static String |
Activity Action: Show settings to allow configuration of application development-related settings. |
static String |
Activity Action: Show settings to allow configuration of application-related settings. |
static String |
Activity Action: Show settings to allow configuration of per application locale. |
static String |
Activity Action: Show notification bubble settings for a single app. |
static String |
Activity Action: Show notification settings for a single app. |
static String |
Activity Action: Show the "Open by Default" page in a particular application's details page. |
static String |
Activity action: Show Settings app search UI when this action is available for device. |
static String |
Activity Action: Show screen for controlling app usage properties for an app. |
static String |
Activity Action: Shows the settings page for an |
static String |
Activity Action: Show Auto Rotate configuration settings. |
static String |
Activity Action: Show battery saver settings. |
static String |
Activity Action: Show settings to enroll biometrics, and setup PIN/Pattern/Pass if necessary. |
static String |
Activity Action: Show settings to allow configuration of Bluetooth. |
static String |
Activity Action: Show settings for video captioning. |
static String |
Activity Action: Show settings to allow configuration of cast endpoints. |
static String |
Activity Action: Show notification settings for a single |
static String |
Activity Action: Show the automatic do not disturb rule listing page |
static String |
Activity Action: Show screen that let user enable a Credential Manager provider. |
static String |
Activity Action: Show settings for selection of 2G/3G. |
static String |
Activity Action: Show settings to allow configuration of data and view data usage. |
static String |
Activity Action: Show settings to allow configuration of date and time. |
static String |
Activity Action: Show general device information settings (serial number, software version, phone number, etc.). |
static String |
Activity Action: Show settings to allow configuration of display. |
static String |
Activity Action: Show Daydream settings. |
static String |
Activity Action: Show settings to enroll fingerprints, and setup PIN/Pattern/Pass if necessary. |
static String |
Activity Action: Show settings to configure the hardware keyboard. |
static String |
Activity Action: Show Home selection settings. |
static String |
Activity Action: Show screen for controlling background data restrictions for a particular application. |
static String |
Activity Action: Show screen for controlling which apps can ignore battery optimizations. |
static String |
Activity Action: Show settings to configure input methods, in particular allowing the user to enable input methods. |
static String |
Activity Action: Show settings to enable/disable input method subtypes. |
static String |
Activity Action: Show settings for internal storage. |
static String |
Activity Action: Show settings to allow configuration of locale. |
static String |
Activity Action: Show settings to allow configuration of current location sources. |
static String |
Activity Action: Show settings to manage all applications. |
static String |
Activity Action: Show screen for controlling which apps have access to manage external storage. |
static String |
Activity Action: Show settings to manage all SIM profiles. |
static String |
Activity Action: Show settings to manage installed applications. |
static String |
Activity Action: Show screen for controlling if the app specified in the data URI of the intent can manage external storage. |
static String |
Activity Action: Show screen for controlling whether an app can send full screen intents. |
static String |
Activity Action: Show Default apps settings. |
static String |
Activity Action: Show screen for controlling which apps can draw on top of other apps. |
static String |
Activity action: Launch UI to manage a setting restricted by supervisors. |
static String |
Activity Action: Show settings to allow configuration of trusted external sources Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. |
static String |
Activity Action: Show screen for controlling which apps are allowed to write/modify system settings. |
static String |
Activity Action: Show settings for memory card storage. |
static String |
Activity Action: Show settings for selecting the network operator. |
static String |
Activity Action: Show NFC Sharing settings. |
static String |
Activity Action: Show NFC Tap & Pay settings |
static String |
Activity Action: Show NFC settings. |
static String |
Activity Action: Show settings to allow configuration of Night display. |
static String |
Activity Action: Show Notification assistant settings. |
static String |
Activity Action: Show notification listener permission settings page for app. |
static String |
Activity Action: Show Notification listener settings. |
static String |
Activity Action: Show Do Not Disturb access settings. |
static String |
Activity Action: Show the top level print settings. |
static String |
Activity Action: Show settings to allow configuration of privacy options, i. |
static String |
Activity Action: Show setting page to process a Wi-Fi Easy Connect (aka DPP) URI and start configuration. |
static String |
Activity Action: Show screen for controlling the Quick Access Wallet. |
static String |
Activity Action: Show settings to allow configuration of quick launch shortcuts. |
static String |
Activity Action: Show settings to allow configuration of regional preferences |
static String |
Activity Action: Ask the user to allow an app to ignore battery optimizations (that is, put them on the allowlist of apps shown by |
static String |
Activity Action: Show settings to allow configuration of |
static String |
Activity Action: Show settings to allow configuration of |
static String |
Activity Action: Show settings to allow configuration of |
static String |
Activity Action: Show screen that let user select its Autofill Service. |
static String |
Activity Action: Show settings to provide guide about carrier satellite messaging. |
static String |
Activity Action: Show settings for global search. |
static String |
Activity Action: Show settings to allow configuration of security and location privacy. |
static String |
Activity Action: Show system settings. |
static String |
Activity Action: For system or preinstalled apps to show their |
static String |
Activity Action: Show the regulatory information screen for the device. |
static String |
Activity Action: Show Work Policy info. |
static String |
Activity Action: Show settings to allow configuration of sound and volume. |
static String |
Activity Action: Show screen for controlling which apps have access on volume directories. |
static String |
Activity Action: Show settings to allow configuration of sync settings. |
static String |
Activity Action: Show settings to control access to usage information. |
static String |
Activity Action: Show settings to manage the user input dictionary. |
static String |
Activity Action: Modify Airplane mode settings using a voice command. |
static String |
Activity Action: Modify Battery Saver mode setting using a voice command. |
static String |
Activity Action: Modify do not disturb mode settings. |
static String |
Activity Action: Show settings to configure input methods, in particular allowing the user to enable input methods. |
static String |
Activity Action: Show settings to allow configuration of VPN. |
static String |
Activity Action: Show VR listener settings. |
static String |
Activity Action: Allows user to select current webview implementation. |
static String |
Activity Action: Show setting page to process the addition of Wi-Fi networks to the user's saved network list. |
static String |
Activity Action: Show settings to allow configuration of a static IP address for Wi-Fi. |
static String |
Activity Action: Show settings to allow configuration of Wi-Fi. |
static String |
Activity Action: Show settings to allow configuration of wireless controls such as Wi-Fi, Bluetooth and Mobile networks. |
static String |
Activity Action: Show Zen Mode (aka Do Not Disturb) priority configuration settings. |
static Int |
A result of |
static Int |
A result of |
static Int |
A result of |
static String | |
static String |
Activity Extra: Limit available options in launched activity based on the given account types. |
static String |
Activity Extra: Enable or disable Airplane Mode. |
static String |
Activity Extra: The package owner of the notification channel settings to display. |
static String |
Activity Extra: Limit available options in launched activity based on the given authority. |
static String |
Activity Extra: The String id of the |
static String |
Activity Extra: Enable or disable Battery saver mode. |
static String |
Activity Extra: The minimum strength to request enrollment for. |
static String |
Activity Extra: An |
static String |
Activity Extra: The |
static String |
Activity Extra: The |
static String |
Activity Extra: Enable or disable Do Not Disturb mode. |
static String |
Activity Extra: How many minutes to enable do not disturb mode for. |
static String |
Activity Extra: The SSID that the Enrollee tried to connect to. |
static String |
Activity Extra: The Band List that the Enrollee supports. |
static String |
Activity Extra: The Channel List that the Enrollee used to scan a network. |
static String |
Activity Extra: The Easy Connect operation error code |
static String | |
static String |
Activity Extra: What component name to show the notification listener permission page for. |
static String |
Activity Extra: Specify a key that indicates the menu item which should be highlighted on settings home menu. |
static String |
Activity Extra: Specify the intent for the |
static String |
An int extra specifying a subscription ID. |
static String |
Intent extra: The id of a setting restricted by supervisors. |
static String |
A bundle extra of |
static String |
A bundle extra of the result of |
static String |
Activity Category: Show application settings related to usage access. |
static String |
Metadata key: Reason for needing usage access. |
static Int |
Settings for supervisors to control what kinds of biometric sensors, such a face and fingerprint scanners, can be used on the device. |
static Int |
The unknown setting can usually be ignored and is used for compatibility with future supervisor settings. |
Public constructors | |
---|---|
Settings() |
Public methods | |
---|---|
static Boolean |
canDrawOverlays(context: Context!) Checks if the specified context can draw on top of other apps. |
Constants
ACTION_ACCESSIBILITY_SETTINGS
static val ACTION_ACCESSIBILITY_SETTINGS: String
Activity Action: Show settings for accessibility modules.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.ACCESSIBILITY_SETTINGS"
ACTION_ADD_ACCOUNT
static val ACTION_ADD_ACCOUNT: String
Activity Action: Show add account screen for creating a new account.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
The account types available to add may be restricted by adding an EXTRA_AUTHORITIES
extra to the Intent with one or more syncable content provider's authorities. Only account types which can sync with that content provider will be offered to the user.
Account types can also be filtered by adding an EXTRA_ACCOUNT_TYPES
extra to the Intent with one or more account types.
Input: Nothing.
Output: Nothing.
Value: "android.settings.ADD_ACCOUNT_SETTINGS"
ACTION_ADVANCED_MEMORY_PROTECTION_SETTINGS
static val ACTION_ADVANCED_MEMORY_PROTECTION_SETTINGS: String
Activity Action: Show settings to allow configuration of Advanced memory protection.
Memory Tagging Extension (MTE) is a CPU extension that allows to protect against certain classes of security problems at a small runtime performance cost overhead.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.ADVANCED_MEMORY_PROTECTION_SETTINGS"
ACTION_AIRPLANE_MODE_SETTINGS
static val ACTION_AIRPLANE_MODE_SETTINGS: String
Activity Action: Show settings to allow entering/exiting airplane mode.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.AIRPLANE_MODE_SETTINGS"
ACTION_ALL_APPS_NOTIFICATION_SETTINGS
static val ACTION_ALL_APPS_NOTIFICATION_SETTINGS: String
Activity Action: Show app listing settings, filtered by those that send notifications.
Value: "android.settings.ALL_APPS_NOTIFICATION_SETTINGS"
ACTION_APN_SETTINGS
static val ACTION_APN_SETTINGS: String
Activity Action: Show settings to allow configuration of APNs.
Input: Nothing.
Output: Nothing.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Value: "android.settings.APN_SETTINGS"
ACTION_APPLICATION_DETAILS_SETTINGS
static val ACTION_APPLICATION_DETAILS_SETTINGS: String
Activity Action: Show screen of details about a particular application.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: The Intent's data URI specifies the application package name to be shown, with the "package" scheme. That is "package:com.my.app".
Output: Nothing.
Value: "android.settings.APPLICATION_DETAILS_SETTINGS"
ACTION_APPLICATION_DEVELOPMENT_SETTINGS
static val ACTION_APPLICATION_DEVELOPMENT_SETTINGS: String
Activity Action: Show settings to allow configuration of application development-related settings. As of android.os.Build.VERSION_CODES#JELLY_BEAN_MR1
this action is a required part of the platform.
Input: Nothing.
Output: Nothing.
Value: "android.settings.APPLICATION_DEVELOPMENT_SETTINGS"
ACTION_APPLICATION_SETTINGS
static val ACTION_APPLICATION_SETTINGS: String
Activity Action: Show settings to allow configuration of application-related settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.APPLICATION_SETTINGS"
ACTION_APP_LOCALE_SETTINGS
static val ACTION_APP_LOCALE_SETTINGS: String
Activity Action: Show settings to allow configuration of per application locale.
Input: The Intent's data URI can specify the application package name to directly invoke the app locale details GUI specific to the package name. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.APP_LOCALE_SETTINGS"
ACTION_APP_NOTIFICATION_BUBBLE_SETTINGS
static val ACTION_APP_NOTIFICATION_BUBBLE_SETTINGS: String
Activity Action: Show notification bubble settings for a single app. See NotificationManager#getBubblePreference()
.
Input: EXTRA_APP_PACKAGE
, the package to display.
Output: Nothing.
Value: "android.settings.APP_NOTIFICATION_BUBBLE_SETTINGS"
ACTION_APP_NOTIFICATION_SETTINGS
static val ACTION_APP_NOTIFICATION_SETTINGS: String
Activity Action: Show notification settings for a single app.
Input: EXTRA_APP_PACKAGE
, the package to display.
Output: Nothing.
Value: "android.settings.APP_NOTIFICATION_SETTINGS"
ACTION_APP_OPEN_BY_DEFAULT_SETTINGS
static val ACTION_APP_OPEN_BY_DEFAULT_SETTINGS: String
Activity Action: Show the "Open by Default" page in a particular application's details page.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: The Intent's data URI specifies the application package name to be shown, with the "package" scheme. That is "package:com.my.app".
Output: Nothing.
Value: "android.settings.APP_OPEN_BY_DEFAULT_SETTINGS"
ACTION_APP_SEARCH_SETTINGS
static val ACTION_APP_SEARCH_SETTINGS: String
Activity action: Show Settings app search UI when this action is available for device.
Input: Nothing.
Output: Nothing.
Value: "android.settings.APP_SEARCH_SETTINGS"
ACTION_APP_USAGE_SETTINGS
static val ACTION_APP_USAGE_SETTINGS: String
Activity Action: Show screen for controlling app usage properties for an app. Input: Intent's extra android.content.Intent#EXTRA_PACKAGE_NAME
must specify the application package name. Output: Nothing.
Value: "android.settings.action.APP_USAGE_SETTINGS"
ACTION_AUTOMATIC_ZEN_RULE_SETTINGS
static val ACTION_AUTOMATIC_ZEN_RULE_SETTINGS: String
Activity Action: Shows the settings page for an AutomaticZenRule
mode.
Users can change the behavior of the mode when it's activated and access the owning app's additional configuration screen, where triggering criteria can be modified (see AutomaticZenRule#setConfigurationActivity(ComponentName)
).
A matching Activity will only be found if NotificationManager#areAutomaticZenRulesUserManaged()
is true.
Input: The id of the rule, provided in the EXTRA_AUTOMATIC_ZEN_RULE_ID
extra.
Output: Nothing.
Value: "android.settings.AUTOMATIC_ZEN_RULE_SETTINGS"
ACTION_AUTO_ROTATE_SETTINGS
static val ACTION_AUTO_ROTATE_SETTINGS: String
Activity Action: Show Auto Rotate configuration settings.
Value: "android.settings.AUTO_ROTATE_SETTINGS"
ACTION_BATTERY_SAVER_SETTINGS
static val ACTION_BATTERY_SAVER_SETTINGS: String
Activity Action: Show battery saver settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Value: "android.settings.BATTERY_SAVER_SETTINGS"
ACTION_BIOMETRIC_ENROLL
static val ACTION_BIOMETRIC_ENROLL: String
Activity Action: Show settings to enroll biometrics, and setup PIN/Pattern/Pass if necessary. By default, this prompts the user to enroll biometrics with strength Weak or above, as defined by the CDD. Only biometrics that meet or exceed Strong, as defined in the CDD are allowed to participate in Keystore operations.
Input: extras EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED
as an integer, with constants defined in android.hardware.biometrics.BiometricManager.Authenticators
, e.g. android.hardware.biometrics.BiometricManager.Authenticators#BIOMETRIC_STRONG
. If not specified, the default behavior is android.hardware.biometrics.BiometricManager.Authenticators#BIOMETRIC_WEAK
.
Output: Nothing. Note that callers should still check android.hardware.biometrics.BiometricManager#canAuthenticate(int)
afterwards to ensure that the user actually completed enrollment.
Value: "android.settings.BIOMETRIC_ENROLL"
ACTION_BLUETOOTH_SETTINGS
static val ACTION_BLUETOOTH_SETTINGS: String
Activity Action: Show settings to allow configuration of Bluetooth.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.BLUETOOTH_SETTINGS"
ACTION_CAPTIONING_SETTINGS
static val ACTION_CAPTIONING_SETTINGS: String
Activity Action: Show settings for video captioning.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.CAPTIONING_SETTINGS"
ACTION_CAST_SETTINGS
static val ACTION_CAST_SETTINGS: String
Activity Action: Show settings to allow configuration of cast endpoints.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.CAST_SETTINGS"
ACTION_CHANNEL_NOTIFICATION_SETTINGS
static val ACTION_CHANNEL_NOTIFICATION_SETTINGS: String
Activity Action: Show notification settings for a single NotificationChannel
.
Input: EXTRA_APP_PACKAGE
, the package containing the channel to display. Input: EXTRA_CHANNEL_ID
, the id of the channel to display.
Output: Nothing.
Value: "android.settings.CHANNEL_NOTIFICATION_SETTINGS"
ACTION_CONDITION_PROVIDER_SETTINGS
static val ACTION_CONDITION_PROVIDER_SETTINGS: String
Activity Action: Show the automatic do not disturb rule listing page
Users can add, enable, disable, and remove automatic do not disturb rules from this screen. See NotificationManager#addAutomaticZenRule(AutomaticZenRule)
for more details.
Input: Nothing Output: Nothing
Value: "android.settings.ACTION_CONDITION_PROVIDER_SETTINGS"
ACTION_CREDENTIAL_PROVIDER
static val ACTION_CREDENTIAL_PROVIDER: String
Activity Action: Show screen that let user enable a Credential Manager provider.
Input: Intent's data URI set with an application name, using the "package" schema (like "package:com.my.app").
Output: android.app.Activity#RESULT_OK
if user selected a provider belonging to the caller package.
NOTE: Applications should call android.credentials.CredentialManager#isEnabledCredentialProviderService( * ComponentName)
and only use this action to start an activity if they return false
.
Value: "android.settings.CREDENTIAL_PROVIDER"
ACTION_DATA_ROAMING_SETTINGS
static val ACTION_DATA_ROAMING_SETTINGS: String
Activity Action: Show settings for selection of 2G/3G.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.DATA_ROAMING_SETTINGS"
ACTION_DATA_USAGE_SETTINGS
static val ACTION_DATA_USAGE_SETTINGS: String
Activity Action: Show settings to allow configuration of data and view data usage.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.DATA_USAGE_SETTINGS"
ACTION_DATE_SETTINGS
static val ACTION_DATE_SETTINGS: String
Activity Action: Show settings to allow configuration of date and time.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.DATE_SETTINGS"
ACTION_DEVICE_INFO_SETTINGS
static val ACTION_DEVICE_INFO_SETTINGS: String
Activity Action: Show general device information settings (serial number, software version, phone number, etc.).
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing
Value: "android.settings.DEVICE_INFO_SETTINGS"
ACTION_DISPLAY_SETTINGS
static val ACTION_DISPLAY_SETTINGS: String
Activity Action: Show settings to allow configuration of display.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.DISPLAY_SETTINGS"
ACTION_DREAM_SETTINGS
static val ACTION_DREAM_SETTINGS: String
Activity Action: Show Daydream settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.DREAM_SETTINGS"
See Also
ACTION_FINGERPRINT_ENROLL
static valACTION_FINGERPRINT_ENROLL: String
Deprecated: See Input: Nothing. Output: Nothing.ACTION_BIOMETRIC_ENROLL
.
Activity Action: Show settings to enroll fingerprints, and setup PIN/Pattern/Pass if necessary.
Value: "android.settings.FINGERPRINT_ENROLL"
ACTION_HARD_KEYBOARD_SETTINGS
static val ACTION_HARD_KEYBOARD_SETTINGS: String
Activity Action: Show settings to configure the hardware keyboard.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.HARD_KEYBOARD_SETTINGS"
ACTION_HOME_SETTINGS
static val ACTION_HOME_SETTINGS: String
Activity Action: Show Home selection settings. If there are multiple activities that can satisfy the Intent#CATEGORY_HOME
intent, this screen allows you to pick your preferred activity.
Value: "android.settings.HOME_SETTINGS"
ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS
static val ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS: String
Activity Action: Show screen for controlling background data restrictions for a particular application.
Input: Intent's data URI set with an application name, using the "package" schema (like "package:com.my.app").
Output: Nothing.
Applications can also use ConnectivityManager#getRestrictBackgroundStatus()
to determine the status of the background data restrictions for them.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Value: "android.settings.IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS"
ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS
static val ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS: String
Activity Action: Show screen for controlling which apps can ignore battery optimizations.
Input: Nothing.
Output: Nothing.
You can use PowerManager.isIgnoringBatteryOptimizations()
to determine if an application is already ignoring optimizations. You can use ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
to ask the user to put you on this list.
Value: "android.settings.IGNORE_BATTERY_OPTIMIZATION_SETTINGS"
ACTION_INPUT_METHOD_SETTINGS
static val ACTION_INPUT_METHOD_SETTINGS: String
Activity Action: Show settings to configure input methods, in particular allowing the user to enable input methods.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.INPUT_METHOD_SETTINGS"
ACTION_INPUT_METHOD_SUBTYPE_SETTINGS
static val ACTION_INPUT_METHOD_SUBTYPE_SETTINGS: String
Activity Action: Show settings to enable/disable input method subtypes.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
To tell which input method's subtypes are displayed in the settings, add EXTRA_INPUT_METHOD_ID
extra to this Intent with the input method id. If there is no extra in this Intent, subtypes from all installed input methods will be displayed in the settings.
Value: "android.settings.INPUT_METHOD_SUBTYPE_SETTINGS"
ACTION_INTERNAL_STORAGE_SETTINGS
static val ACTION_INTERNAL_STORAGE_SETTINGS: String
Activity Action: Show settings for internal storage.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.INTERNAL_STORAGE_SETTINGS"
ACTION_LOCALE_SETTINGS
static val ACTION_LOCALE_SETTINGS: String
Activity Action: Show settings to allow configuration of locale.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: The optional EXTRA_EXPLICIT_LOCALES
with language tags that contains locales to limit available locales. This is only supported when device is under demo mode. If intent does not contain this extra, it will show system supported locale list.
If EXTRA_EXPLICIT_LOCALES
contain a unsupported locale, it will still show this locale on list, but may not be supported by the devcie. Output: Nothing.
Value: "android.settings.LOCALE_SETTINGS"
ACTION_LOCATION_SOURCE_SETTINGS
static val ACTION_LOCATION_SOURCE_SETTINGS: String
Activity Action: Show settings to allow configuration of current location sources.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.LOCATION_SOURCE_SETTINGS"
ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS
static val ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS: String
Activity Action: Show settings to manage all applications.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.MANAGE_ALL_APPLICATIONS_SETTINGS"
ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION
static val ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION: String
Activity Action: Show screen for controlling which apps have access to manage external storage.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
If you want to control a specific app's access to manage external storage, use ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION
instead.
Output: Nothing.
Value: "android.settings.MANAGE_ALL_FILES_ACCESS_PERMISSION"
ACTION_MANAGE_ALL_SIM_PROFILES_SETTINGS
static val ACTION_MANAGE_ALL_SIM_PROFILES_SETTINGS: String
Activity Action: Show settings to manage all SIM profiles.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.MANAGE_ALL_SIM_PROFILES_SETTINGS"
ACTION_MANAGE_APPLICATIONS_SETTINGS
static val ACTION_MANAGE_APPLICATIONS_SETTINGS: String
Activity Action: Show settings to manage installed applications.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.MANAGE_APPLICATIONS_SETTINGS"
ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION
static val ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION: String
Activity Action: Show screen for controlling if the app specified in the data URI of the intent can manage external storage.
Launching the corresponding activity requires the permission Manifest.permission#MANAGE_EXTERNAL_STORAGE
.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: The Intent's data URI MUST specify the application package name whose ability of managing external storage you want to control. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.MANAGE_APP_ALL_FILES_ACCESS_PERMISSION"
ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT
static val ACTION_MANAGE_APP_USE_FULL_SCREEN_INTENT: String
Activity Action: Show screen for controlling whether an app can send full screen intents.
Input: the intent's data URI must specify the application package name for which you want to manage full screen intents.
Output: Nothing.
Value: "android.settings.MANAGE_APP_USE_FULL_SCREEN_INTENT"
ACTION_MANAGE_DEFAULT_APPS_SETTINGS
static val ACTION_MANAGE_DEFAULT_APPS_SETTINGS: String
Activity Action: Show Default apps settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.MANAGE_DEFAULT_APPS_SETTINGS"
ACTION_MANAGE_OVERLAY_PERMISSION
static val ACTION_MANAGE_OVERLAY_PERMISSION: String
Activity Action: Show screen for controlling which apps can draw on top of other apps.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Optionally, in versions of Android prior to android.os.Build.VERSION_CODES#R
, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.action.MANAGE_OVERLAY_PERMISSION"
ACTION_MANAGE_SUPERVISOR_RESTRICTED_SETTING
static val ACTION_MANAGE_SUPERVISOR_RESTRICTED_SETTING: String
Activity action: Launch UI to manage a setting restricted by supervisors.
Input: EXTRA_SUPERVISOR_RESTRICTED_SETTING_KEY
specifies what setting to open.
Output: Nothing.
Value: "android.settings.MANAGE_SUPERVISOR_RESTRICTED_SETTING"
ACTION_MANAGE_UNKNOWN_APP_SOURCES
static val ACTION_MANAGE_UNKNOWN_APP_SOURCES: String
Activity Action: Show settings to allow configuration of trusted external sources Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.MANAGE_UNKNOWN_APP_SOURCES"
ACTION_MANAGE_WRITE_SETTINGS
static val ACTION_MANAGE_WRITE_SETTINGS: String
Activity Action: Show screen for controlling which apps are allowed to write/modify system settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.action.MANAGE_WRITE_SETTINGS"
ACTION_MEMORY_CARD_SETTINGS
static val ACTION_MEMORY_CARD_SETTINGS: String
Activity Action: Show settings for memory card storage.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.MEMORY_CARD_SETTINGS"
ACTION_NETWORK_OPERATOR_SETTINGS
static val ACTION_NETWORK_OPERATOR_SETTINGS: String
Activity Action: Show settings for selecting the network operator.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
The subscription ID of the subscription for which available network operators should be displayed may be optionally specified with EXTRA_SUB_ID
.
Input: Nothing.
Output: Nothing.
Value: "android.settings.NETWORK_OPERATOR_SETTINGS"
ACTION_NFCSHARING_SETTINGS
static val ACTION_NFCSHARING_SETTINGS: String
Activity Action: Show NFC Sharing settings.
This shows UI that allows NDEF Push (Android Beam) to be turned on or off.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing
Value: "android.settings.NFCSHARING_SETTINGS"
ACTION_NFC_PAYMENT_SETTINGS
static val ACTION_NFC_PAYMENT_SETTINGS: String
Activity Action: Show NFC Tap & Pay settings
This shows UI that allows the user to configure Tap&Pay settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing
Value: "android.settings.NFC_PAYMENT_SETTINGS"
ACTION_NFC_SETTINGS
static val ACTION_NFC_SETTINGS: String
Activity Action: Show NFC settings.
This shows UI that allows NFC to be turned on or off.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing
Value: "android.settings.NFC_SETTINGS"
See Also
ACTION_NIGHT_DISPLAY_SETTINGS
static val ACTION_NIGHT_DISPLAY_SETTINGS: String
Activity Action: Show settings to allow configuration of Night display.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.NIGHT_DISPLAY_SETTINGS"
ACTION_NOTIFICATION_ASSISTANT_SETTINGS
static val ACTION_NOTIFICATION_ASSISTANT_SETTINGS: String
Activity Action: Show Notification assistant settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.NOTIFICATION_ASSISTANT_SETTINGS"
ACTION_NOTIFICATION_LISTENER_DETAIL_SETTINGS
static val ACTION_NOTIFICATION_LISTENER_DETAIL_SETTINGS: String
Activity Action: Show notification listener permission settings page for app.
Users can grant and deny access to notifications for a ComponentName
from here. See android.app.NotificationManager#isNotificationListenerAccessGranted(ComponentName)
for more details.
Input: The extra EXTRA_NOTIFICATION_LISTENER_COMPONENT_NAME
containing the name of the component to grant or revoke notification listener access to.
Output: Nothing.
Value: "android.settings.NOTIFICATION_LISTENER_DETAIL_SETTINGS"
ACTION_NOTIFICATION_LISTENER_SETTINGS
static val ACTION_NOTIFICATION_LISTENER_SETTINGS: String
Activity Action: Show Notification listener settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS"
ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS
static val ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS: String
Activity Action: Show Do Not Disturb access settings.
Users can grant and deny access to Do Not Disturb configuration from here. Managed profiles cannot grant Do Not Disturb access. See android.app.NotificationManager#isNotificationPolicyAccessGranted()
for more details.
Input: Nothing.
Output: Nothing.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Value: "android.settings.NOTIFICATION_POLICY_ACCESS_SETTINGS"
ACTION_PRINT_SETTINGS
static val ACTION_PRINT_SETTINGS: String
Activity Action: Show the top level print settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.ACTION_PRINT_SETTINGS"
ACTION_PRIVACY_SETTINGS
static val ACTION_PRIVACY_SETTINGS: String
Activity Action: Show settings to allow configuration of privacy options, i.e. permission manager, privacy dashboard, privacy controls and more.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.PRIVACY_SETTINGS"
ACTION_PROCESS_WIFI_EASY_CONNECT_URI
static val ACTION_PROCESS_WIFI_EASY_CONNECT_URI: String
Activity Action: Show setting page to process a Wi-Fi Easy Connect (aka DPP) URI and start configuration. This intent should be used when you want to use this device to take on the configurator role for an IoT/other device. When provided with a valid DPP URI string, Settings will open a Wi-Fi selection screen for the user to indicate which network they would like to configure the device specified in the DPP URI string and carry them through the rest of the flow for provisioning the device.
In some cases, a matching Activity may not exist, so ensure to safeguard against this by checking WifiManager#isEasyConnectSupported()
.
Input: The Intent's data URI specifies bootstrapping information for authenticating and provisioning the peer, and uses a "DPP" scheme. The URI should be attached to the intent using Intent#setData(Uri)
. The calling app can obtain a DPP URI in any way, e.g. by scanning a QR code or other out-of-band methods. The calling app may also attach the EXTRA_EASY_CONNECT_BAND_LIST
extra to provide information about the bands supported by the enrollee device.
Output: After calling android.app.Activity#startActivityForResult, the callback onActivityResult
will have resultCode android.app.Activity#RESULT_OK
if the Wi-Fi Easy Connect configuration succeeded and the user tapped the 'Done' button, or android.app.Activity#RESULT_CANCELED
if the operation failed and user tapped the 'Cancel' button. In case the operation has failed, a status code from android.net.wifi.EasyConnectStatusCallback
EASY_CONNECT_EVENT_FAILURE_*
will be returned as an Extra EXTRA_EASY_CONNECT_ERROR_CODE
. Easy Connect R2 Enrollees report additional details about the error they encountered, which will be provided in the EXTRA_EASY_CONNECT_ATTEMPTED_SSID
, EXTRA_EASY_CONNECT_CHANNEL_LIST
, and EXTRA_EASY_CONNECT_BAND_LIST
.
Value: "android.settings.PROCESS_WIFI_EASY_CONNECT_URI"
ACTION_QUICK_ACCESS_WALLET_SETTINGS
static val ACTION_QUICK_ACCESS_WALLET_SETTINGS: String
Activity Action: Show screen for controlling the Quick Access Wallet.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.QUICK_ACCESS_WALLET_SETTINGS"
ACTION_QUICK_LAUNCH_SETTINGS
static val ACTION_QUICK_LAUNCH_SETTINGS: String
Activity Action: Show settings to allow configuration of quick launch shortcuts.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.QUICK_LAUNCH_SETTINGS"
ACTION_REGIONAL_PREFERENCES_SETTINGS
static val ACTION_REGIONAL_PREFERENCES_SETTINGS: String
Activity Action: Show settings to allow configuration of regional preferences
Input: Nothing
Output: Nothing.
Value: "android.settings.REGIONAL_PREFERENCES_SETTINGS"
ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
static val ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS: String
Activity Action: Ask the user to allow an app to ignore battery optimizations (that is, put them on the allowlist of apps shown by ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS
). For an app to use this, it also must hold the android.Manifest.permission#REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
permission.
Note: most applications should not use this; there are many facilities provided by the platform for applications to operate correctly in the various power saving modes. This is only for unusual applications that need to deeply control their own execution, at the potential expense of the user's battery life. Note that these applications greatly run the risk of showing to the user as high power consumers on their device.
Input: The Intent's data URI must specify the application package name to be shown, with the "package" scheme. That is "package:com.my.app".
Output: Nothing.
You can use PowerManager.isIgnoringBatteryOptimizations()
to determine if an application is already ignoring optimizations.
Value: "android.settings.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS"
ACTION_REQUEST_MANAGE_MEDIA
static val ACTION_REQUEST_MANAGE_MEDIA: String
Activity Action: Show settings to allow configuration of Manifest.permission#MANAGE_MEDIA
permission Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app".
Output: Nothing.
Value: "android.settings.REQUEST_MANAGE_MEDIA"
ACTION_REQUEST_MEDIA_ROUTING_CONTROL
static val ACTION_REQUEST_MEDIA_ROUTING_CONTROL: String
Activity Action: Show settings to allow configuration of Manifest.permission#MEDIA_ROUTING_CONTROL
permission. Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app". However, modifying this permission setting for any package is allowed only when that package holds an appropriate companion device profile such as android.companion.AssociationRequest#DEVICE_PROFILE_WATCH
.
Output: Nothing.
Value: "android.settings.REQUEST_MEDIA_ROUTING_CONTROL"
ACTION_REQUEST_SCHEDULE_EXACT_ALARM
static val ACTION_REQUEST_SCHEDULE_EXACT_ALARM: String
Activity Action: Show settings to allow configuration of Manifest.permission#SCHEDULE_EXACT_ALARM
permission Input: Optionally, the Intent's data URI can specify the application package name to directly invoke the management GUI specific to the package name. For example "package:com.my.app".
Output: When a package data uri is passed as input, the activity result is set to android.app.Activity#RESULT_OK
if the permission was granted to the app. Otherwise, the result is set to android.app.Activity#RESULT_CANCELED
.
Value: "android.settings.REQUEST_SCHEDULE_EXACT_ALARM"
ACTION_REQUEST_SET_AUTOFILL_SERVICE
static val ACTION_REQUEST_SET_AUTOFILL_SERVICE: String
Activity Action: Show screen that let user select its Autofill Service.
Input: Intent's data URI set with an application name, using the "package" schema (like "package:com.my.app").
Output: android.app.Activity#RESULT_OK
if user selected an Autofill Service belonging to the caller package.
NOTE: Applications should call android.view.autofill.AutofillManager#hasEnabledAutofillServices()
and android.view.autofill.AutofillManager#isAutofillSupported()
, and only use this action to start an activity if they return false
and true
respectively.
Value: "android.settings.REQUEST_SET_AUTOFILL_SERVICE"
ACTION_SATELLITE_SETTING
static val ACTION_SATELLITE_SETTING: String
Activity Action: Show settings to provide guide about carrier satellite messaging.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SATELLITE_SETTING"
ACTION_SEARCH_SETTINGS
static val ACTION_SEARCH_SETTINGS: String
Activity Action: Show settings for global search.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing
Value: "android.search.action.SEARCH_SETTINGS"
ACTION_SECURITY_SETTINGS
static val ACTION_SECURITY_SETTINGS: String
Activity Action: Show settings to allow configuration of security and location privacy.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SECURITY_SETTINGS"
ACTION_SETTINGS
static val ACTION_SETTINGS: String
Activity Action: Show system settings.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SETTINGS"
ACTION_SETTINGS_EMBED_DEEP_LINK_ACTIVITY
static val ACTION_SETTINGS_EMBED_DEEP_LINK_ACTIVITY: String
Activity Action: For system or preinstalled apps to show their Activity
embedded in Settings app on large screen devices. Developers should resolve the Intent action before using it.
Input: EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_INTENT_URI
must be included to specify the intent for the activity which will be embedded in Settings app. It's an intent URI string from intent.toUri(Intent.URI_INTENT_SCHEME)
. Input: EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_HIGHLIGHT_MENU_KEY
must be included to specify a key that indicates the menu item which will be highlighted on settings home menu.
Output: Nothing.
Value: "android.settings.SETTINGS_EMBED_DEEP_LINK_ACTIVITY"
ACTION_SHOW_REGULATORY_INFO
static val ACTION_SHOW_REGULATORY_INFO: String
Activity Action: Show the regulatory information screen for the device.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SHOW_REGULATORY_INFO"
ACTION_SHOW_WORK_POLICY_INFO
static val ACTION_SHOW_WORK_POLICY_INFO: String
Activity Action: Show Work Policy info. DPC apps can implement an activity that handles this intent in order to show device policies associated with the work profile or managed device.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SHOW_WORK_POLICY_INFO"
ACTION_SOUND_SETTINGS
static val ACTION_SOUND_SETTINGS: String
Activity Action: Show settings to allow configuration of sound and volume.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SOUND_SETTINGS"
ACTION_STORAGE_VOLUME_ACCESS_SETTINGS
static valACTION_STORAGE_VOLUME_ACCESS_SETTINGS: String
Deprecated: use ACTION_APPLICATION_DETAILS_SETTINGS
to manage storage permissions for a specific application
Activity Action: Show screen for controlling which apps have access on volume directories.
Input: Nothing.
Output: Nothing.
Applications typically use this action to ask the user to revert the "Do not ask again" status of directory access requests made by android.os.storage.StorageVolume#createAccessIntent(String)
.
Value: "android.settings.STORAGE_VOLUME_ACCESS_SETTINGS"
ACTION_SYNC_SETTINGS
static val ACTION_SYNC_SETTINGS: String
Activity Action: Show settings to allow configuration of sync settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
The account types available to add via the add account button may be restricted by adding an EXTRA_AUTHORITIES
extra to this Intent with one or more syncable content provider's authorities. Only account types which can sync with that content provider will be offered to the user.
Input: Nothing.
Output: Nothing.
Value: "android.settings.SYNC_SETTINGS"
ACTION_USAGE_ACCESS_SETTINGS
static val ACTION_USAGE_ACCESS_SETTINGS: String
Activity Action: Show settings to control access to usage information.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.USAGE_ACCESS_SETTINGS"
ACTION_USER_DICTIONARY_SETTINGS
static val ACTION_USER_DICTIONARY_SETTINGS: String
Activity Action: Show settings to manage the user input dictionary.
Starting with android.os.Build.VERSION_CODES#KITKAT
, it is guaranteed there will always be an appropriate implementation for this Intent action. In prior releases of the platform this was optional, so ensure you safeguard against it.
Input: Nothing.
Output: Nothing.
Value: "android.settings.USER_DICTIONARY_SETTINGS"
ACTION_VOICE_CONTROL_AIRPLANE_MODE
static val ACTION_VOICE_CONTROL_AIRPLANE_MODE: String
Activity Action: Modify Airplane mode settings using a voice command.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
This intent MUST be started using startVoiceActivity
.
Note: The activity implementing this intent MUST verify that isVoiceInteraction
returns true before modifying the setting.
Input: To tell which state airplane mode should be set to, add the EXTRA_AIRPLANE_MODE_ENABLED
extra to this Intent with the state specified. If the extra is not included, no changes will be made.
Output: Nothing.
Value: "android.settings.VOICE_CONTROL_AIRPLANE_MODE"
ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE
static val ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE: String
Activity Action: Modify Battery Saver mode setting using a voice command.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
This intent MUST be started using startVoiceActivity
.
Note: The activity implementing this intent MUST verify that isVoiceInteraction
returns true before modifying the setting.
Input: To tell which state batter saver mode should be set to, add the EXTRA_BATTERY_SAVER_MODE_ENABLED
extra to this Intent with the state specified. If the extra is not included, no changes will be made.
Output: Nothing.
Value: "android.settings.VOICE_CONTROL_BATTERY_SAVER_MODE"
ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE
static val ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE: String
Activity Action: Modify do not disturb mode settings.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
This intent MUST be started using startVoiceActivity
.
Note: The Activity implementing this intent MUST verify that isVoiceInteraction
. returns true before modifying the setting.
Input: The optional EXTRA_DO_NOT_DISTURB_MODE_MINUTES
extra can be used to indicate how long the user wishes to avoid interruptions for. The optional EXTRA_DO_NOT_DISTURB_MODE_ENABLED
extra can be to indicate if the user is enabling or disabling do not disturb mode. If either extra is not included, the user maybe asked to provide the value.
Output: Nothing.
Value: "android.settings.VOICE_CONTROL_DO_NOT_DISTURB_MODE"
ACTION_VOICE_INPUT_SETTINGS
static val ACTION_VOICE_INPUT_SETTINGS: String
Activity Action: Show settings to configure input methods, in particular allowing the user to enable input methods.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.VOICE_INPUT_SETTINGS"
ACTION_VPN_SETTINGS
static val ACTION_VPN_SETTINGS: String
Activity Action: Show settings to allow configuration of VPN.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.VPN_SETTINGS"
ACTION_VR_LISTENER_SETTINGS
static val ACTION_VR_LISTENER_SETTINGS: String
Activity Action: Show VR listener settings.
Input: Nothing.
Output: Nothing.
Value: "android.settings.VR_LISTENER_SETTINGS"
See Also
ACTION_WEBVIEW_SETTINGS
static val ACTION_WEBVIEW_SETTINGS: String
Activity Action: Allows user to select current webview implementation.
Input: Nothing.
Output: Nothing.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Value: "android.settings.WEBVIEW_SETTINGS"
ACTION_WIFI_ADD_NETWORKS
static val ACTION_WIFI_ADD_NETWORKS: String
Activity Action: Show setting page to process the addition of Wi-Fi networks to the user's saved network list. The app should send a new intent with an extra that holds a maximum of five android.net.wifi.WifiNetworkSuggestion
that specify credentials for the networks to be added to the user's database. The Intent should be sent via the android.app.Activity#startActivityForResult(Intent, int)
API.
Note: The app sending the Intent to add the credentials doesn't get any ownership over the newly added network(s). For the Wi-Fi stack, these networks will look like the user manually added them from the Settings UI.
Input: The app should put parcelable array list of android.net.wifi.WifiNetworkSuggestion
into the EXTRA_WIFI_NETWORK_LIST
extra.
Output: After android.app.Activity#startActivityForResult(Intent, int)
, the callback android.app.Activity#onActivityResult(int, int, Intent)
will have a result code android.app.Activity#RESULT_OK
to indicate user pressed the save button to save the networks or android.app.Activity#RESULT_CANCELED
to indicate that the user rejected the request. Additionally, an integer array list, stored in EXTRA_WIFI_NETWORK_RESULT_LIST
, will indicate the process result of each network.
Value: "android.settings.WIFI_ADD_NETWORKS"
ACTION_WIFI_IP_SETTINGS
static val ACTION_WIFI_IP_SETTINGS: String
Activity Action: Show settings to allow configuration of a static IP address for Wi-Fi.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.WIFI_IP_SETTINGS"
ACTION_WIFI_SETTINGS
static val ACTION_WIFI_SETTINGS: String
Activity Action: Show settings to allow configuration of Wi-Fi.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.WIFI_SETTINGS"
ACTION_WIRELESS_SETTINGS
static val ACTION_WIRELESS_SETTINGS: String
Activity Action: Show settings to allow configuration of wireless controls such as Wi-Fi, Bluetooth and Mobile networks.
In some cases, a matching Activity may not exist, so ensure you safeguard against this.
Input: Nothing.
Output: Nothing.
Value: "android.settings.WIRELESS_SETTINGS"
ACTION_ZEN_MODE_PRIORITY_SETTINGS
static val ACTION_ZEN_MODE_PRIORITY_SETTINGS: String
Activity Action: Show Zen Mode (aka Do Not Disturb) priority configuration settings.
Value: "android.settings.ZEN_MODE_PRIORITY_SETTINGS"
ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
static val ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED: Int
A result of ACTION_WIFI_ADD_NETWORKS
intent action that saving the corresponding Wi-Fi network failed.
Value: 1
ADD_WIFI_RESULT_ALREADY_EXISTS
static val ADD_WIFI_RESULT_ALREADY_EXISTS: Int
A result of ACTION_WIFI_ADD_NETWORKS
intent action that indicates the Wi-Fi network already exists.
Value: 2
ADD_WIFI_RESULT_SUCCESS
static val ADD_WIFI_RESULT_SUCCESS: Int
A result of ACTION_WIFI_ADD_NETWORKS
intent action that saving or updating the corresponding Wi-Fi network was successful.
Value: 0
EXTRA_ACCOUNT_TYPES
static val EXTRA_ACCOUNT_TYPES: String
Activity Extra: Limit available options in launched activity based on the given account types.
This can be passed as an extra field in an Activity Intent with one or more account types as a String[]. This field is used by some intents to alter the behavior of the called activity.
Example: The ACTION_ADD_ACCOUNT
intent restricts the account types to the specified list.
Value: "account_types"
EXTRA_AIRPLANE_MODE_ENABLED
static val EXTRA_AIRPLANE_MODE_ENABLED: String
Activity Extra: Enable or disable Airplane Mode.
This can be passed as an extra field to the ACTION_VOICE_CONTROL_AIRPLANE_MODE
intent as a boolean to indicate if it should be enabled.
Value: "airplane_mode_enabled"
EXTRA_APP_PACKAGE
static val EXTRA_APP_PACKAGE: String
Activity Extra: The package owner of the notification channel settings to display.
This must be passed as an extra field to the ACTION_CHANNEL_NOTIFICATION_SETTINGS
.
Value: "android.provider.extra.APP_PACKAGE"
EXTRA_AUTHORITIES
static val EXTRA_AUTHORITIES: String
Activity Extra: Limit available options in launched activity based on the given authority.
This can be passed as an extra field in an Activity Intent with one or more syncable content provider's authorities as a String[]. This field is used by some intents to alter the behavior of the called activity.
Example: The ACTION_ADD_ACCOUNT
intent restricts the account types available based on the authority given.
Value: "authorities"
EXTRA_AUTOMATIC_ZEN_RULE_ID
static val EXTRA_AUTOMATIC_ZEN_RULE_ID: String
Activity Extra: The String id of the mode
settings to display.
This must be passed as an extra field to the ACTION_AUTOMATIC_ZEN_RULE_SETTINGS
.
Value: "android.provider.extra.AUTOMATIC_ZEN_RULE_ID"
EXTRA_BATTERY_SAVER_MODE_ENABLED
static val EXTRA_BATTERY_SAVER_MODE_ENABLED: String
Activity Extra: Enable or disable Battery saver mode.
This can be passed as an extra field to the ACTION_VOICE_CONTROL_BATTERY_SAVER_MODE
intent as a boolean to indicate if it should be enabled.
Value: "android.settings.extra.battery_saver_mode_enabled"
EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED
static val EXTRA_BIOMETRIC_AUTHENTICATORS_ALLOWED: String
Activity Extra: The minimum strength to request enrollment for.
This can be passed as an extra field to the ACTION_BIOMETRIC_ENROLL
intent to indicate that only enrollment for sensors that meet these requirements should be shown. The value should be a combination of the constants defined in android.hardware.biometrics.BiometricManager.Authenticators
.
Value: "android.provider.extra.BIOMETRIC_AUTHENTICATORS_ALLOWED"
EXTRA_CHANNEL_FILTER_LIST
static val EXTRA_CHANNEL_FILTER_LIST: String
Activity Extra: An Arraylist<String>
of NotificationChannel
field names to show on the Settings UI.
This is an optional extra field to the ACTION_CHANNEL_NOTIFICATION_SETTINGS
. If included the system will filter out any Settings that doesn't appear in this list that otherwise would display.
Value: "android.provider.extra.CHANNEL_FILTER_LIST"
EXTRA_CHANNEL_ID
static val EXTRA_CHANNEL_ID: String
Activity Extra: The NotificationChannel#getId()
of the notification channel settings to display.
This must be passed as an extra field to the ACTION_CHANNEL_NOTIFICATION_SETTINGS
.
Value: "android.provider.extra.CHANNEL_ID"
EXTRA_CONVERSATION_ID
static val EXTRA_CONVERSATION_ID: String
Activity Extra: The NotificationChannel#getConversationId()
of the notification conversation settings to display.
This is an optional extra field to the ACTION_CHANNEL_NOTIFICATION_SETTINGS
. If included the system will first look up notification settings by channel and conversation id, and will fall back to channel id if a specialized channel for this conversation doesn't exist, similar to NotificationManager#getNotificationChannel(String, String)
.
Value: "android.provider.extra.CONVERSATION_ID"
EXTRA_DO_NOT_DISTURB_MODE_ENABLED
static val EXTRA_DO_NOT_DISTURB_MODE_ENABLED: String
Activity Extra: Enable or disable Do Not Disturb mode.
This can be passed as an extra field to the ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE
intent as a boolean to indicate if it should be enabled.
Value: "android.settings.extra.do_not_disturb_mode_enabled"
EXTRA_DO_NOT_DISTURB_MODE_MINUTES
static val EXTRA_DO_NOT_DISTURB_MODE_MINUTES: String
Activity Extra: How many minutes to enable do not disturb mode for.
This can be passed as an extra field to the ACTION_VOICE_CONTROL_DO_NOT_DISTURB_MODE
intent to indicate how long do not disturb mode should be enabled for.
Value: "android.settings.extra.do_not_disturb_mode_minutes"
EXTRA_EASY_CONNECT_ATTEMPTED_SSID
static val EXTRA_EASY_CONNECT_ATTEMPTED_SSID: String
Activity Extra: The SSID that the Enrollee tried to connect to.
An extra returned on the result intent received when using the ACTION_PROCESS_WIFI_EASY_CONNECT_URI
intent to launch the Easy Connect Operation. This extra contains the SSID of the Access Point that the remote Enrollee tried to connect to. This value is populated only by remote R2 devices, and only for the following error codes: android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_CANNOT_FIND_NETWORK
android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_ENROLLEE_AUTHENTICATION
. Therefore, always check if this extra is available using Intent#hasExtra(String)
. If there is no error, i.e. if the operation returns android.app.Activity#RESULT_OK
, then this extra is not attached to the result intent.
Use the Intent#getStringExtra(String)
to obtain the SSID.
Value: "android.provider.extra.EASY_CONNECT_ATTEMPTED_SSID"
EXTRA_EASY_CONNECT_BAND_LIST
static val EXTRA_EASY_CONNECT_BAND_LIST: String
Activity Extra: The Band List that the Enrollee supports.
This extra contains the bands the Enrollee supports, expressed as the Global Operating Class, see Table E-4 in IEEE Std 802.11-2016 Global operating classes. It is used both as input, to configure the Easy Connect operation and as output of the operation.
As input: an optional extra to be attached to the ACTION_PROCESS_WIFI_EASY_CONNECT_URI
. If attached, it indicates the bands which the remote device (enrollee, device-to-be-configured) supports. The Settings operation may take this into account when presenting the user with list of networks configurations to be used. The calling app may obtain this information in any out-of-band method. The information should be attached as an array of raw integers - using the Intent#putExtra(String, int[])
.
As output: an extra returned on the result intent received when using the ACTION_PROCESS_WIFI_EASY_CONNECT_URI
intent to launch the Easy Connect Operation . This value is populated only by remote R2 devices, and only for the following error codes: android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_CANNOT_FIND_NETWORK
, android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_ENROLLEE_AUTHENTICATION
, or android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_ENROLLEE_REJECTED_CONFIGURATION
. Therefore, always check if this extra is available using Intent#hasExtra(String)
. If there is no error, i.e. if the operation returns android.app.Activity#RESULT_OK
, then this extra is not attached to the result intent.
Use the Intent#getIntArrayExtra(String)
to obtain the list.
Value: "android.provider.extra.EASY_CONNECT_BAND_LIST"
EXTRA_EASY_CONNECT_CHANNEL_LIST
static val EXTRA_EASY_CONNECT_CHANNEL_LIST: String
Activity Extra: The Channel List that the Enrollee used to scan a network.
An extra returned on the result intent received when using the ACTION_PROCESS_WIFI_EASY_CONNECT_URI
intent to launch the Easy Connect Operation. This extra contains the channel list that the Enrollee scanned for a network. This value is populated only by remote R2 devices, and only for the following error code: android.net.wifi.EasyConnectStatusCallback#EASY_CONNECT_EVENT_FAILURE_CANNOT_FIND_NETWORK
. Therefore, always check if this extra is available using Intent#hasExtra(String)
. If there is no error, i.e. if the operation returns android.app.Activity#RESULT_OK
, then this extra is not attached to the result intent. The list is JSON formatted, as an array (Wi-Fi global operating classes) of arrays (Wi-Fi channels).
Use the Intent#getStringExtra(String)
to obtain the list.
Value: "android.provider.extra.EASY_CONNECT_CHANNEL_LIST"
EXTRA_EASY_CONNECT_ERROR_CODE
static val EXTRA_EASY_CONNECT_ERROR_CODE: String
Activity Extra: The Easy Connect operation error code
An extra returned on the result intent received when using the ACTION_PROCESS_WIFI_EASY_CONNECT_URI
intent to launch the Easy Connect Operation. This extra contains the integer error code of the operation - one of android.net.wifi.EasyConnectStatusCallback
EASY_CONNECT_EVENT_FAILURE_*
. If there is no error, i.e. if the operation returns android.app.Activity#RESULT_OK
, then this extra is not attached to the result intent.
Use the Intent#hasExtra(String)
to determine whether the extra is attached and Intent#getIntExtra(String, int)
to obtain the error code data.
Value: "android.provider.extra.EASY_CONNECT_ERROR_CODE"
EXTRA_INPUT_METHOD_ID
static val EXTRA_INPUT_METHOD_ID: String
Value: "input_method_id"
EXTRA_NOTIFICATION_LISTENER_COMPONENT_NAME
static val EXTRA_NOTIFICATION_LISTENER_COMPONENT_NAME: String
Activity Extra: What component name to show the notification listener permission page for.
A string extra containing a ComponentName
. This must be passed as an extra field to ACTION_NOTIFICATION_LISTENER_DETAIL_SETTINGS
.
Value: "android.provider.extra.NOTIFICATION_LISTENER_COMPONENT_NAME"
EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_HIGHLIGHT_MENU_KEY
static val EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_HIGHLIGHT_MENU_KEY: String
Activity Extra: Specify a key that indicates the menu item which should be highlighted on settings home menu.
This must be passed as an extra field to ACTION_SETTINGS_EMBED_DEEP_LINK_ACTIVITY
.
Value: "android.provider.extra.SETTINGS_EMBEDDED_DEEP_LINK_HIGHLIGHT_MENU_KEY"
EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_INTENT_URI
static val EXTRA_SETTINGS_EMBEDDED_DEEP_LINK_INTENT_URI: String
Activity Extra: Specify the intent for the Activity
which will be embedded in Settings app. It's an intent URI string from intent.toUri(Intent.URI_INTENT_SCHEME)
.
This must be passed as an extra field to ACTION_SETTINGS_EMBED_DEEP_LINK_ACTIVITY
.
Value: "android.provider.extra.SETTINGS_EMBEDDED_DEEP_LINK_INTENT_URI"
EXTRA_SUB_ID
static val EXTRA_SUB_ID: String
An int extra specifying a subscription ID.
Value: "android.provider.extra.SUB_ID"
EXTRA_SUPERVISOR_RESTRICTED_SETTING_KEY
static val EXTRA_SUPERVISOR_RESTRICTED_SETTING_KEY: String
Intent extra: The id of a setting restricted by supervisors.
Type: Integer with a value from the one of the SUPERVISOR_VERIFICATION_* constants below.
- {@see #SUPERVISOR_VERIFICATION_SETTING_UNKNOWN}
- {@see #SUPERVISOR_VERIFICATION_SETTING_BIOMETRICS}
Value: "android.provider.extra.SUPERVISOR_RESTRICTED_SETTING_KEY"
EXTRA_WIFI_NETWORK_LIST
static val EXTRA_WIFI_NETWORK_LIST: String
A bundle extra of ACTION_WIFI_ADD_NETWORKS
intent action that indicates the list of the android.net.wifi.WifiNetworkSuggestion
elements. The maximum count of the android.net.wifi.WifiNetworkSuggestion
elements in the list will be five.
For example: To provide credentials for one open and one WPA2 networks:
<code>final WifiNetworkSuggestion suggestion1 = new WifiNetworkSuggestion.Builder() .setSsid("test111111") .build(); final WifiNetworkSuggestion suggestion2 = new WifiNetworkSuggestion.Builder() .setSsid("test222222") .setWpa2Passphrase("test123456") .build(); final List<WifiNetworkSuggestion> suggestionsList = new ArrayList<>; suggestionsList.add(suggestion1); suggestionsList.add(suggestion2); Bundle bundle = new Bundle(); bundle.putParcelableArrayList(Settings.EXTRA_WIFI_NETWORK_LIST,(ArrayList<? extends Parcelable>) suggestionsList); final Intent intent = new Intent(Settings.ACTION_WIFI_ADD_NETWORKS); intent.putExtras(bundle); startActivityForResult(intent, 0); </code>
Value: "android.provider.extra.WIFI_NETWORK_LIST"
EXTRA_WIFI_NETWORK_RESULT_LIST
static val EXTRA_WIFI_NETWORK_RESULT_LIST: String
A bundle extra of the result of ACTION_WIFI_ADD_NETWORKS
intent action that indicates the action result of the saved android.net.wifi.WifiNetworkSuggestion
. Its value is a list of integers, and all the elements will be 1:1 mapping to the elements in EXTRA_WIFI_NETWORK_LIST
, if user press cancel to cancel the add networks request, then its value will be null.
Note: The integer value will be one of the ADD_WIFI_RESULT_SUCCESS
, ADD_WIFI_RESULT_ADD_OR_UPDATE_FAILED
, or ADD_WIFI_RESULT_ALREADY_EXISTS
}.
Value: "android.provider.extra.WIFI_NETWORK_RESULT_LIST"
INTENT_CATEGORY_USAGE_ACCESS_CONFIG
static val INTENT_CATEGORY_USAGE_ACCESS_CONFIG: String
Activity Category: Show application settings related to usage access.
An activity that provides a user interface for adjusting usage access related preferences for its containing application. Optional but recommended for apps that use android.Manifest.permission#PACKAGE_USAGE_STATS
.
The activity may define meta-data to describe what usage access is used for within their app with METADATA_USAGE_ACCESS_REASON
, which will be displayed in Settings.
Input: Nothing.
Output: Nothing.
Value: "android.intent.category.USAGE_ACCESS_CONFIG"
METADATA_USAGE_ACCESS_REASON
static val METADATA_USAGE_ACCESS_REASON: String
Metadata key: Reason for needing usage access.
A key for metadata attached to an activity that receives action INTENT_CATEGORY_USAGE_ACCESS_CONFIG
, shown to the user as description of how the app uses usage access.
Value: "android.settings.metadata.USAGE_ACCESS_REASON"
SUPERVISOR_VERIFICATION_SETTING_BIOMETRICS
static val SUPERVISOR_VERIFICATION_SETTING_BIOMETRICS: Int
Settings for supervisors to control what kinds of biometric sensors, such a face and fingerprint scanners, can be used on the device.
Value: 1
SUPERVISOR_VERIFICATION_SETTING_UNKNOWN
static val SUPERVISOR_VERIFICATION_SETTING_UNKNOWN: Int
The unknown setting can usually be ignored and is used for compatibility with future supervisor settings.
Value: 0
Public constructors
Settings
Settings()
Public methods
canDrawOverlays
static fun canDrawOverlays(context: Context!): Boolean
Checks if the specified context can draw on top of other apps. As of API level 23, an app cannot draw on top of other apps unless it declares the android.Manifest.permission#SYSTEM_ALERT_WINDOW
permission in its manifest, and the user specifically grants the app this capability. To prompt the user to grant this approval, the app must send an intent with the action android.provider.Settings#ACTION_MANAGE_OVERLAY_PERMISSION
, which causes the system to display a permission management screen.
Parameters | |
---|---|
context |
Context!: App context. |
Return | |
---|---|
Boolean |
true if the specified context can draw on top of other apps, false otherwise |