public static final class

Settings.System

extends Settings.NameValueTable
java.lang.Object
   ↳ android.provider.Settings.NameValueTable
     ↳ android.provider.Settings.System

Class Overview

System settings, containing miscellaneous system preferences. This table holds simple name/value pairs. There are convenience functions for accessing individual settings entries.

Summary

Constants
String ACCELEROMETER_ROTATION Control whether the accelerometer will be used to change screen orientation.
String ADB_ENABLED This constant is deprecated. Use LOCATION_PROVIDERS_ALLOWED instead
String AIRPLANE_MODE_ON Whether Airplane Mode is on.
String AIRPLANE_MODE_RADIOS A comma separated list of radios that need to be disabled when airplane mode is on.
String ALWAYS_FINISH_ACTIVITIES If 1, the activity manager will aggressively finish activities and processes as soon as they are no longer needed.
String ANDROID_ID This constant is deprecated. Use ANDROID_ID instead
String APPEND_FOR_LAST_AUDIBLE Appended to various volume related settings to record the previous values before they the settings were affected by a silent/vibrate ringer mode change.
String AUTO_TIME Value to specify if the user prefers the date, time and time zone to be automatically fetched from the network (NITZ).
String BLUETOOTH_DISCOVERABILITY Determines whether remote devices may discover and/or connect to this device.
String BLUETOOTH_DISCOVERABILITY_TIMEOUT Bluetooth discoverability timeout.
String BLUETOOTH_ON This constant is deprecated. Use BLUETOOTH_ON instead
Uri CONTENT_URI The content:// style URL for this table
String DATA_ROAMING This constant is deprecated. Use DATA_ROAMING instead
String DATE_FORMAT Date format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd
String DEBUG_APP Name of an application package to be debugged.
Uri DEFAULT_NOTIFICATION_URI A Uri that will point to the current default notification sound at any given time.
Uri DEFAULT_RINGTONE_URI A Uri that will point to the current default ringtone at any given time.
String DEVICE_PROVISIONED This constant is deprecated. Use DEVICE_PROVISIONED instead
String DIM_SCREEN Whether or not to dim the screen.
String DTMF_TONE_WHEN_DIALING Whether the audible DTMF tones are played by the dialer when dialing.
String END_BUTTON_BEHAVIOR What happens when the user presses the end call button if they're not on a call.
String FONT_SCALE Scaling factor for fonts, float.
String HAPTIC_FEEDBACK_ENABLED Whether the haptic feedback (long presses, ...) are enabled.
String HTTP_PROXY This constant is deprecated. Use HTTP_PROXY instead
String INSTALL_NON_MARKET_APPS This constant is deprecated. Use INSTALL_NON_MARKET_APPS instead
String LOCATION_PROVIDERS_ALLOWED This constant is deprecated. Use LOCATION_PROVIDERS_ALLOWED instead
String LOCK_PATTERN_ENABLED Whether autolock is enabled (0 = false, 1 = true)
String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED Whether lock pattern will vibrate as user enters (0 = false, 1 = true)
String LOCK_PATTERN_VISIBLE Whether lock pattern is visible as user enters (0 = false, 1 = true)
String LOGGING_ID This constant is deprecated. Use LOGGING_ID instead
String MODE_RINGER Ringer mode.
String MODE_RINGER_STREAMS_AFFECTED Determines which streams are affected by ringer mode changes.
String MUTE_STREAMS_AFFECTED Determines which streams are affected by mute.
String NETWORK_PREFERENCE This constant is deprecated. Use NETWORK_PREFERENCE instead
String NEXT_ALARM_FORMATTED A formatted string of the next alarm that is set, or the empty string if there is no alarm set.
String NOTIFICATION_SOUND Persistent store for the system-wide default notification sound.
String PARENTAL_CONTROL_ENABLED This constant is deprecated. Use PARENTAL_CONTROL_ENABLED instead
String PARENTAL_CONTROL_LAST_UPDATE This constant is deprecated. Use PARENTAL_CONTROL_LAST_UPDATE instead
String PARENTAL_CONTROL_REDIRECT_URL This constant is deprecated. Use PARENTAL_CONTROL_REDIRECT_URL instead
String RADIO_BLUETOOTH Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.
String RADIO_CELL Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.
String RADIO_WIFI Constant for use in AIRPLANE_MODE_RADIOS to specify Wi-Fi radio.
String RINGTONE Persistent store for the system-wide default ringtone URI.
String SCREEN_BRIGHTNESS The screen backlight brightness between 0 and 255.
String SCREEN_OFF_TIMEOUT The timeout before the screen turns off.
String SETTINGS_CLASSNAME This constant is deprecated. Use SETTINGS_CLASSNAME instead
String SETUP_WIZARD_HAS_RUN Whether the setup wizard has been run before (on first boot), or if it still needs to be run.
String SHOW_GTALK_SERVICE_STATUS
String SHOW_PROCESSES Control whether the process CPU usage meter should be shown.
String SOUND_EFFECTS_ENABLED Whether the sounds effects (key clicks, lid open ...) are enabled.
String STAY_ON_WHILE_PLUGGED_IN Whether we keep the device on while the device is plugged in.
String SYS_PROP_SETTING_VERSION
String TEXT_AUTO_CAPS Setting to enable Auto Caps in text editors.
String TEXT_AUTO_PUNCTUATE Setting to enable Auto Punctuate in text editors.
String TEXT_AUTO_REPLACE Setting to enable Auto Replace (AutoText) in text editors.
String TEXT_SHOW_PASSWORD Setting to showing password characters in text editors.
String TIME_12_24 Display times as 12 or 24 hours 12 24
String TRANSITION_ANIMATION_SCALE Scaling factor for activity transition animations.
String USB_MASS_STORAGE_ENABLED This constant is deprecated. Use USB_MASS_STORAGE_ENABLED instead
String USE_GOOGLE_MAIL This constant is deprecated. Use USE_GOOGLE_MAIL instead
String VIBRATE_ON Whether vibrate is on for different events.
String VOLUME_ALARM Alarm volume.
String VOLUME_MUSIC Music/media/gaming volume.
String VOLUME_NOTIFICATION Notification volume.
String VOLUME_RING Ringer volume.
String[] VOLUME_SETTINGS The mapping of stream type (integer) to its setting.
String VOLUME_SYSTEM System/notifications volume.
String VOLUME_VOICE Voice call volume.
String WAIT_FOR_DEBUGGER If 1, when launching DEBUG_APP it will wait for the debugger before starting user code.
String WALLPAPER_ACTIVITY Name of activity to use for wallpaper on the home screen.
String WIFI_MAX_DHCP_RETRY_COUNT
String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead
String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY This constant is deprecated. Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead
String WIFI_NUM_OPEN_NETWORKS_KEPT This constant is deprecated. Use WIFI_NUM_OPEN_NETWORKS_KEPT instead
String WIFI_ON This constant is deprecated. Use WIFI_ON instead
String WIFI_SLEEP_POLICY 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).
int WIFI_SLEEP_POLICY_DEFAULT Value for WIFI_SLEEP_POLICY to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the STAY_ON_WHILE_PLUGGED_IN setting.
int WIFI_SLEEP_POLICY_NEVER Value for WIFI_SLEEP_POLICY to never go to sleep.
int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED Value for WIFI_SLEEP_POLICY to use the default policy when the device is on battery, and never go to sleep when the device is plugged in.
String WIFI_STATIC_DNS1 If using static IP, the primary DNS's IP address.
String WIFI_STATIC_DNS2 If using static IP, the secondary DNS's IP address.
String WIFI_STATIC_GATEWAY If using static IP, the gateway's IP address.
String WIFI_STATIC_IP The static IP address.
String WIFI_STATIC_NETMASK If using static IP, the net mask.
String WIFI_USE_STATIC_IP Whether to use static IP and other static network attributes.
String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE This constant is deprecated. Use WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead
String WIFI_WATCHDOG_AP_COUNT This constant is deprecated. Use WIFI_WATCHDOG_AP_COUNT instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead
String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead
String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead
String WIFI_WATCHDOG_MAX_AP_CHECKS This constant is deprecated. Use WIFI_WATCHDOG_MAX_AP_CHECKS instead
String WIFI_WATCHDOG_ON This constant is deprecated. Use WIFI_WATCHDOG_ON instead
String WIFI_WATCHDOG_PING_COUNT This constant is deprecated. Use WIFI_WATCHDOG_PING_COUNT instead
String WIFI_WATCHDOG_PING_DELAY_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_DELAY_MS instead
String WIFI_WATCHDOG_PING_TIMEOUT_MS This constant is deprecated. Use WIFI_WATCHDOG_PING_TIMEOUT_MS instead
String WINDOW_ANIMATION_SCALE Scaling factor for normal window animations.
[Expand]
Inherited Constants
From class android.provider.Settings.NameValueTable
From interface android.provider.BaseColumns
Public Constructors
Settings.System()
Public Methods
static void getConfiguration(ContentResolver cr, Configuration outConfig)
Convenience function to read all of the current configuration-related settings into a Configuration object.
static float getFloat(ContentResolver cr, String name, float def)
Convenience function for retrieving a single system settings value as a floating point number.
static float getFloat(ContentResolver cr, String name)
Convenience function for retrieving a single system settings value as a float.
static int getInt(ContentResolver cr, String name)
Convenience function for retrieving a single system settings value as an integer.
static int getInt(ContentResolver cr, String name, int def)
Convenience function for retrieving a single system settings value as an integer.
static long getLong(ContentResolver cr, String name, long def)
Convenience function for retrieving a single system settings value as a long.
static long getLong(ContentResolver cr, String name)
Convenience function for retrieving a single system settings value as a long.
static boolean getShowGTalkServiceStatus(ContentResolver cr)
synchronized static String getString(ContentResolver resolver, String name)
Look up a name in the database.
static Uri getUriFor(String name)
Construct the content URI for a particular name/value pair, useful for monitoring changes with a ContentObserver.
static boolean putConfiguration(ContentResolver cr, Configuration config)
Convenience function to write a batch of configuration-related settings from a Configuration object.
static boolean putFloat(ContentResolver cr, String name, float value)
Convenience function for updating a single settings value as a floating point number.
static boolean putInt(ContentResolver cr, String name, int value)
Convenience function for updating a single settings value as an integer.
static boolean putLong(ContentResolver cr, String name, long value)
Convenience function for updating a single settings value as a long integer.
static boolean putString(ContentResolver resolver, String name, String value)
Store a name/value pair into the database.
static void setShowGTalkServiceStatus(ContentResolver cr, boolean flag)
[Expand]
Inherited Methods
From class android.provider.Settings.NameValueTable
From class java.lang.Object

