public static final class Settings.Global
extends Settings.NameValueTable
java.lang.Object | ||
↳ | android.provider.Settings.NameValueTable | |
↳ | android.provider.Settings.Global |
全局系统设置,包含始终适用于所有已定义用户的首选项。 应用程序可以读取这些内容但不允许写入; 如“安全”设置,这些设置适用于用户必须通过系统UI或专用API为这些值显式修改的首选项。
Inherited constants |
---|
From class android.provider.Settings.NameValueTable
|
From interface android.provider.BaseColumns
|
Fields |
|
---|---|
public static final Uri |
CONTENT_URI 全球安全设置项目的内容://样式URL。 |
Public constructors |
|
---|---|
Settings.Global() |
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) 用于检索单个安全设置值的便捷功能,以整数形式显示。 |
static int |
getInt(ContentResolver cr, String name, int def) 用于检索单个安全设置值的便捷功能,以整数形式显示。 |
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 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) 将名称/值对存储到数据库中。 |
Inherited methods |
|
---|---|
From class android.provider.Settings.NameValueTable
|
|
From class java.lang.Object
|
String AIRPLANE_MODE_RADIOS
在飞行模式打开时需要禁用的以逗号分隔的无线电列表。 这会覆盖WIFI_ON和BLUETOOTH_ON,如果Wi-Fi和蓝牙包含在逗号分隔列表中。
常数值:“airplane_mode_radios”
String ALWAYS_FINISH_ACTIVITIES
如果不是0,则活动管理器将在不再需要时立即积极完成活动和流程。 如果为0,则使用正常的扩展生命周期。
常量值:“always_finish_activities”
String ANIMATOR_DURATION_SCALE
基于动画制作动画的缩放因子。 这会影响所有这些动画的开始延迟和持续时间。 设置为0将导致动画立即结束。 默认值是1。
常量值:“animator_duration_scale”
String AUTO_TIME
用于指定用户是否愿意自动从网络中获取日期,时间和时区的值(NITZ)。 1 =是,0 =否
常量值:“auto_time”
String AUTO_TIME_ZONE
用于指定用户是否偏好从网络自动提取时区的值(NITZ)。 1 =是,0 =否
常量值:“auto_time_zone”
String CONTACT_METADATA_SYNC_ENABLED
是否启用联系人元数据同步或不启用值1 - 启用,0 - 禁用
常量值:“contact_metadata_sync_enabled”
String DEVELOPMENT_SETTINGS_ENABLED
用户是否启用了开发设置。
常量值:“development_settings_enabled”
String DEVICE_PROVISIONED
设备是否已配置(0 = false,1 = true)。
在具有单独系统用户的多用户设备上,一旦设置为true,屏幕可能会被锁定,并且系统用户无法启动其他活动,除非它们被标记为通过键盘锁显示。
常量值:“device_provisioned”
String HTTP_PROXY
全局http代理的主机名和端口。 在主机和端口之间使用“分隔符”。
常量值:“http_proxy”
String INSTALL_NON_MARKET_APPS
此常数在API级别21中已弃用。
改为使用INSTALL_NON_MARKET_APPS
常量值:“install_non_market_apps”
String MODE_RINGER
林格模式。 这是内部使用的,改变这个值不会改变振铃模式。 请参阅AudioManager。
常量值:“mode_ringer”
String NETWORK_PREFERENCE
用户首选应使用哪个网络。 只有连接服务应该触及这个。
常量值:“network_preference”
String RADIO_BLUETOOTH
用于AIRPLANE_MODE_RADIOS以指定蓝牙无线电的常量。
常数值:“蓝牙”
String STAY_ON_WHILE_PLUGGED_IN
我们是否在设备插入时保持开启。支持的值有:
0
to never stay on while plugged inBATTERY_PLUGGED_AC
to stay on for AC chargerBATTERY_PLUGGED_USB
to stay on for USB chargerBATTERY_PLUGGED_WIRELESS
to stay on for wireless charger常量值:“stay_on_while_plugged_in”
String TRANSITION_ANIMATION_SCALE
活动转换动画的缩放因子。 设置为0将禁用窗口动画。
常量值:“transition_animation_scale”
String USB_MASS_STORAGE_ENABLED
USB大容量存储已启用
常量值:“usb_mass_storage_enabled”
String USE_GOOGLE_MAIL
如果此设置已设置(对任何内容),则设备上的所有Gmail引用都必须更改为Google Mail。
常数值:“use_google_mail”
String WAIT_FOR_DEBUGGER
如果是1,启动DEBUG_APP时它将在启动用户代码之前等待调试器。 如果为0,它将正常运行。
常量值:“wait_for_debugger”
String WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN
此设置控制是否应锁定设备所有者应用程序创建的WiFi配置(即,只能由设备所有者应用程序进行编辑或删除,甚至不能通过设置应用程序进行编辑或删除)。 该设置采用整数值。 非零值意味着DO创建的配置被锁定。 零值意味着它们不是。 如果缺少此设置的实际值,则默认值为0。
常量值:“wifi_device_owner_configs_lockdown”
String WIFI_MAX_DHCP_RETRY_COUNT
我们将重新尝试连接到我们无法从DHCP获取IP地址的接入点的最大次数。 N值表示我们将进行N + 1次连接尝试。
常数值:“wifi_max_dhcp_retry_count”
String WIFI_MOBILE_DATA_TRANSITION_WAKELOCK_TIMEOUT_MS
在断开与Wi-Fi的连接后等待移动数据连接建立时,持续唤醒锁的最长时间(以毫秒为单位)。
常量值:“wifi_mobile_data_transition_wakelock_timeout_ms”
String WIFI_NETWORKS_AVAILABLE_NOTIFICATION_ON
是否通知开放网络的用户。
如果没有连接并且扫描结果具有开放的网络,我们会通知您。 如果我们试图连接到网络或者开放网络消失,我们会删除通知。 当我们显示通知时,我们将不会再次显示WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
时间。
常量值:“wifi_networks_available_notification_on”
String WIFI_NETWORKS_AVAILABLE_REPEAT_DELAY
在重复Wi-Fi网络可用通知之前延迟(以秒为单位)。 连接到网络将重置计时器。
常数值:“wifi_networks_available_repeat_delay”
String WIFI_NUM_OPEN_NETWORKS_KEPT
当开放网络的数量超过此数量时,最近最少使用的超额网络将被删除。
常数值:“wifi_num_open_networks_kept”
String WIFI_SLEEP_POLICY
决定Wi-Fi何时应该进入休眠状态的策略(它将转而使用移动数据作为Internet连接)。
设置为一个 WIFI_SLEEP_POLICY_DEFAULT
, WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED
,或 WIFI_SLEEP_POLICY_NEVER
。
常数值:“wifi_sleep_policy”
int WIFI_SLEEP_POLICY_DEFAULT
WIFI_SLEEP_POLICY
值用于使用默认的Wi-Fi睡眠策略,该策略在根据 STAY_ON_WHILE_PLUGGED_IN
设置关闭后立即休眠。
常量值:0(0x00000000)
int WIFI_SLEEP_POLICY_NEVER
WIFI_SLEEP_POLICY
值不会进入睡眠状态。
常量值:2(0x00000002)
int WIFI_SLEEP_POLICY_NEVER_WHILE_PLUGGED
WIFI_SLEEP_POLICY
在设备使用电池时使用默认策略,并且在设备插入时绝不会进入睡眠状态。
常数值:1(0x00000001)
String WINDOW_ANIMATION_SCALE
正常窗口动画的缩放因子。 设置为0将禁用窗口动画。
常量值:“window_animation_scale”
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)
用于检索单个安全设置值的便捷功能,以整数形式显示。 请注意,内部设置值始终以字符串形式存储; 这个函数将字符串转换为一个整数。
该版本不采用默认值。 如果设置尚未设置,或者字符串值不是数字,则会抛出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. |
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. |
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 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 |