public static final class Settings.Secure
extends Settings.NameValueTable
java.lang.Object | ||
↳ | android.provider.Settings.NameValueTable | |
↳ | android.provider.Settings.Secure |
保护系统设置,包含应用程序可以读取但不允许写入的系统首选项。 这些用于用户必须通过系统UI或针对这些值的专用API来显式修改的偏好,而不是由应用程序直接修改。
Inherited constants |
---|
From class android.provider.Settings.NameValueTable
|
From interface android.provider.BaseColumns
|
Fields |
|
---|---|
public static final Uri |
CONTENT_URI 此表格的内容://样式网址 |
Public constructors |
|
---|---|
Settings.Secure() |
Public methods |
|
---|---|
static float |
getFloat(ContentResolver cr, String name, float def) 便捷功能,用于将单个安全设置值作为浮点数检索。 |
static float |
getFloat(ContentResolver cr, String name) 便捷功能,用于以浮点形式检索单个安全设置值。 |
static int |
getInt(ContentResolver cr, String name, int def) 用于检索单个安全设置值的便捷功能,以整数形式显示。 |
static int |
getInt(ContentResolver cr, String name) 用于检索单个安全设置值的便捷功能,以整数形式显示。 |
static long |
getLong(ContentResolver cr, String name) 用于检索单个安全设置值的便捷功能,如 |
static long |
getLong(ContentResolver cr, String name, long def) 用于检索单个安全设置值的便捷功能为 |
static String |
getString(ContentResolver resolver, String name) 在数据库中查找一个名称。 |
static Uri |
getUriFor(String name) 构建特定名称/值对的内容URI,这对于使用ContentObserver监视更改很有用。 |
static final boolean |
isLocationProviderEnabled(ContentResolver cr, String provider) 此方法在API级别19中已弃用。请使用 |
static boolean |
putFloat(ContentResolver cr, String name, float value) 用于将单个设置值更新为浮点数的便捷功能。 |
static boolean |
putInt(ContentResolver cr, String name, int value) 用于将单个设置值更新为整数的便捷功能。 |
static boolean |
putLong(ContentResolver cr, String name, long value) 用于将安全设置值更新为长整数的便捷功能。 |
static boolean |
putString(ContentResolver resolver, String name, String value) 将名称/值对存储到数据库中。 |
static final void |
setLocationProviderEnabled(ContentResolver cr, String provider, boolean enabled) 此方法在API级别19中已弃用。请使用 |
Inherited methods |
|
---|---|
From class android.provider.Settings.NameValueTable
|
|
From class java.lang.Object
|
String ACCESSIBILITY_DISPLAY_INVERSION_ENABLED
指定是否启用显示颜色反转的设置。
常量值:“accessibility_display_inversion_enabled”
String ACCESSIBILITY_ENABLED
如果启用了辅助功能。
常量值:“accessibility_enabled”
String ACCESSIBILITY_SPEAK_PASSWORD
是否在无障碍模式下讲密码。
常量值:“speak_password”
String ADB_ENABLED
此常数在API级别17中已弃用。
改为使用ADB_ENABLED
常量值:“adb_enabled”
String ALLOWED_GEOLOCATION_ORIGINS
默认情况下,浏览器应该允许地理位置的起源。 该值是以空格分隔的来源列表。
常量值:“allowed_geolocation_origins”
String ALLOW_MOCK_LOCATION
此常数在API级别23中已弃用。
此设置不再使用。
设置为允许在应用程序开发期间将模拟位置和位置提供程序状态注入到LocationManager服务中以用于测试目的。 这些位置和状态值将覆盖由网络,gps或其他位置提供商生成的实际位置和状态信息。
常量值:“mock_location”
String ANDROID_ID
用户首次设置设备时随机生成的64位数字(作为十六进制字符串),并应在用户设备的整个使用期限内保持不变。 如果在设备上执行出厂重置,该值可能会更改。
注意:当设备有 multiple users (适用于运行Android 4.2或更高版本的某些设备)时,每个用户都显示为完全独立的设备,因此 ANDROID_ID
值对每个用户都是唯一的。
常量值:“android_id”
String BACKGROUND_DATA
此常数在API级别14中已弃用。
从ICE_CREAM_SANDWICH
,背景数据的可用性取决于几个组合因素。 当后台数据不可用时, getActiveNetworkInfo()
现在将显示为已断开连接。
是否允许后台数据使用。
常量值:“background_data”
String BLUETOOTH_ON
此常数在API级别17中已弃用。
改为使用BLUETOOTH_ON
常量值:“bluetooth_on”
String DATA_ROAMING
此常数在API级别17中已弃用。
改为使用DATA_ROAMING
常量值:“data_roaming”
String DEFAULT_INPUT_METHOD
设置为记录默认使用的输入法,保存所需方法的ID。
常量值:“default_input_method”
String DEVELOPMENT_SETTINGS_ENABLED
此常数在API级别17中已弃用。
改为使用DEVELOPMENT_SETTINGS_ENABLED
常量值:“development_settings_enabled”
String DEVICE_PROVISIONED
此常数在API级别17中已弃用。
改为使用DEVICE_PROVISIONED
常量值:“device_provisioned”
String ENABLED_ACCESSIBILITY_SERVICES
启用的辅助功能提供商列表。
常量值:“enabled_accessibility_services”
String ENABLED_INPUT_METHODS
当前启用的输入法列表。 这是一个包含所有启用的输入方法的ID的字符串,每个ID由':'分隔。
常量值:“enabled_input_methods”
String HTTP_PROXY
此常数在API级别17中已弃用。
使用HTTP_PROXY
全局http代理的主机名和端口。 在主机和端口之间使用“分隔符”。
常量值:“http_proxy”
String INPUT_METHOD_SELECTOR_VISIBILITY
设置为记录输入法选择器的可见性
常量值:“input_method_selector_visibility”
String INSTALL_NON_MARKET_APPS
是否可以通过系统的 ACTION_INSTALL_PACKAGE
机制为该用户安装应用程序。
1 =允许通过系统包安装程序意图安装应用程序
0 =不允许使用软件包安装程序
常量值:“install_non_market_apps”
String LOCATION_MODE
用户启用位置访问的程度。
当用于putInt(ContentResolver, String, int)
,必须之一LOCATION_MODE_HIGH_ACCURACY
, LOCATION_MODE_SENSORS_ONLY
, LOCATION_MODE_BATTERY_SAVING
,或LOCATION_MODE_OFF
。 当与getInt(ContentResolver, String)
使用时,调用者必须优雅地处理将来可能添加的其他位置模式。
注意:不要依赖此值存在于settings.db或ContentObserver通知中的相应Uri。 使用MODE_CHANGED_ACTION
可以接收此值的更改。
常量值:“location_mode”
int LOCATION_MODE_BATTERY_SAVING
降低用电量,例如限制每小时更新GPS的次数。 请求POWER_HIGH
可能会降级到POWER_MEDIUM
。
常量值:2(0x00000002)
int LOCATION_MODE_HIGH_ACCURACY
尽力而为地点计算允许。
常量值:3(0x00000003)
int LOCATION_MODE_SENSORS_ONLY
网络位置提供程序禁用,但启用了GPS和其他传感器。
常数值:1(0x00000001)
String LOCATION_PROVIDERS_ALLOWED
此常数在API级别19中已弃用。
使用LOCATION_MODE
和MODE_CHANGED_ACTION
(或PROVIDERS_CHANGED_ACTION
)
活动可以访问的位置提供程序的逗号分隔列表。 不要依赖此值存在于settings.db或相应Uri上的ContentObserver通知中。
常量值:“location_providers_allowed”
String LOCK_PATTERN_ENABLED
此常数在API级别23中已弃用。
使用KeyguardManager
确定键盘锁的状态和安全级别。 从定位M
或更高版本的应用中访问此设置将引发SecurityException
。
是否启用自动锁定(0 = false,1 = true)
常量值:“lock_pattern_autolock”
String LOCK_PATTERN_TACTILE_FEEDBACK_ENABLED
此常数在API级别17中已弃用。
从JELLY_BEAN_MR1
开始,锁屏使用HAPTIC_FEEDBACK_ENABLED
。 从定位M
或更高版本的应用访问此设置会引发SecurityException
。
锁定模式是否会随用户输入而振动(0 = false,1 = true)
常量值:“lock_pattern_tactile_feedback_enabled”
String LOCK_PATTERN_VISIBLE
此常数在API级别23中已弃用。
从定位M
或更高版本的应用中访问此设置会抛出SecurityException
。
用户输入时锁定模式是否可见(0 = false,1 = true)
常量值:“lock_pattern_visible_pattern”
String LOGGING_ID
此常数在API级别3中已弃用。
这个标识符初始化很差,并且有很多冲突。 它不应该被使用。
Logging ID(一个唯一的64位值)作为十六进制字符串。 用作记录的假名标识符。
常量值:“logging_id”
String NETWORK_PREFERENCE
此常数在API级别17中已弃用。
改为使用NETWORK_PREFERENCE
常量值:“network_preference”
String PARENTAL_CONTROL_ENABLED
不再支持。
常量值:“parental_control_enabled”
String PARENTAL_CONTROL_LAST_UPDATE
不再支持。
常量值:“parental_control_last_update”
String PARENTAL_CONTROL_REDIRECT_URL
不再支持。
常量值:“parental_control_redirect_url”
String SELECTED_INPUT_METHOD_SUBTYPE
设置为记录默认使用的输入法子类型,保存所需方法的ID。
常量值:“selected_input_method_subtype”
String SETTINGS_CLASSNAME
从所有应用程序中单击设置时启动设置类名。 因为新旧设置应用程序之间的用户测试需要。
常量值:“settings_classname”
String SKIP_FIRST_USE_HINTS
如果启用,应用程序应尝试跳过首次启动时的任何介绍性提示。 这可能适用于已熟悉环境或临时用户的用户。
类型:int(0显示提示,1跳过显示提示)
常量值:“skip_first_use_hints”
String TOUCH_EXPLORATION_ENABLED
如果触摸探索已启用。
常量值:“touch_exploration_enabled”
String TTS_DEFAULT_COUNTRY
此常数在API级别14中已弃用。
这个设置不再使用,就像冰淇淋三明治版本一样。 应用程序不应直接读取此设置,而应查询TextToSpeech框架类以获取默认语言环境。 getLanguage()
。
默认的文字转语音国家。
常量值:“tts_default_country”
String TTS_DEFAULT_LANG
此常数在API级别14中已弃用。
这个设置不再使用,就像冰淇淋三明治版本一样。 应用程序不应直接读取此设置,而应查询TextToSpeech框架类以获取默认语言环境。 getLanguage()
。
默认的文本语音转换语言。
常量值:“tts_default_lang”
String TTS_DEFAULT_PITCH
默认的文本到语音引擎的音调。 100 = 1x
常量值:“tts_default_pitch”
String TTS_DEFAULT_RATE
默认的文本到语音引擎语速。 100 = 1x
常量值:“tts_default_rate”
String TTS_DEFAULT_VARIANT
此常数在API级别14中已弃用。
这个设置不再使用,就像冰淇淋三明治版本一样。 应用程序不需要直接读取此设置,而是可以查询正在使用的语言环境getLanguage()
的TextToSpeech框架类。
默认的文本到语音语言环境变体。
常量值:“tts_default_variant”
String TTS_ENABLED_PLUGINS
空格分隔的启用的插件包列表。
常量值:“tts_enabled_plugins”
String TTS_USE_DEFAULTS
此常数在API级别14中已弃用。
冰淇淋三明治版本的框架文本语音API不再重视此设置的值。
无论应用程序设置如何,始终设置为始终使用默认的文本到语音设置。 1 =覆盖应用程序设置,0 =使用应用程序设置(如果指定)。
常量值:“tts_use_defaults”
String USB_MASS_STORAGE_ENABLED
此常数在API级别17中已弃用。
改为使用USB_MASS_STORAGE_ENABLED
常量值:“usb_mass_storage_enabled”
String USE_GOOGLE_MAIL
此常数在API级别17中已弃用。
改为使用USE_GOOGLE_MAIL
常数值:“use_google_mail”
String WIFI_MAX_DHCP_RETRY_COUNT
此常数在API级别17中已弃用。
改为使用WIFI_MAX_DHCP_RETRY_COUNT
常数值:“wifi_max_dhcp_retry_count”
String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
此常数在API级别17中已弃用。
改为使用WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
常量值:“wifi_mobile_data_transition_wakelock_timeout_ms”
String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
此常数在API级别17中已弃用。
改为使用WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
。
常量值:“wifi_networks_available_notification_on”
String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
此常数在API级别17中已弃用。
改为使用WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
。
常数值:“wifi_networks_available_repeat_delay”
String WIFI_NUM_OPEN_NETWORKS_KEPT
This constant was deprecated in API level 17.
Use WIFI_NUM_OPEN_NETWORKS_KEPT
instead.
常数值:“wifi_num_open_networks_kept”
String WIFI_ON
This constant was deprecated in API level 17.
Use WIFI_ON
instead.
常数值:“wifi_on”
String WIFI_WATCHDOG_ACCEPTABLE_PACKET_LOSS_PERCENTAGE
此常数在API级别14中已弃用。
此设置未使用。
在同一网络上尝试另一个AP之前,可接受的数据包丢失百分比(范围为0 - 100)。
常数值:“wifi_watchdog_acceptable_packet_loss_percentage”
String WIFI_WATCHDOG_AP_COUNT
此常数在API级别14中已弃用。
此设置未使用。
网络所需的接入点数量,以便看门狗对其进行监控。
常量值:“wifi_watchdog_ap_count”
String WIFI_WATCHDOG_BACKGROUND_CHECK_DELAY_MS
此常数在API级别14中已弃用。
此设置未使用。
背景检查之间的延迟。
常量值:“wifi_watchdog_background_check_delay_ms”
String WIFI_WATCHDOG_BACKGROUND_CHECK_ENABLED
此常数在API级别14中已弃用。
此设置未使用。
即使在认为用户连接到良好的接入点后,Wi-Fi看门狗是否仍可用于后台检查。
常量值:“wifi_watchdog_background_check_enabled”
String WIFI_WATCHDOG_BACKGROUND_CHECK_TIMEOUT_MS
此常数在API级别14中已弃用。
此设置未使用。
后台ping超时
常量值:“wifi_watchdog_background_check_timeout_ms”
String WIFI_WATCHDOG_INITIAL_IGNORED_PING_COUNT
此常数在API级别14中已弃用。
此设置未使用。
如果失败,可能会忽略执行该*的初始ping的数量。 同样,如果这些失败,它们将不会用于分组丢失计算。 例如,一个网络似乎总是等待第一对夫妇ping,所以默认设置为3。
常数值:“wifi_watchdog_initial_ignored_ping_count”
String WIFI_WATCHDOG_MAX_AP_CHECKS
此常数在API级别14中已弃用。
此设置未使用。
试图测试的最大接入点数量(每个网络)。 如果达到此数量,看门狗将不再监视网络的初始连接状态。 这是包含多个AP的网络的安全措施,其DNS不响应ping。
常数值:“wifi_watchdog_max_ap_checks”
String WIFI_WATCHDOG_ON
此常数在API级别17中已弃用。
改为使用WIFI_WATCHDOG_ON
常数值:“wifi_watchdog_on”
String WIFI_WATCHDOG_PING_COUNT
此常数在API级别14中已弃用。
此设置未使用。
用于测试接入点是否良好连接的ping的数量。
常数值:“wifi_watchdog_ping_count”
String WIFI_WATCHDOG_PING_DELAY_MS
此常数在API级别14中已弃用。
此设置未使用。
ping之间的延迟。
常量值:“wifi_watchdog_ping_delay_ms”
String WIFI_WATCHDOG_PING_TIMEOUT_MS
此常数在API级别14中已弃用。
此设置未使用。
每次ping的超时。
常量值:“wifi_watchdog_ping_timeout_ms”
String WIFI_WATCHDOG_WATCH_LIST
此常数在API级别14中已弃用。
此设置未使用。
应该启用Wi-Fi监视器的SSID的逗号分隔列表。
常数值:“wifi_watchdog_watch_list”
float getFloat (ContentResolver cr, String name, float def)
便捷功能,用于将单个安全设置值作为浮点数检索。 请注意,内部设置值始终以字符串形式存储; 这个函数将字符串转换为一个浮点数。 如果设置未定义或不是有效的浮点数,将返回默认值。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
def |
float : Value to return if the setting is not defined. |
Returns | |
---|---|
float |
The setting's current value, or 'def' if it is not defined or not a valid float. |
float getFloat (ContentResolver cr, String name)
便捷功能,用于以浮点形式检索单个安全设置值。 请注意,内部设置值始终以字符串形式存储; 这个函数将字符串转换为一个浮点数。
该版本不采用默认值。 如果设置尚未设置,或者字符串值不是数字,则会抛出Settings.SettingNotFoundException
。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
Returns | |
---|---|
float |
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. |
int getInt (ContentResolver cr, String name, int def)
用于检索单个安全设置值的便捷功能,以整数形式显示。 请注意,内部设置值始终以字符串形式存储; 这个函数将字符串转换为一个整数。 如果设置未定义或不是整数,则将返回默认值。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
def |
int : Value to return if the setting is not defined. |
Returns | |
---|---|
int |
The setting's current value, or 'def' if it is not defined or not a valid integer. |
int getInt (ContentResolver cr, String name)
用于检索单个安全设置值的便捷功能,以整数形式显示。 请注意,内部设置值始终以字符串形式存储; 这个函数将字符串转换为一个整数。
该版本不采用默认值。 如果设置尚未设置,或者字符串值不是数字,则会抛出Settings.SettingNotFoundException
。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
Returns | |
---|---|
int |
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. |
long getLong (ContentResolver cr, String name)
用于检索单个安全设置值的便捷功能,如long
。 请注意,内部设置值始终以字符串形式存储; 此函数将字符串转换为long
。
该版本不采用默认值。 如果设置尚未设置,或者字符串值不是数字,则会抛出Settings.SettingNotFoundException
。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
Returns | |
---|---|
long |
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. |
long getLong (ContentResolver cr, String name, long def)
用于检索单个安全设置值的便捷功能,如long
。 请注意,内部设置值始终以字符串形式存储; 此函数将字符串转换为long
。 如果未定义设置或不是long
将返回默认值。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to retrieve. |
def |
long : Value to return if the setting is not defined. |
Returns | |
---|---|
long |
The setting's current value, or 'def' if it is not defined or not a valid long . |
String getString (ContentResolver resolver, String name)
在数据库中查找一个名称。
Parameters | |
---|---|
resolver |
ContentResolver : to access the database with |
name |
String : to look up in the table |
Returns | |
---|---|
String |
the corresponding value, or null if not present |
Uri getUriFor (String name)
构建特定名称/值对的内容URI,这对于使用ContentObserver监视更改很有用。
Parameters | |
---|---|
name |
String : to look up in the table |
Returns | |
---|---|
Uri |
the corresponding content URI, or null if not present |
boolean isLocationProviderEnabled (ContentResolver cr, String provider)
此方法在API级别19中已被弃用。
使用LOCATION_MODE
或isProviderEnabled(String)
确定位置提供者是否启用的帮助方法。
Parameters | |
---|---|
cr |
ContentResolver : the content resolver to use |
provider |
String : the location provider to query |
Returns | |
---|---|
boolean |
true if the provider is enabled |
boolean putFloat (ContentResolver cr, String name, float value)
用于将单个设置值更新为浮点数的便捷功能。 如果给定名称不存在,这将在表中创建一个新条目,或者使用该名称修改现有行的值。 请注意,内部设置值始终以字符串形式存储,因此此函数在将其存储之前将给定值转换为字符串。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to modify. |
value |
float : The new value for the setting. |
Returns | |
---|---|
boolean |
true if the value was set, false on database errors |
boolean putInt (ContentResolver cr, String name, int value)
用于将单个设置值更新为整数的便捷功能。 如果给定名称不存在,这将在表中创建一个新条目,或者使用该名称修改现有行的值。 请注意,内部设置值始终以字符串形式存储,因此此函数在将其存储之前将给定值转换为字符串。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to modify. |
value |
int : The new value for the setting. |
Returns | |
---|---|
boolean |
true if the value was set, false on database errors |
boolean putLong (ContentResolver cr, String name, long value)
用于将安全设置值更新为长整数的便捷功能。 如果给定名称不存在,这将在表中创建一个新条目,或者使用该名称修改现有行的值。 请注意,内部设置值始终以字符串形式存储,因此此函数在将其存储之前将给定值转换为字符串。
Parameters | |
---|---|
cr |
ContentResolver : The ContentResolver to access. |
name |
String : The name of the setting to modify. |
value |
long : The new value for the setting. |
Returns | |
---|---|
boolean |
true if the value was set, false on database errors |
boolean putString (ContentResolver resolver, String name, String value)
将名称/值对存储到数据库中。
Parameters | |
---|---|
resolver |
ContentResolver : to access the database with |
name |
String : to store |
value |
String : to associate with the name |
Returns | |
---|---|
boolean |
true if the value was set, false on database errors |
void setLocationProviderEnabled (ContentResolver cr, String provider, boolean enabled)
此方法在API级别19中已被弃用。
使用putInt(ContentResolver, String, int)
和LOCATION_MODE
用于启用或禁用单个位置提供程序的线程安全方法。
Parameters | |
---|---|
cr |
ContentResolver : the content resolver to use |
provider |
String : the location provider to enable or disable |
enabled |
boolean : true if the provider should be enabled |