Constants

public static final String ACCELEROMETER_ROTATION

Control whether the accelerometer will be used to change screen orientation. If 0, it will not be used unless explicitly requested by the application; if 1, it will be used by default unless explicitly disabled by the application.

Constant Value: "accelerometer_rotation"

public static final String ADB_ENABLED

This constant is deprecated.Use LOCATION_PROVIDERS_ALLOWED instead

Constant Value: "adb_enabled"

public static final String AIRPLANE_MODE_ON

Whether Airplane Mode is on.

Constant Value: "airplane_mode_on"

public static final String AIRPLANE_MODE_RADIOS

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.

Constant Value: "airplane_mode_radios"

public static final String ALWAYS_FINISH_ACTIVITIES

If 1, 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.

Constant Value: "always_finish_activities"

public static final String ANDROID_ID

This constant is deprecated.Use ANDROID_ID instead

Constant Value: "android_id"

public static final String APPEND_FOR_LAST_AUDIBLE

Appended to various volume related settings to record the previous values before they the settings were affected by a silent/vibrate ringer mode change.

Constant Value: "_last_audible"

public static final String AUTO_TIME

Value to specify if the user prefers the date, time and time zone to be automatically fetched from the network (NITZ). 1=yes, 0=no

Constant Value: "auto_time"

