Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Global

*** ** * ** ***

```
class Global : Settings.NameValueTable
```

|---|---|---|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) |||
| ↳ | [android.provider.Settings.NameValueTable](https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable) ||
|   | ↳ | [android.provider.Settings.Global](https://developer.android.com/reference/kotlin/android/provider/Settings.Global#) |

Global system settings, containing preferences that always apply identically to all defined users. Applications can read these but are not allowed to write; like the "Secure" settings, these are for preferences that the user must explicitly modify through the system UI or specialized APIs for those values.

## Summary

| Constants ||
|---|---|
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#ADB_ENABLED:kotlin.String` Whether ADB over USB is enabled. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#AIRPLANE_MODE_ON:kotlin.String` Whether Airplane Mode is on. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#AIRPLANE_MODE_RADIOS:kotlin.String` A comma separated list of radios that need to be disabled when airplane mode is on. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#ALWAYS_FINISH_ACTIVITIES:kotlin.String` If not 0, the activity manager will aggressively finish activities and processes as soon as they are no longer needed. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#ANIMATOR_DURATION_SCALE:kotlin.String` Scaling factor for Animator-based animations. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#APPLY_RAMPING_RINGER:kotlin.String` Whether applying ramping ringer on incoming phone call ringtone. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#AUTO_TIME:kotlin.String` Value to specify if the device's UTC system clock should be set automatically, e. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#AUTO_TIME_ZONE:kotlin.String` Value to specify if the device's time zone system property should be set automatically, e. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#BLUETOOTH_ON:kotlin.String` Whether bluetooth is enabled/disabled 0=disabled. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#BOOT_COUNT:kotlin.String` Boot count since the device starts running API level 24. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#CONTACT_METADATA_SYNC_ENABLED:kotlin.String` Whether to enable contacts metadata syncing or not The value 1 - enable, 0 - disable |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#DATA_ROAMING:kotlin.String` Whether or not data roaming is enabled. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#DEBUG_APP:kotlin.String` Name of an application package to be debugged. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#DEVELOPMENT_SETTINGS_ENABLED:kotlin.String` Whether user has enabled development settings. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#DEVICE_NAME:kotlin.String` The name of the device |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#DEVICE_PROVISIONED:kotlin.String` Whether the device has been provisioned (0 = false, 1 = true). |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#HTTP_PROXY:kotlin.String` Host name and port for global http proxy. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#INSTALL_NON_MARKET_APPS:kotlin.String` <br /> |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#MODE_RINGER:kotlin.String` Ringer mode. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#NETWORK_PREFERENCE:kotlin.String` User preference for which network(s) should be used. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#RADIO_BLUETOOTH:kotlin.String` Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify Bluetooth radio. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#RADIO_CELL:kotlin.String` Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#RADIO_NFC:kotlin.String` Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify NFC radio. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#RADIO_WIFI:kotlin.String` Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify Wi-Fi radio. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#SECURE_FRP_MODE:kotlin.String` Indicates whether the device is under restricted secure FRP mode. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#SHOW_PROCESSES:kotlin.String` Control whether the process CPU usage meter should be shown. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#STAY_ON_WHILE_PLUGGED_IN:kotlin.String` Whether we keep the device on while the device is plugged in. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE:kotlin.String` Scaling factor for activity transition animations. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#USB_MASS_STORAGE_ENABLED:kotlin.String` USB Mass Storage Enabled |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#USE_GOOGLE_MAIL:kotlin.String` If this setting is set (to anything), then all references to Gmail on the device must change to Google Mail. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WAIT_FOR_DEBUGGER:kotlin.String` If 1, when launching DEBUG_APP it will wait for the debugger before starting user code. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN:kotlin.String` This setting controls whether WiFi configurations created by a Device Owner app should be locked down (that is, be editable or removable only by the Device Owner App, not even by Settings app). |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_MAX_DHCP_RETRY_COUNT:kotlin.String` The maximum number of times we will retry a connection to an access point for which we have failed in acquiring an IP address from DHCP. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS:kotlin.String` Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile data connectivity to be established after a disconnect from Wi-Fi. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON:kotlin.String` Whether to notify the user of open networks. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY:kotlin.String` Delay (in seconds) before repeating the Wi-Fi networks available notification. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_NUM_OPEN_NETWORKS_KEPT:kotlin.String` When the number of open networks exceeds this number, the least-recently-used excess networks will be removed. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_ON:kotlin.String` Whether the Wi-Fi should be on. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` The policy for deciding when Wi-Fi should go to sleep (which will in turn switch to using the mobile data as an Internet connection). |
| static [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_DEFAULT:kotlin.Int` Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#STAY_ON_WHILE_PLUGGED_IN:kotlin.String` setting. |
| static [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_NEVER:kotlin.Int` Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to never go to sleep. |
| static [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED:kotlin.Int` Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to use the default policy when the device is on battery, and never go to sleep when the device is plugged in. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_WATCHDOG_ON:kotlin.String` Whether the Wi-Fi watchdog is enabled. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WINDOW_ANIMATION_SCALE:kotlin.String` Scaling factor for normal window animations. |

| Inherited constants ||
|---|---|
| From class `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable` |---|---| | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable#NAME:kotlin.String` <br /> | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable#VALUE:kotlin.String` <br /> | ||
| From class `https://developer.android.com/reference/kotlin/android/provider/BaseColumns` |---|---| | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/android/provider/BaseColumns#_COUNT:kotlin.String` The count of rows in a directory. Type: INTEGER <br /> | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/android/provider/BaseColumns#_ID:kotlin.String` The unique ID for a row. Type: INTEGER (long) <br /> | ||

| Public constructors ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#Global()()` <br /> |

| Public methods ||
|---|---|
| static [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getFloat(android.content.ContentResolver,%20kotlin.String)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Convenience function for retrieving a single secure settings value as a float. |
| static [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getFloat(android.content.ContentResolver,%20kotlin.String,%20kotlin.Float)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, def: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)` Convenience function for retrieving a single secure settings value as a floating point number. |
| static [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getInt(android.content.ContentResolver,%20kotlin.String)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Convenience function for retrieving a single secure settings value as an integer. |
| static [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getInt(android.content.ContentResolver,%20kotlin.String,%20kotlin.Int)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, def: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)` Convenience function for retrieving a single secure settings value as an integer. |
| static [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getLong(android.content.ContentResolver,%20kotlin.String)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Convenience function for retrieving a single secure settings value as a `long`. |
| static [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getLong(android.content.ContentResolver,%20kotlin.String,%20kotlin.Long)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, def: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)` Convenience function for retrieving a single secure settings value as a `long`. |
| static [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)! | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getString(android.content.ContentResolver,%20kotlin.String)(resolver: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Look up a name in the database. |
| static [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#getUriFor(kotlin.String)(name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Construct the content URI for a particular name/value pair, useful for monitoring changes with a ContentObserver. |
| static [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#putFloat(android.content.ContentResolver,%20kotlin.String,%20kotlin.Float)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html)` Convenience function for updating a single settings value as a floating point number. |
| static [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#putInt(android.content.ContentResolver,%20kotlin.String,%20kotlin.Int)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)` Convenience function for updating a single settings value as an integer. |
| static [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#putLong(android.content.ContentResolver,%20kotlin.String,%20kotlin.Long)(cr: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html)` Convenience function for updating a secure settings value as a long integer. |
| static [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#putString(android.content.ContentResolver,%20kotlin.String,%20kotlin.String)(resolver: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Store a name/value pair into the database. |

| Inherited functions ||
|---|---|
| From class `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable` |---|---| | `https://developer.android.com/reference/kotlin/android/net/Uri.html#!` | `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable#getUriFor(android.net.Uri,%20kotlin.String)(uri: https://developer.android.com/reference/kotlin/android/net/Uri.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` <br /> | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/android/provider/Settings.NameValueTable#putString(android.content.ContentResolver,%20android.net.Uri,%20kotlin.String,%20kotlin.String)(resolver: https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#!, uri: https://developer.android.com/reference/kotlin/android/net/Uri.html#!, name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` <br /> | ||

| Properties ||
|---|---|
| static [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)! | `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#CONTENT_URI:android.net.Uri` The content:// style URL for global secure settings items. |

## Constants

### ADB_ENABLED

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val ADB_ENABLED: String
```

Whether ADB over USB is enabled. (0 = false, 1 = true). This will always return 0 for all third-party apps.

    Value: "adb_enabled"

### AIRPLANE_MODE_ON

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val AIRPLANE_MODE_ON: String
```

Whether Airplane Mode is on.

    Value: "airplane_mode_on"

### AIRPLANE_MODE_RADIOS

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val AIRPLANE_MODE_RADIOS: String
```

A comma separated list of radios that need to be disabled when airplane mode is on. This overrides WIFI_ON and BLUETOOTH_ON, if Wi-Fi and bluetooth are included in the comma separated list.

    Value: "airplane_mode_radios"

### ALWAYS_FINISH_ACTIVITIES

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val ALWAYS_FINISH_ACTIVITIES: String
```

If not 0, the activity manager will aggressively finish activities and processes as soon as they are no longer needed. If 0, the normal extended lifetime is used.

    Value: "always_finish_activities"

### ANIMATOR_DURATION_SCALE

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val ANIMATOR_DURATION_SCALE: String
```

Scaling factor for Animator-based animations. This affects both the start delay and duration of all such animations. The value is a float. Setting to 0.0f will cause animations to end immediately. The default value is 1.0f.

    Value: "animator_duration_scale"

### APPLY_RAMPING_RINGER

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val APPLY_RAMPING_RINGER: String
```

**Deprecated:** *Use `https://developer.android.com/reference/kotlin/android/media/AudioManager.html#isRampingRingerEnabled()` instead*

Whether applying ramping ringer on incoming phone call ringtone.

1 = apply ramping ringer

0 = do not apply ramping ringer

    Value: "apply_ramping_ringer"

### AUTO_TIME

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val AUTO_TIME: String
```

Value to specify if the device's UTC system clock should be set automatically, e.g. using telephony signals like NITZ, or other sources like GNSS or NTP.

Prefer `android.app.time.TimeManager` API calls to determine the state of automatic time detection instead of directly observing this setting as it may be ignored by the time_detector service under various conditions.

1=yes, 0=no (manual)

    Value: "auto_time"

### AUTO_TIME_ZONE

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val AUTO_TIME_ZONE: String
```

Value to specify if the device's time zone system property should be set automatically, e.g. using telephony signals like MCC and NITZ, or other mechanisms like the location.

Prefer `android.app.time.TimeManager` API calls to determine the state of automatic time zone detection instead of directly observing this setting as it may be ignored by the time_zone_detector service under various conditions.

1=yes, 0=no (manual).

    Value: "auto_time_zone"

### BLUETOOTH_ON

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val BLUETOOTH_ON: String
```

Whether bluetooth is enabled/disabled 0=disabled. 1=enabled.

    Value: "bluetooth_on"

### BOOT_COUNT

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val BOOT_COUNT: String
```

Boot count since the device starts running API level 24.

Type: int

    Value: "boot_count"

### CONTACT_METADATA_SYNC_ENABLED

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val CONTACT_METADATA_SYNC_ENABLED: String
```

Whether to enable contacts metadata syncing or not The value 1 - enable, 0 - disable

    Value: "contact_metadata_sync_enabled"

### DATA_ROAMING

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val DATA_ROAMING: String
```

Whether or not data roaming is enabled. (0 = false, 1 = true) Use `https://developer.android.com/reference/kotlin/android/telephony/TelephonyManager.html#isDataRoamingEnabled()` instead of calling via settings.

    Value: "data_roaming"

### DEBUG_APP

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val DEBUG_APP: String
```

Name of an application package to be debugged.

    Value: "debug_app"

### DEVELOPMENT_SETTINGS_ENABLED

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val DEVELOPMENT_SETTINGS_ENABLED: String
```

Whether user has enabled development settings. (0 = false, 1 = true). This will always return 0 for all third-party apps.

    Value: "development_settings_enabled"

### DEVICE_NAME

Added in [API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val DEVICE_NAME: String
```

The name of the device

    Value: "device_name"

### DEVICE_PROVISIONED

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val DEVICE_PROVISIONED: String
```

Whether the device has been provisioned (0 = false, 1 = true).

On a multiuser device with a separate system user, the screen may be locked as soon as this is set to true and further activities cannot be launched on the system user unless they are marked to show over keyguard.

    Value: "device_provisioned"

### HTTP_PROXY

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val HTTP_PROXY: String
```

Host name and port for global http proxy. Uses ':' seperator for between host and port.

    Value: "http_proxy"

### INSTALL_NON_MARKET_APPS

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val INSTALL_NON_MARKET_APPS: String
```

**Deprecated:** *Use `https://developer.android.com/reference/kotlin/android/provider/Settings.Secure#INSTALL_NON_MARKET_APPS:kotlin.String` instead*

    Value: "install_non_market_apps"

### MODE_RINGER

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val MODE_RINGER: String
```

Ringer mode. This is used internally, changing this value will not change the ringer mode. See AudioManager.

    Value: "mode_ringer"

### NETWORK_PREFERENCE

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val NETWORK_PREFERENCE: String
```

User preference for which network(s) should be used. Only the connectivity service should touch this.

    Value: "network_preference"

### RADIO_BLUETOOTH

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val RADIO_BLUETOOTH: String
```

Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify Bluetooth radio.

    Value: "bluetooth"

### RADIO_CELL

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val RADIO_CELL: String
```

Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.

    Value: "cell"

### RADIO_NFC

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val RADIO_NFC: String
```

Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify NFC radio.

    Value: "nfc"

### RADIO_WIFI

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val RADIO_WIFI: String
```

Constant for use in AIRPLANE_MODE_RADIOS or SATELLITE_MODE_RADIOS to specify Wi-Fi radio.

    Value: "wifi"

### SECURE_FRP_MODE

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val SECURE_FRP_MODE: String
```

Indicates whether the device is under restricted secure FRP mode. Secure FRP mode is enabled when the device is under FRP. On solving of FRP challenge, device is removed from this mode.

Type: int (0 for false, 1 for true)

    Value: "secure_frp_mode"

### SHOW_PROCESSES

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 25](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val SHOW_PROCESSES: String
```

**Deprecated:** *This functionality is no longer available as of `https://developer.android.com/reference/kotlin/android/os/Build.VERSION_CODES.html#N_MR1:kotlin.Int`.*

Control whether the process CPU usage meter should be shown.

    Value: "show_processes"

### STAY_ON_WHILE_PLUGGED_IN

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val STAY_ON_WHILE_PLUGGED_IN: String
```

Whether we keep the device on while the device is plugged in. Supported values are:

- `0` to never stay on while plugged in
- `https://developer.android.com/reference/kotlin/android/os/BatteryManager.html#BATTERY_PLUGGED_AC:kotlin.Int` to stay on for AC charger
- `https://developer.android.com/reference/kotlin/android/os/BatteryManager.html#BATTERY_PLUGGED_USB:kotlin.Int` to stay on for USB charger
- `https://developer.android.com/reference/kotlin/android/os/BatteryManager.html#BATTERY_PLUGGED_WIRELESS:kotlin.Int` to stay on for wireless charger
- `https://developer.android.com/reference/kotlin/android/os/BatteryManager.html#BATTERY_PLUGGED_DOCK:kotlin.Int` to stay on for dock charger

These values can be OR-ed together.

<br />

    Value: "stay_on_while_plugged_in"

### TRANSITION_ANIMATION_SCALE

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val TRANSITION_ANIMATION_SCALE: String
```

Scaling factor for activity transition animations. The value is a float. Setting to 0.0f will disable window animations.

    Value: "transition_animation_scale"

### USB_MASS_STORAGE_ENABLED

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val USB_MASS_STORAGE_ENABLED: String
```

USB Mass Storage Enabled

    Value: "usb_mass_storage_enabled"

### USE_GOOGLE_MAIL

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val USE_GOOGLE_MAIL: String
```

If this setting is set (to anything), then all references to Gmail on the device must change to Google Mail.

    Value: "use_google_mail"

### WAIT_FOR_DEBUGGER

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WAIT_FOR_DEBUGGER: String
```

If 1, when launching DEBUG_APP it will wait for the debugger before starting user code. If 0, it will run normally.

    Value: "wait_for_debugger"

### WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN

Added in [API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN: String
```

This setting controls whether WiFi configurations created by a Device Owner app should be locked down (that is, be editable or removable only by the Device Owner App, not even by Settings app). This setting takes integer values. Non-zero values mean DO created configurations are locked down. Value of zero means they are not. Default value in the absence of actual value to this setting is 0.

    Value: "wifi_device_owner_configs_lockdown"

### WIFI_MAX_DHCP_RETRY_COUNT

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_MAX_DHCP_RETRY_COUNT: String
```

The maximum number of times we will retry a connection to an access point for which we have failed in acquiring an IP address from DHCP. A value of N means that we will make N+1 connection attempts in all.

    Value: "wifi_max_dhcp_retry_count"

### WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS: String
```

Maximum amount of time in milliseconds to hold a wakelock while waiting for mobile data connectivity to be established after a disconnect from Wi-Fi.

    Value: "wifi_mobile_data_transition_wakelock_timeout_ms"

### WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON: String
```

**Deprecated:** *This feature is no longer controlled by this setting in `https://developer.android.com/reference/kotlin/android/os/Build.VERSION_CODES.html#O:kotlin.Int`.*

Whether to notify the user of open networks.

If not connected and the scan results have an open network, we will put this notification up. If we attempt to connect to a network or the open network(s) disappear, we remove the notification. When we show the notification, we will not show it again for `https://developer.android.com/reference/kotlin/android/provider/Settings.Secure#WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY:kotlin.String` time.

    Value: "wifi_networks_available_notification_on"

### WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY: String
```

**Deprecated:** *This is no longer used or set by the platform.*

Delay (in seconds) before repeating the Wi-Fi networks available notification. Connecting to a network will reset the timer.

    Value: "wifi_networks_available_repeat_delay"

### WIFI_NUM_OPEN_NETWORKS_KEPT

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_NUM_OPEN_NETWORKS_KEPT: String
```

**Deprecated:** *This is no longer used or set by the platform.*

When the number of open networks exceeds this number, the least-recently-used excess networks will be removed.

    Value: "wifi_num_open_networks_kept"

### WIFI_ON

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_ON: String
```

Whether the Wi-Fi should be on. Only the Wi-Fi service should touch this.

    Value: "wifi_on"

### WIFI_SLEEP_POLICY

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_SLEEP_POLICY: String
```

**Deprecated:** *This is no longer used or set by the platform.*

The policy for deciding when Wi-Fi should go to sleep (which will in turn switch to using the mobile data as an Internet connection).

Set to one of `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_DEFAULT:kotlin.Int`, `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED:kotlin.Int`, or `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY_NEVER:kotlin.Int`.

    Value: "wifi_sleep_policy"

### WIFI_SLEEP_POLICY_DEFAULT

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_SLEEP_POLICY_DEFAULT: Int
```

**Deprecated:** *This is no longer used by the platform.*

Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#STAY_ON_WHILE_PLUGGED_IN:kotlin.String` setting.

    Value: 0

### WIFI_SLEEP_POLICY_NEVER

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_SLEEP_POLICY_NEVER: Int
```

**Deprecated:** *This is no longer used by the platform.*

Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to never go to sleep.

    Value: 2

### WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED: Int
```

**Deprecated:** *This is no longer used by the platform.*

Value for `https://developer.android.com/reference/kotlin/android/provider/Settings.Global#WIFI_SLEEP_POLICY:kotlin.String` to use the default policy when the device is on battery, and never go to sleep when the device is plugged in.

    Value: 1

### WIFI_WATCHDOG_ON

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WIFI_WATCHDOG_ON: String
```

Whether the Wi-Fi watchdog is enabled.

    Value: "wifi_watchdog_on"

### WINDOW_ANIMATION_SCALE

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val WINDOW_ANIMATION_SCALE: String
```

Scaling factor for normal window animations. The value is a float. Setting to 0.0f will disable window animations.

    Value: "window_animation_scale"

## Public constructors

### Global

```
Global()
```

## Public methods

### getFloat

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getFloat(
    cr: ContentResolver!, 
    name: String!
): Float
```

Convenience function for retrieving a single secure settings value as a float. Note that internally setting values are always stored as strings; this function converts the string to a float for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws `https://developer.android.com/reference/kotlin/android/provider/Settings.SettingNotFoundException`.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html` | The setting's current value. |

| Exceptions ||
|---|---|
| `android.provider.Settings.SettingNotFoundException` | Thrown if a setting by the given name can't be found or the setting value is not a float. |

### getFloat

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getFloat(
    cr: ContentResolver!, 
    name: String!, 
    def: Float
): Float
```

Convenience function for retrieving a single secure settings value as a floating point number. Note that internally setting values are always stored as strings; this function converts the string to an float for you. The default value will be returned if the setting is not defined or not a valid float.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |
| `def` | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html): Value to return if the setting is not defined. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html` | The setting's current value, or 'def' if it is not defined or not a valid float. |

### getInt

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getInt(
    cr: ContentResolver!, 
    name: String!
): Int
```

Convenience function for retrieving a single secure settings value as an integer. Note that internally setting values are always stored as strings; this function converts the string to an integer for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws `https://developer.android.com/reference/kotlin/android/provider/Settings.SettingNotFoundException`.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html` | The setting's current value. |

| Exceptions ||
|---|---|
| `android.provider.Settings.SettingNotFoundException` | Thrown if a setting by the given name can't be found or the setting value is not an integer. |

### getInt

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getInt(
    cr: ContentResolver!, 
    name: String!, 
    def: Int
): Int
```

Convenience function for retrieving a single secure settings value as an integer. Note that internally setting values are always stored as strings; this function converts the string to an integer for you. The default value will be returned if the setting is not defined or not an integer.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |
| `def` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html): Value to return if the setting is not defined. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html` | The setting's current value, or 'def' if it is not defined or not a valid integer. |

### getLong

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getLong(
    cr: ContentResolver!, 
    name: String!
): Long
```

Convenience function for retrieving a single secure settings value as a `long`. Note that internally setting values are always stored as strings; this function converts the string to a `long` for you.

This version does not take a default value. If the setting has not been set, or the string value is not a number, it throws `https://developer.android.com/reference/kotlin/android/provider/Settings.SettingNotFoundException`.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html` | The setting's current value. |

| Exceptions ||
|---|---|
| `android.provider.Settings.SettingNotFoundException` | Thrown if a setting by the given name can't be found or the setting value is not an integer. |

### getLong

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getLong(
    cr: ContentResolver!, 
    name: String!, 
    def: Long
): Long
```

Convenience function for retrieving a single secure settings value as a `long`. Note that internally setting values are always stored as strings; this function converts the string to a `long` for you. The default value will be returned if the setting is not defined or not a `long`.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to retrieve. |
| `def` | [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html): Value to return if the setting is not defined. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html` | The setting's current value, or 'def' if it is not defined or not a valid `long`. |

### getString

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getString(
    resolver: ContentResolver!, 
    name: String!
): String!
```

Look up a name in the database.

| Parameters ||
|---|---|
| `resolver` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: to access the database with |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: to look up in the table |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | the corresponding value, or null if not present |

### getUriFor

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun getUriFor(name: String!): Uri!
```

Construct the content URI for a particular name/value pair, useful for monitoring changes with a ContentObserver.

| Parameters ||
|---|---|
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: to look up in the table |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/net/Uri.html#!` | the corresponding content URI, or null if not present |

### putFloat

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun putFloat(
    cr: ContentResolver!, 
    name: String!, 
    value: Float
): Boolean
```

Convenience function for updating a single settings value as a floating point number. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to modify. |
| `value` | [Float](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/index.html): The new value for the setting. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | true if the value was set, false on database errors |

### putInt

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun putInt(
    cr: ContentResolver!, 
    name: String!, 
    value: Int
): Boolean
```

Convenience function for updating a single settings value as an integer. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to modify. |
| `value` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html): The new value for the setting. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | true if the value was set, false on database errors |

### putLong

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun putLong(
    cr: ContentResolver!, 
    name: String!, 
    value: Long
): Boolean
```

Convenience function for updating a secure settings value as a long integer. This will either create a new entry in the table if the given name does not exist, or modify the value of the existing row with that name. Note that internally setting values are always stored as strings, so this function converts the given value to a string before storing it.

| Parameters ||
|---|---|
| `cr` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: The ContentResolver to access. |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: The name of the setting to modify. |
| `value` | [Long](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-long/index.html): The new value for the setting. |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | true if the value was set, false on database errors |

### putString

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static fun putString(
    resolver: ContentResolver!, 
    name: String!, 
    value: String!
): Boolean
```

Store a name/value pair into the database.

| Parameters ||
|---|---|
| `resolver` | [ContentResolver](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#)!: to access the database with |
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: to store |
| `value` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: to associate with the name |

| Return ||
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | true if the value was set, false on database errors |

## Properties

### CONTENT_URI

Added in [API level 17](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
static val CONTENT_URI: Uri!
```

The content:// style URL for global secure settings items. Not public.