public static final String BLUETOOTH_DISCOVERABILITY

Determines whether remote devices may discover and/or connect to this device.

Type: INT

2 -- discoverable and connectable 1 -- connectable but not discoverable 0 -- neither connectable nor discoverable

Constant Value: "bluetooth_discoverability"

public static final String BLUETOOTH_DISCOVERABILITY_TIMEOUT

Bluetooth discoverability timeout. If this value is nonzero, then Bluetooth becomes discoverable for a certain number of seconds, after which is becomes simply connectable. The value is in seconds.

Constant Value: "bluetooth_discoverability_timeout"

public static final String BLUETOOTH_ON

This constant is deprecated.Use BLUETOOTH_ON instead

Constant Value: "bluetooth_on"

public static final Uri CONTENT_URI

The content:// style URL for this table

public static final String DATA_ROAMING

This constant is deprecated.Use DATA_ROAMING instead

Constant Value: "data_roaming"

public static final String DATE_FORMAT

Date format string mm/dd/yyyy dd/mm/yyyy yyyy/mm/dd

Constant Value: "date_format"

public static final String DEBUG_APP

Name of an application package to be debugged.

Constant Value: "debug_app"

public static final Uri DEFAULT_NOTIFICATION_URI

A Uri that will point to the current default notification sound at any given time.

public static final Uri DEFAULT_RINGTONE_URI

A Uri that will point to the current default ringtone at any given time.

If the current default ringtone is in the DRM provider and the caller does not have permission, the exception will be a FileNotFoundException.

public static final String DEVICE_PROVISIONED

This constant is deprecated.Use DEVICE_PROVISIONED instead

Constant Value: "device_provisioned"

public static final String DIM_SCREEN

Whether or not to dim the screen. 0=no 1=yes

Constant Value: "dim_screen"

public static final String DTMF_TONE_WHEN_DIALING

Whether the audible DTMF tones are played by the dialer when dialing. The value is boolean (1 or 0).

Constant Value: "dtmf_tone"

public static final String END_BUTTON_BEHAVIOR

What happens when the user presses the end call button if they're not on a call.
Values:
0 - The end button does nothing.
1 - The end button goes to the home screen.
2 - The end button puts the device to sleep and locks the keyguard.
3 - The end button goes to the home screen. If the user is already on the home screen, it puts the device to sleep.

Constant Value: "end_button_behavior"

public static final String FONT_SCALE

Scaling factor for fonts, float.

Constant Value: "font_scale"

public static final String HAPTIC_FEEDBACK_ENABLED

Whether the haptic feedback (long presses, ...) are enabled. The value is boolean (1 or 0).

Constant Value: "haptic_feedback_enabled"

public static final String HTTP_PROXY

This constant is deprecated.Use HTTP_PROXY instead

Constant Value: "http_proxy"

public static final String INSTALL_NON_MARKET_APPS

This constant is deprecated.Use INSTALL_NON_MARKET_APPS instead

Constant Value: "install_non_market_apps"

public static final String LOCATION_PROVIDERS_ALLOWED

This constant is deprecated.Use LOCATION_PROVIDERS_ALLOWED instead

Constant Value: "location_providers_allowed"

public static final String LOCK_PATTERN_ENABLED

Whether autolock is enabled (0 = false, 1 = true)

Constant Value: "lock_pattern_autolock"

public static final String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED

Whether lock pattern will vibrate as user enters (0 = false, 1 = true)

Constant Value: "lock_pattern_tactile_feedback_enabled"

public static final String LOCK_PATTERN_VISIBLE

Whether lock pattern is visible as user enters (0 = false, 1 = true)

Constant Value: "lock_pattern_visible_pattern"

public static final String LOGGING_ID

This constant is deprecated.Use LOGGING_ID instead

Constant Value: "logging_id"

public static final String MODE_RINGER

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

Constant Value: "mode_ringer"

public static final String MODE_RINGER_STREAMS_AFFECTED

Determines which streams are affected by ringer mode changes. The stream type's bit should be set to 1 if it should be muted when going into an inaudible ringer mode.

Constant Value: "mode_ringer_streams_affected"

public static final String MUTE_STREAMS_AFFECTED

Determines which streams are affected by mute. The stream type's bit should be set to 1 if it should be muted when a mute request is received.

Constant Value: "mute_streams_affected"

public static final String NETWORK_PREFERENCE

This constant is deprecated.Use NETWORK_PREFERENCE instead

Constant Value: "network_preference"

public static final String NEXT_ALARM_FORMATTED

A formatted string of the next alarm that is set, or the empty string if there is no alarm set.

Constant Value: "next_alarm_formatted"

public static final String NOTIFICATION_SOUND

Persistent store for the system-wide default notification sound.

Constant Value: "notification_sound"

public static final String PARENTAL_CONTROL_ENABLED

This constant is deprecated.Use PARENTAL_CONTROL_ENABLED instead

Constant Value: "parental_control_enabled"

public static final String PARENTAL_CONTROL_LAST_UPDATE

This constant is deprecated.Use PARENTAL_CONTROL_LAST_UPDATE instead

Constant Value: "parental_control_last_update"

public static final String PARENTAL_CONTROL_REDIRECT_URL

This constant is deprecated.Use PARENTAL_CONTROL_REDIRECT_URL instead

Constant Value: "parental_control_redirect_url"

public static final String RADIO_BLUETOOTH

Constant for use in AIRPLANE_MODE_RADIOS to specify Bluetooth radio.

Constant Value: "bluetooth"

public static final String RADIO_CELL

Constant for use in AIRPLANE_MODE_RADIOS to specify Cellular radio.

Constant Value: "cell"

public static final String RADIO_WIFI

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

Constant Value: "wifi"

public static final String RINGTONE

Persistent store for the system-wide default ringtone URI.

If you need to play the default ringtone at any given time, it is recommended you give DEFAULT_RINGTONE_URI to the media player. It will resolve to the set default ringtone at the time of playing.

Constant Value: "ringtone"

public static final String SCREEN_BRIGHTNESS

The screen backlight brightness between 0 and 255.

Constant Value: "screen_brightness"

public static final String SCREEN_OFF_TIMEOUT

The timeout before the screen turns off.

Constant Value: "screen_off_timeout"

public static final String SETTINGS_CLASSNAME

This constant is deprecated.Use SETTINGS_CLASSNAME instead

Constant Value: "settings_classname"

public static final String SETUP_WIZARD_HAS_RUN

Whether the setup wizard has been run before (on first boot), or if it still needs to be run. nonzero = it has been run in the past 0 = it has not been run in the past

Constant Value: "setup_wizard_has_run"

public static final String SHOW_GTALK_SERVICE_STATUS

Constant Value: "SHOW_GTALK_SERVICE_STATUS"

public static final String SHOW_PROCESSES

Control whether the process CPU usage meter should be shown.

Constant Value: "show_processes"

public static final String SOUND_EFFECTS_ENABLED

Whether the sounds effects (key clicks, lid open ...) are enabled. The value is boolean (1 or 0).

Constant Value: "sound_effects_enabled"

public static final String STAY_ON_WHILE_PLUGGED_IN

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

These values can be OR-ed together.

Constant Value: "stay_on_while_plugged_in"

public static final String SYS_PROP_SETTING_VERSION

Constant Value: "sys.settings_system_version"

public static final String TEXT_AUTO_CAPS

Setting to enable Auto Caps in text editors. 1 = On, 0 = Off

Constant Value: "auto_caps"

public static final String TEXT_AUTO_PUNCTUATE

Setting to enable Auto Punctuate in text editors. 1 = On, 0 = Off. This feature converts two spaces to a "." and space.

Constant Value: "auto_punctuate"

public static final String TEXT_AUTO_REPLACE

Setting to enable Auto Replace (AutoText) in text editors. 1 = On, 0 = Off

Constant Value: "auto_replace"

public static final String TEXT_SHOW_PASSWORD

Setting to showing password characters in text editors. 1 = On, 0 = Off

Constant Value: "show_password"

public static final String TIME_12_24

Display times as 12 or 24 hours 12 24

Constant Value: "time_12_24"

public static final String TRANSITION_ANIMATION_SCALE

Scaling factor for activity transition animations. Setting to 0 will disable window animations.

Constant Value: "transition_animation_scale"

public static final String USB_MASS_STORAGE_ENABLED

This constant is deprecated.Use USB_MASS_STORAGE_ENABLED instead

Constant Value: "usb_mass_storage_enabled"

public static final String USE_GOOGLE_MAIL

This constant is deprecated.Use USE_GOOGLE_MAIL instead

Constant Value: "use_google_mail"

public static final String VIBRATE_ON

Whether vibrate is on for different events. This is used internally, changing this value will not change the vibrate. See AudioManager.

Constant Value: "vibrate_on"

public static final String VOLUME_ALARM

Alarm volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_alarm"

public static final String VOLUME_MUSIC

Music/media/gaming volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_music"

public static final String VOLUME_NOTIFICATION

Notification volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_notification"

public static final String VOLUME_RING

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

Constant Value: "volume_ring"

public static final String[] VOLUME_SETTINGS

The mapping of stream type (integer) to its setting.

public static final String VOLUME_SYSTEM

System/notifications volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_system"

public static final String VOLUME_VOICE

Voice call volume. This is used internally, changing this value will not change the volume. See AudioManager.

Constant Value: "volume_voice"

public static final String WAIT_FOR_DEBUGGER

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

Constant Value: "wait_for_debugger"

public static final String WALLPAPER_ACTIVITY

Name of activity to use for wallpaper on the home screen.

Constant Value: "wallpaper_activity"

public static final String WIFI_MAX_DHCP_RETRY_COUNT

Constant Value: "wifi_max_dhcp_retry_count"

public static final String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS

Constant Value: "wifi_mobile_data_transition_wakelock_timeout_ms"

public static final String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON

This constant is deprecated.Use WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON instead

Constant Value: "wifi_networks_available_notification_on"

public static final String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY

This constant is deprecated.Use WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY instead

Constant Value: "wifi_networks_available_repeat_delay"

public static final String WIFI_NUM_OPEN_NETWORKS_KEPT

This constant is deprecated.Use WIFI_NUM_OPEN_NETWORKS_KEPT instead

Constant Value: "wifi_num_open_networks_kept"

public static final String WIFI_ON

This constant is deprecated.Use WIFI_ON instead

Constant Value: "wifi_on"

public static final String WIFI_SLEEP_POLICY

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 WIFI_SLEEP_POLICY_DEFAULT, WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED, or WIFI_SLEEP_POLICY_NEVER.

Constant Value: "wifi_sleep_policy"

public static final int WIFI_SLEEP_POLICY_DEFAULT

Value for WIFI_SLEEP_POLICY to use the default Wi-Fi sleep policy, which is to sleep shortly after the turning off according to the STAY_ON_WHILE_PLUGGED_IN setting.

Constant Value: 0 (0x00000000)

public static final int WIFI_SLEEP_POLICY_NEVER

Value for WIFI_SLEEP_POLICY to never go to sleep.

Constant Value: 2 (0x00000002)

public static final int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED

Value for WIFI_SLEEP_POLICY to use the default policy when the device is on battery, and never go to sleep when the device is plugged in.

Constant Value: 1 (0x00000001)

public static final String WIFI_STATIC_DNS1

If using static IP, the primary DNS's IP address.

Example: "192.168.1.1"

Constant Value: "wifi_static_dns1"

public static final String WIFI_STATIC_DNS2

If using static IP, the secondary DNS's IP address.

Example: "192.168.1.2"

Constant Value: "wifi_static_dns2"

public static final String WIFI_STATIC_GATEWAY

If using static IP, the gateway's IP address.

Example: "192.168.1.1"

Constant Value: "wifi_static_gateway"

public static final String WIFI_STATIC_IP

The static IP address.

Example: "192.168.1.51"

Constant Value: "wifi_static_ip"

public static final String WIFI_STATIC_NETMASK

If using static IP, the net mask.

Example: "255.255.255.0"

Constant Value: "wifi_static_netmask"

public static final String WIFI_USE_STATIC_IP

Whether to use static IP and other static network attributes.

Set to 1 for true and 0 for false.

Constant Value: "wifi_use_static_ip"

public static final String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE

This constant is deprecated.Use WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE instead

Constant Value: "wifi_watchdog_acceptable_packet_loss_percentage"

public static final String WIFI_WATCHDOG_AP_COUNT

This constant is deprecated.Use WIFI_WATCHDOG_AP_COUNT instead

Constant Value: "wifi_watchdog_ap_count"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS

This constant is deprecated.Use WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS instead

Constant Value: "wifi_watchdog_background_check_delay_ms"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED

This constant is deprecated.Use WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED instead

Constant Value: "wifi_watchdog_background_check_enabled"

public static final String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS

This constant is deprecated.Use WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_background_check_timeout_ms"

public static final String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT

This constant is deprecated.Use WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT instead

Constant Value: "wifi_watchdog_initial_ignored_ping_count"

public static final String WIFI_WATCHDOG_MAX_AP_CHECKS

This constant is deprecated.Use WIFI_WATCHDOG_MAX_AP_CHECKS instead

Constant Value: "wifi_watchdog_max_ap_checks"

public static final String WIFI_WATCHDOG_ON

This constant is deprecated.Use WIFI_WATCHDOG_ON instead

Constant Value: "wifi_watchdog_on"

public static final String WIFI_WATCHDOG_PING_COUNT

This constant is deprecated.Use WIFI_WATCHDOG_PING_COUNT instead

Constant Value: "wifi_watchdog_ping_count"

public static final String WIFI_WATCHDOG_PING_DELAY_MS

This constant is deprecated.Use WIFI_WATCHDOG_PING_DELAY_MS instead

Constant Value: "wifi_watchdog_ping_delay_ms"

public static final String WIFI_WATCHDOG_PING_TIMEOUT_MS

This constant is deprecated.Use WIFI_WATCHDOG_PING_TIMEOUT_MS instead

Constant Value: "wifi_watchdog_ping_timeout_ms"

public static final String WINDOW_ANIMATION_SCALE

Scaling factor for normal window animations. Setting to 0 will disable window animations.

Constant Value: "window_animation_scale"

Public Constructors

public Settings.System ()

Public Methods

public static void getConfiguration (ContentResolver cr, Configuration outConfig)

Convenience function to read all of the current configuration-related settings into a Configuration object.

Parameters
cr The ContentResolver to access.
outConfig Where to place the configuration settings.

public static float getFloat (ContentResolver cr, String name, float def)

Convenience function for retrieving a single system 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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid float.

public static float getFloat (ContentResolver cr, String name)

Convenience function for retrieving a single system 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 Settings.SettingNotFoundException.

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • The setting's current value.
Throws
Settings.SettingNotFoundException Thrown if a setting by the given name can't be found or the setting value is not a float.

public static int getInt (ContentResolver cr, String name)

Convenience function for retrieving a single system 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 Settings.SettingNotFoundException.

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • The setting's current value.
Throws
Settings.SettingNotFoundException Thrown if a setting by the given name can't be found or the setting value is not an integer.

public static int getInt (ContentResolver cr, String name, int def)

Convenience function for retrieving a single system 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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid integer.

public static long getLong (ContentResolver cr, String name, long def)

Convenience function for retrieving a single system 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 The ContentResolver to access.
name The name of the setting to retrieve.
def Value to return if the setting is not defined.
Returns
  • The setting's current value, or 'def' if it is not defined or not a valid long.

public static long getLong (ContentResolver cr, String name)

Convenience function for retrieving a single system 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 Settings.SettingNotFoundException.

Parameters
cr The ContentResolver to access.
name The name of the setting to retrieve.
Returns
  • The setting's current value.
Throws
Settings.SettingNotFoundException Thrown if a setting by the given name can't be found or the setting value is not an integer.

public static boolean getShowGTalkServiceStatus (ContentResolver cr)

public static synchronized String getString (ContentResolver resolver, String name)

Look up a name in the database.

Parameters
resolver to access the database with
name to look up in the table
Returns
  • the corresponding value, or null if not present

public static Uri getUriFor (String name)

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

Parameters
name to look up in the table
Returns
  • the corresponding content URI, or null if not present

public static boolean putConfiguration (ContentResolver cr, Configuration config)

Convenience function to write a batch of configuration-related settings from a Configuration object.

Parameters
cr The ContentResolver to access.
config The settings to write.
Returns
  • true if the values were set, false on database errors

public static boolean putFloat (ContentResolver cr, String name, float value)

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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

public static boolean putInt (ContentResolver cr, String name, int value)

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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

public static boolean putLong (ContentResolver cr, String name, long value)

Convenience function for updating a single 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 The ContentResolver to access.
name The name of the setting to modify.
value The new value for the setting.
Returns
  • true if the value was set, false on database errors

public static boolean putString (ContentResolver resolver, String name, String value)

Store a name/value pair into the database.

Parameters
resolver to access the database with
name to store
value to associate with the name
Returns
  • true if the value was set, false on database errors

public static void setShowGTalkServiceStatus (ContentResolver cr, boolean flag)