提交 1948ea35 编写于 作者: S shaoziyang

update js-apis-settings.md

Signed-off-by: Nshaoziyang <shaoziyang1@huawei.com>
上级 d65ec140
# 设置数据项名称 # 设置数据项名称
本模块提供对设置数据项访问的相关接口的说明及示例 本模块提供访问设置数据项的能力
> **说明:** > **说明:**
> >
...@@ -22,10 +22,10 @@ import settings from '@ohos.settings'; ...@@ -22,10 +22,10 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| DATE_FORMAT | string | 是 | 否 | 日期格式。<br/>日期格式包括mm/dd/yyyy、dd/mm/yyyy和yyyy/mm/dd ,其中mm、dd和yyyy分别代表月份、日期和年份 | | DATE_FORMAT | string | 是 | 否 | 日期格式。<br/>日期格式包括mm/dd/yyyy、dd/mm/yyyy和yyyy/mm/dd ,其中mm、dd和yyyy分别代表月份、日期和年份 |
| TIME_FORMAT | string | 是 | 否 | 时间是以 12 小时格式还是 24 小时格式显示。<br>值为 “12” 表示12小时格式;<br/>值为 ”24“ 表示24小时格式。 | | TIME_FORMAT | string | 是 | 否 | 时间是以12小时格式还是24小时格式显示。<br>值为 “12” 表示12小时格式;<br/>值为 ”24“ 表示24小时格式。 |
| AUTO_GAIN_TIME | string | 是 | 否 | 是否自动从网络获取日期、时间和时区。 <br>值为 true 表示自动从网络获取信息;<br/>值为 false 表示不自动获取。 | | AUTO_GAIN_TIME | string | 是 | 否 | 是否自动从网络获取日期、时间和时区。 <br>值为true表示自动从网络获取信息;<br/>值为false表示不自动获取。 |
| AUTO_GAIN_TIME_ZONE | string | 是 | 否 | 是否自动从 NITZ 获取时区。 <br>值为 true 表示自动获取;<br/>值为 false 表示不自动获取。 | | AUTO_GAIN_TIME_ZONE | string | 是 | 否 | 是否自动从 NITZ 获取时区。 <br>值为true表示自动获取;<br/>值为false表示不自动获取。 |
## display ## display
...@@ -37,17 +37,17 @@ import settings from '@ohos.settings'; ...@@ -37,17 +37,17 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | ----------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| FONT_SCALE | string | 是 | 否 | 字体的比例因子,即浮点数。 | | FONT_SCALE | string | 是 | 否 | 字体的比例因子,值为浮点数。 |
| SCREEN_BRIGHTNESS_STATUS | string | 是 | 否 | 屏幕亮度。该值的范围从 0 到 255。 | | SCREEN_BRIGHTNESS_STATUS | string | 是 | 否 | 屏幕亮度。该值的范围从0到255。 |
| AUTO_SCREEN_BRIGHTNESS | string | 是 | 否 | 是否启用屏幕亮度自动调整。<br/>值为1 ,表示启用自动调整;<br/>值为 0 ,表示不启用自动调整。 | | AUTO_SCREEN_BRIGHTNESS | string | 是 | 否 | 是否启用屏幕亮度自动调整。<br/>值为1,表示启用自动调整;<br/>值为0,表示不启用自动调整。 |
| AUTO_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度自动调整时 AUTO_SCREEN_BRIGHTNESS 的值。 | | AUTO_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度自动调整时 AUTO_SCREEN_BRIGHTNESS 的值。 |
| MANUAL_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度手动调整时的 AUTO_SCREEN_BRIGHTNESS 值。 | | MANUAL_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度手动调整时的 AUTO_SCREEN_BRIGHTNESS 值。 |
| SCREEN_OFF_TIMEOUT | string | 是 | 否 | 设备在一段时间不活动后进入睡眠状态的等待时间(以毫秒为单位)。 | | SCREEN_OFF_TIMEOUT | string | 是 | 否 | 设备在一段时间不活动后进入睡眠状态的等待时间(单位:ms)。 |
| DEFAULT_SCREEN_ROTATION | string | 是 | 否 | 启用自动旋转时,此常量无效;不启用自动旋转时,以下值可用:<br>值为 0,表示屏幕旋转 0 度;<br>值为 1,表示屏幕旋转 90 度;<br/>值为 2,表示屏幕旋转 180 度;<br/>值为 3,表示屏幕旋转 270 度。 | | DEFAULT_SCREEN_ROTATION | string | 是 | 否 | 启用自动旋转时,此常量无效;不启用自动旋转时,以下值可用:<br>值为0,表示屏幕旋转0度;<br>值为1,表示屏幕旋转90度;<br/>值为2,表示屏幕旋转180度;<br/>值为3,表示屏幕旋转270度。 |
| ANIMATOR_DURATION_SCALE | string | 是 | 否 | 动画持续时间的比例因子。这会影响所有此类动画的开始延迟和持续时间。<br/>值为 0 ,表示动画将立即结束,默认值为 1 。 | | ANIMATOR_DURATION_SCALE | string | 是 | 否 | 动画持续时间的比例因子。这会影响所有此类动画的开始延迟和持续时间。<br/>值为0,表示动画将立即结束,默认值为1。 |
| TRANSITION_ANIMATION_SCALE | string | 是 | 否 | 过渡动画的比例因子。<br/>值为 0 ,表示禁用过渡动画。 | | TRANSITION_ANIMATION_SCALE | string | 是 | 否 | 过渡动画的比例因子。<br/>值为0,表示禁用过渡动画。 |
| WINDOW_ANIMATION_SCALE | string | 是 | 否 | 普通窗口动画的比例因子。<br/>值为 0 ,表示禁用窗口动画。 | | WINDOW_ANIMATION_SCALE | string | 是 | 否 | 普通窗口动画的比例因子。<br/>值为0,表示禁用窗口动画。 |
| DISPLAY_INVERSION_STATUS | string | 是 | 否 | 是否启用显示颜色反转。<br/>值为1 ,表示启用显示颜色反转;<br/>值为0 ,表示不启用显示颜色反转。 | | DISPLAY_INVERSION_STATUS | string | 是 | 否 | 是否启用显示颜色反转。<br/>值为1,表示启用显示颜色反转;<br/>值为0,表示不启用显示颜色反转。 |
## general ## general
...@@ -59,24 +59,24 @@ import settings from '@ohos.settings'; ...@@ -59,24 +59,24 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | -------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| SETUP_WIZARD_FINISHED | string | 是 | 否 | 是否已运行启动向导。<br>值为 0 ,表示启动向导尚未运行;<br/>值不是 0 ,表示启动向导已运行。 | | SETUP_WIZARD_FINISHED | string | 是 | 否 | 是否已运行启动向导。<br>值为0,表示启动向导尚未运行;<br/>值不是0,表示启动向导已运行。 |
| END_BUTTON_ACTION | string | 是 | 否 | 在用户不在呼叫中时用户按下呼叫结束按钮后发生的情况。<br/>值为0,表示没有任何反应;<br/>值为1,表示显示主屏幕;<br/>值为2,表示设备进入睡眠状态,屏幕锁定;<br/>值为3,表示显示主屏幕。用户已在主屏幕上,表示设备将进入睡眠状态。 | | END_BUTTON_ACTION | string | 是 | 否 | 在用户不在呼叫中时用户按下呼叫结束按钮后发生的情况。<br/>值为0,表示没有任何反应;<br/>值为1,表示显示主屏幕;<br/>值为2,表示设备进入睡眠状态,屏幕锁定;<br/>值为3,表示显示主屏幕。用户已在主屏幕上,表示设备将进入睡眠状态。 |
| ACCELEROMETER_ROTATION_STATUS | string | 是 | 否 | 是否使用加速计更改屏幕方向,即是否启用自动旋转。<br> 1 表示默认情况下启用加速度计;<br/> 值为0 表示默认情况下不启用加速计。 | | ACCELEROMETER_ROTATION_STATUS | string | 是 | 否 | 是否使用加速计更改屏幕方向,即是否启用自动旋转。<br>1表示默认情况下启用加速度计;<br/> 值为0表示默认情况下不启用加速计。 |
| AIRPLANE_MODE_STATUS | string | 是 | 否 | 是否启用飞行模式。<br>值为 1 ,表示启用飞行模式;<br/>值为 0 ,表示不启用飞行模式。 | | AIRPLANE_MODE_STATUS | string | 是 | 否 | 是否启用飞行模式。<br>值为1,表示启用飞行模式;<br/>值为0,表示不启用飞行模式。 |
| DEVICE_PROVISION_STATUS | string | 是 | 否 | 是否预配设备。<br>在具有单个系统用户的多用户设备上,当值为 true 时,屏幕可能会被锁定。此外,其他功能无法在系统用户上启动,除非它们被标记为在屏幕锁定上显示。 | | DEVICE_PROVISION_STATUS | string | 是 | 否 | 是否预配设备。<br>在具有单个系统用户的多用户设备上,当值为true时,屏幕可能会被锁定。此外,其他功能无法在系统用户上启动,除非它们被标记为在屏幕锁定上显示。 |
| HDC_STATUS | string | 是 | 否 | 是否启用 USB 设备上的硬盘控制器 (HDC)。<br>值为 true ,表示启用 HDC;<br/>值为 false ,表示不启用 HDC。 | | HDC_STATUS | string | 是 | 否 | 是否启用 USB 设备上的硬盘控制器 (HDC)。<br>值为true,表示启用 HDC;<br/>值为false,表示不启用 HDC。 |
| BOOT_COUNTING | string | 是 | 否 | 设备开机后的启动操作数。 | | BOOT_COUNTING | string | 是 | 否 | 设备开机后的启动操作数。 |
| CONTACT_METADATA_SYNC_STATUS | string | 是 | 否 | 是否启用联系人元数据同步。<br>值为 true ,表示启用同步;<br/>值为 false ,表示不启用同步。 | | CONTACT_METADATA_SYNC_STATUS | string | 是 | 否 | 是否启用联系人元数据同步。<br>值为true,表示启用同步;<br/>值为false,表示不启用同步。 |
| DEVELOPMENT_SETTINGS_STATUS | string | 是 | 否 | 是否启用开发人员选项。<br>值为 true ,表示启用开发人员选项;<br/>值为 false ,表示不启用开发人员选项。 | | DEVELOPMENT_SETTINGS_STATUS | string | 是 | 否 | 是否启用开发人员选项。<br>值为true,表示启用开发人员选项;<br/>值为false,表示不启用开发人员选项。 |
| DEVICE_NAME | string | 是 | 否 | 设备名称。 | | DEVICE_NAME | string | 是 | 否 | 设备名称。 |
| USB_STORAGE_STATUS | string | 是 | 否 | 是否启用 USB 大容量存储。<br>值为 true ,表示启用 USB 大容量存储;<br/>值为 false ,表示不启用 USB 大容量存储。 | | USB_STORAGE_STATUS | string | 是 | 否 | 是否启用 USB 大容量存储。<br>值为true,表示启用 USB 大容量存储;<br/>值为false,表示不启用 USB 大容量存储。 |
| DEBUGGER_WAITING | string | 是 | 否 | 设备在启动应用程序进行调试时是否等待调试器进行调试。<br>值为 1 ,表示设备等待调试器;<br/>值为 0 ,表示系统不会等待调试器,因此应用程序会正常运行。 | | DEBUGGER_WAITING | string | 是 | 否 | 设备在启动应用程序进行调试时是否等待调试器进行调试。<br>值为1,表示设备等待调试器;<br/>值为0,表示系统不会等待调试器,因此应用程序会正常运行。 |
| DEBUG_APP_PACKAGE | string | 是 | 否 | 要调试的应用程序的捆绑包名称。 | | DEBUG_APP_PACKAGE | string | 是 | 否 | 要调试的应用程序的捆绑包名称。 |
| ACCESSIBILITY_STATUS | string | 是 | 否 | 是否启用任何辅助功能。<br>值为 1 ,表示启用辅助功能;<br/>值为 0 ,表示不启用辅助功能。 | | ACCESSIBILITY_STATUS | string | 是 | 否 | 是否启用任何辅助功能。<br>值为1,表示启用辅助功能;<br/>值为0,表示不启用辅助功能。 |
| ACTIVATED_ACCESSIBILITY_SERVICES | string | 是 | 否 | 已激活的辅助功能的列表。 | | ACTIVATED_ACCESSIBILITY_SERVICES | string | 是 | 否 | 已激活的辅助功能的列表。 |
| GEOLOCATION_ORIGINS_ALLOWED | string | 是 | 否 | 浏览器可以使用的默认地理位置。多个地理位置由空格分隔。 | | GEOLOCATION_ORIGINS_ALLOWED | string | 是 | 否 | 浏览器可以使用的默认地理位置。多个地理位置由空格分隔。 |
| SKIP_USE_HINTS | string | 是 | 否 | 应用程序是否应在首次启动时尝试跳过所有介绍性提示。这适用于临时用户或熟悉环境的用户。<br>值为 1 ,表示应用程序将尝试在第一次启动时跳过所有介绍性提示;<br/>值为 0 ,表示应用程序不会在首次启动时跳过介绍性提示。 | | SKIP_USE_HINTS | string | 是 | 否 | 应用程序是否应在首次启动时尝试跳过所有介绍性提示。这适用于临时用户或熟悉环境的用户。<br>值为1,表示应用程序将尝试在第一次启动时跳过所有介绍性提示;<br/>值为0,表示应用程序不会在首次启动时跳过介绍性提示。 |
| TOUCH_EXPLORATION_STATUS | string | 是 | 否 | 是否启用触摸浏览。<br>值为 1 ,表示启用触摸浏览;<br/>值为 0 ,表示不启用触摸浏览。 | | TOUCH_EXPLORATION_STATUS | string | 是 | 否 | 是否启用触摸浏览。<br>值为1,表示启用触摸浏览;<br/>值为0,表示不启用触摸浏览。 |
## input ## input
...@@ -90,12 +90,12 @@ import settings from '@ohos.settings'; ...@@ -90,12 +90,12 @@ import settings from '@ohos.settings';
| ------------------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | | ------------------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ |
| DEFAULT_INPUT_METHOD | string | 是 | 否 | 默认输入法及其 ID。 | | DEFAULT_INPUT_METHOD | string | 是 | 否 | 默认输入法及其 ID。 |
| ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 否 | 默认输入法键盘类型及其 ID。 | | ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 否 | 默认输入法键盘类型及其 ID。 |
| ACTIVATED_INPUT_METHODS | string | 是 | 否 | 已激活的输入法的列表。<br>该列表是一个字符串,其中包含已激活输入法的 ID。ID 由冒号':'分隔,输入法的键盘类型由分号';'分隔。示例格式是 ima0: keyboardType0; keyboardType1; ima1: ima2: keyboardTypes0 。imaID 的类型是 ElementName,keyboard的类型是 int。 | | ACTIVATED_INPUT_METHODS | string | 是 | 否 | 已激活的输入法的列表。<br>该列表是一个字符串,其中包含已激活输入法的 ID。ID 由冒号':'分隔,输入法的键盘类型由分号';'分隔。示例格式是 ima0: keyboardType0; keyboardType1; ima1: ima2: keyboardTypes0。imaID 的类型是 ElementName,keyboard的类型是 int。 |
| SELECTOR_VISIBILITY_FOR_INPUT_METHOD | string | 是 | 否 | 输入法选择器是否可见。<br>值为 1 ,表示输入法选择器可见;<br/>值为 0 ,表示输入法选择器不可见。 | | SELECTOR_VISIBILITY_FOR_INPUT_METHOD | string | 是 | 否 | 输入法选择器是否可见。<br>值为1,表示输入法选择器可见;<br/>值为0,表示输入法选择器不可见。 |
| AUTO_CAPS_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动大写。<br>值为 0 ,表示不启用自动大写;<br/>值为 1 ,表示启用自动大写。 | | AUTO_CAPS_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动大写。<br>值为0,表示不启用自动大写;<br/>值为1,表示启用自动大写。 |
| AUTO_PUNCTUATE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动标点符号。自动标点符号使文本编辑器能够将两个空格转换为句点'.'和空格。<br>值为 0 ,表示不启用自动标点符号;<br/>值为 1 ,表示启用自动标点符号。 | | AUTO_PUNCTUATE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动标点符号。自动标点符号使文本编辑器能够将两个空格转换为句点'.'和空格。<br>值为0,表示不启用自动标点符号;<br/>值为1,表示启用自动标点符号。 |
| AUTO_REPLACE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动更正。自动更正使文本编辑器能够更正拼写错误。<br>值为 0 ,表示不启用自动更正;<br/>值为 1 ,表示启用自动更正。 | | AUTO_REPLACE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动更正。自动更正使文本编辑器能够更正拼写错误。<br>值为0,表示不启用自动更正;<br/>值为1,表示启用自动更正。 |
| SHOW_PASSWORD_TEXT_INPUT | string | 是 | 否 | 是否在文本编辑器中启用密码显示。密码显示使文本编辑器能够在用户键入密码字符时显示密码字符。<br>值为 0 ,表示不启用密码显示;<br/>值为 1 ,表示启用密码显示。 | | SHOW_PASSWORD_TEXT_INPUT | string | 是 | 否 | 是否在文本编辑器中启用密码显示。密码显示使文本编辑器能够在用户键入密码字符时显示密码字符。<br>值为0,表示不启用密码显示;<br/>值为1,表示启用密码显示。 |
## network ## network
...@@ -107,7 +107,7 @@ import settings from '@ohos.settings'; ...@@ -107,7 +107,7 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | | ------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ |
| DATA_ROAMING_STATUS | string | 是 | 否 | 是否启用数据漫游。<br>值为 true ,表示启用数据漫游;<br/>值为 false ,表示不启用数据漫游。 | | DATA_ROAMING_STATUS | string | 是 | 否 | 是否启用数据漫游。<br>值为true,表示启用数据漫游;<br/>值为false,表示不启用数据漫游。 |
| HTTP_PROXY_CFG | string | 是 | 否 | 全局 HTTP 代理的主机名和端口号。主机名和端口号由冒号':'分隔。 | | HTTP_PROXY_CFG | string | 是 | 否 | 全局 HTTP 代理的主机名和端口号。主机名和端口号由冒号':'分隔。 |
| NETWORK_PREFERENCE_USAGE | string | 是 | 否 | 要使用的网络的用户首选项。 | | NETWORK_PREFERENCE_USAGE | string | 是 | 否 | 要使用的网络的用户首选项。 |
...@@ -121,7 +121,7 @@ import settings from '@ohos.settings'; ...@@ -121,7 +121,7 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | | ------------------ | ------ | ---- | ---- | ------------------------------------------------------------ |
| RTT_CALLING_STATUS | string | 是 | 否 | 是否启用实时文本 (RTT) 呼叫。启用,来电和去电在设备和运营商支持时作为 RTT 呼叫应答。 <br> 值为 1 ,表示启用RTT 呼叫; <br/> 值为 0 ,表示不启用 RTT 呼叫。 | | RTT_CALLING_STATUS | string | 是 | 否 | 是否启用实时文本 (RTT) 呼叫。启用,来电和去电在设备和运营商支持时作为 RTT 呼叫应答。 <br> 值为1,表示启用RTT 呼叫; <br/> 值为0,表示不启用 RTT 呼叫。 |
## sound ## sound
...@@ -135,14 +135,14 @@ import settings from '@ohos.settings'; ...@@ -135,14 +135,14 @@ import settings from '@ohos.settings';
| ---------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | ---------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| VIBRATE_WHILE_RINGING | string | 是 | 否 | 设备在来电响铃时是否振动。此常量将由电话和设置应用程序使用。 该值是布尔类型,仅影响设备因来电而响铃的情况,不影响任何其他应用程序或场景。 | | VIBRATE_WHILE_RINGING | string | 是 | 否 | 设备在来电响铃时是否振动。此常量将由电话和设置应用程序使用。 该值是布尔类型,仅影响设备因来电而响铃的情况,不影响任何其他应用程序或场景。 |
| DEFAULT_ALARM_ALERT | string | 是 | 否 | 系统默认告警的存储区域。 | | DEFAULT_ALARM_ALERT | string | 是 | 否 | 系统默认告警的存储区域。 |
| DTMF_TONE_TYPE_WHILE_DIALING | string | 是 | 否 | 拨号时播放的双音多频 (DTMF) 音的类型。 <br>值为0 表示常规的短音效,<br/>值为1 表示长音效。 | | DTMF_TONE_TYPE_WHILE_DIALING | string | 是 | 否 | 拨号时播放的双音多频 (DTMF) 音的类型。 <br>值为0表示常规的短音效,<br/>值为1表示长音效。 |
| DTMF_TONE_WHILE_DIALING | string | 是 | 否 | 拨号时是否播放 DTMF 音。<br>值为 1 ,表示播放 DTMF 音;<br/>值为 0 ,表示不播放。 | | DTMF_TONE_WHILE_DIALING | string | 是 | 否 | 拨号时是否播放 DTMF 音。<br>值为1,表示播放 DTMF 音;<br/>值为0,表示不播放。 |
| AFFECTED_MODE_RINGER_STREAMS | string | 是 | 否 | 哪些音频流受振铃模式和请勿打扰 (DND) 模式更改的影响。希望特定的音频流受到振铃模式和 DDN 模式变化的影响,请将对应比特位设置为 1 。 | | AFFECTED_MODE_RINGER_STREAMS | string | 是 | 否 | 哪些音频流受振铃模式和请勿打扰 (DND) 模式更改的影响。希望特定的音频流受到振铃模式和 DDN 模式变化的影响,请将对应比特位设置为1。 |
| AFFECTED_MUTE_STREAMS | string | 是 | 否 | 受静音模式影响的音频流。希望特定音频流在静音模式下保持静音,请将相应位设置为 1。 | | AFFECTED_MUTE_STREAMS | string | 是 | 否 | 受静音模式影响的音频流。希望特定音频流在静音模式下保持静音,请将相应位设置为1。 |
| DEFAULT_NOTIFICATION_SOUND | string | 是 | 否 | 系统默认通知音的存储区域。 | | DEFAULT_NOTIFICATION_SOUND | string | 是 | 否 | 系统默认通知音的存储区域。 |
| DEFAULT_RINGTONE | string | 是 | 否 | 系统默认铃声的存储区域。 | | DEFAULT_RINGTONE | string | 是 | 否 | 系统默认铃声的存储区域。 |
| SOUND_EFFECTS_STATUS | string | 是 | 否 | 声音功能是否可用。<br>值为 0 表示不可用; <br/>值为 1 表示可用 | | SOUND_EFFECTS_STATUS | string | 是 | 否 | 声音功能是否可用。<br>值为0表示不可用; <br/>值为1表示可用 |
| VIBRATE_STATUS | string | 是 | 否 | 设备是否为事件振动。该参数在系统内部使用。 <br>值为 1 ,表示设备会因事件而振动; <br/>值为 0 ,表示设备不因事件振动。 | | VIBRATE_STATUS | string | 是 | 否 | 设备是否为事件振动。该参数在系统内部使用。 <br>值为1,表示设备会因事件而振动; <br/>值为0,表示设备不因事件振动。 |
| HAPTIC_FEEDBACK_STATUS | string | 是 | 否 | 设备是否启用触觉反馈。该参数为boolean类型。 | | HAPTIC_FEEDBACK_STATUS | string | 是 | 否 | 设备是否启用触觉反馈。该参数为boolean类型。 |
## TTS ## TTS
...@@ -155,7 +155,7 @@ import settings from '@ohos.settings'; ...@@ -155,7 +155,7 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| DEFAULT_TTS_PITCH | string | 是 | 否 | 文本转语音 (TTS) 引擎的默认音高。<br>其中100=1x,该值设置为 200 ,表示频率是正常声音频率的两倍。 | | DEFAULT_TTS_PITCH | string | 是 | 否 | 文本转语音 (TTS) 引擎的默认音高。<br>其中100=1x,该值设置为200,表示频率是正常声音频率的两倍。 |
| DEFAULT_TTS_RATE | string | 是 | 否 | TTS 引擎的默认语速。<br>其中100=1x。 | | DEFAULT_TTS_RATE | string | 是 | 否 | TTS 引擎的默认语速。<br>其中100=1x。 |
| DEFAULT_TTS_SYNTH | string | 是 | 否 | 默认TTS引擎。 | | DEFAULT_TTS_SYNTH | string | 是 | 否 | 默认TTS引擎。 |
| ENABLED_TTS_PLUGINS | string | 是 | 否 | 用于 TTS 的已激活插件包列表, 多个插件包以空格分隔。 | | ENABLED_TTS_PLUGINS | string | 是 | 否 | 用于 TTS 的已激活插件包列表, 多个插件包以空格分隔。 |
...@@ -171,19 +171,19 @@ import settings from '@ohos.settings'; ...@@ -171,19 +171,19 @@ import settings from '@ohos.settings';
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | | --------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ |
| BLUETOOTH_DISCOVER_ABILITY_STATUS | string | 是 | 否 | 设备是否可以被其他设备通过蓝牙发现或连接。<br>值为 0 表示设备不可以被连接或发现;<br/>值为 1 表示设备可以被连接但不可以被发现;<br/>值为 2 表示设备可以被连接和发现。 | | BLUETOOTH_DISCOVER_ABILITY_STATUS | string | 是 | 否 | 设备是否可以被其他设备通过蓝牙发现或连接。<br>值为0表示设备不可以被连接或发现;<br/>值为1表示设备可以被连接但不可以被发现;<br/>值为2表示设备可以被连接和发现。 |
| BLUETOOTH_DISCOVER_TIMEOUT | string | 是 | 否 | 可以通过蓝牙发现设备的持续时间(以秒为单位)。<br>这段时间之后,设备不可以被蓝牙搜寻到。 | | BLUETOOTH_DISCOVER_TIMEOUT | string | 是 | 否 | 可以通过蓝牙发现设备的持续时间(以秒为单位)。<br>这段时间之后,设备不可以被蓝牙搜寻到。 |
| AIRPLANE_MODE_RADIOS | string | 是 | 否 | 启用飞行模式时要禁用的无线电信号列表。 <br>多个无线电信号用逗号 (,) 分隔。取值包括以下常量:BLUETOOTH_RADIO、 CELL_RADIO、 NFC_RADIO、 WIFI_RADIO。 | | AIRPLANE_MODE_RADIOS | string | 是 | 否 | 启用飞行模式时要禁用的无线电信号列表。 <br>多个无线电信号用逗号 (,) 分隔。取值包括以下常量:BLUETOOTH_RADIO、 CELL_RADIO、 NFC_RADIO、 WIFI_RADIO。 |
| BLUETOOTH_RADIO | string | 是 | 否 | 常量,用来表示蓝牙在飞行模式下禁用。 | | BLUETOOTH_RADIO | string | 是 | 否 | 常量,用来表示蓝牙在飞行模式下禁用。 |
| CELL_RADIO | string | 是 | 否 | 常量,用来表示蜂窝无线电在飞行模式下禁用。 | | CELL_RADIO | string | 是 | 否 | 常量,用来表示蜂窝无线电在飞行模式下禁用。 |
| NFC_RADIO | string | 是 | 否 | 常量,用来表示NFC在飞行模式下禁用。 | | NFC_RADIO | string | 是 | 否 | 常量,用来表示NFC在飞行模式下禁用。 |
| WIFI_RADIO | string | 是 | 否 | 常量,用来表示Wi-Fi在飞行模式下禁用。 | | WIFI_RADIO | string | 是 | 否 | 常量,用来表示Wi-Fi在飞行模式下禁用。 |
| BLUETOOTH_STATUS | string | 是 | 否 | 蓝牙是否可用。 <br>值为 true 表示蓝牙可用;<br/>值为 false表示蓝牙不可用。 | | BLUETOOTH_STATUS | string | 是 | 否 | 蓝牙是否可用。 <br>值为true表示蓝牙可用;<br/>值为false表示蓝牙不可用。 |
| OWNER_LOCKDOWN_WIFI_CFG | string | 是 | 否 | 是否应锁定由设备所有者的应用程序创建的 Wi-Fi 配置。<br>值为 true 表示Wi-Fi配置应该被锁定;<br/>值为 false 表示不应该被锁定。 | | OWNER_LOCKDOWN_WIFI_CFG | string | 是 | 否 | 是否应锁定由设备所有者的应用程序创建的 Wi-Fi 配置。<br>值为true表示Wi-Fi配置应该被锁定;<br/>值为false表示不应该被锁定。 |
| WIFI_DHCP_MAX_RETRY_COUNT | string | 是 | 否 | 尝试从 DHCP 服务器获取 IP 地址的最大次数。 | | WIFI_DHCP_MAX_RETRY_COUNT | string | 是 | 否 | 尝试从 DHCP 服务器获取 IP 地址的最大次数。 |
| WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT | string | 是 | 否 | Wi-Fi连接断开后等待移动数据连接建立时保持唤醒锁的最长时间。 | | WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT | string | 是 | 否 | Wi-Fi连接断开后等待移动数据连接建立时保持唤醒锁的最长时间。 |
| WIFI_STATUS | string | 是 | 否 | Wi-Fi是否可用。<br>值为 true表示Wi-Fi可用;<br/>值为 false 表示Wi-Fi不可用。 | | WIFI_STATUS | string | 是 | 否 | Wi-Fi是否可用。<br>值为true表示Wi-Fi可用;<br/>值为false表示Wi-Fi不可用。 |
| WIFI_WATCHDOG_STATUS | string | 是 | 否 | Wi-Fi的WatchDog是否可用。 <br>值为 true表示可用;<br/>值为 false 表示不可用。 | | WIFI_WATCHDOG_STATUS | string | 是 | 否 | Wi-Fi的WatchDog是否可用。 <br>值为true表示可用;<br/>值为false表示不可用。 |
## setting.getURI ## setting.getURI
...@@ -203,10 +203,9 @@ getURI(name: string, callback: AsyncCallback\<object>): void ...@@ -203,10 +203,9 @@ getURI(name: string, callback: AsyncCallback\<object>): void
**示例** **示例**
```ts ```ts
// 获取数据项的URI settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS, (uri) => {
settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS, (urivar) => { console.log(`callback:uri -> ${JSON.stringify(uri)}`)
console.log(`$(urivar)`) })
})
``` ```
## setting.getURI ## setting.getURI
...@@ -232,10 +231,9 @@ getURI(name: string): Promise\<object> ...@@ -232,10 +231,9 @@ getURI(name: string): Promise\<object>
**示例** **示例**
```ts ```ts
// 获取数据项的URI settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS).then((uri) => {
settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS).then((urivar) => { console.log(`promise:uri -> ${JSON.stringify(uri)}`)
console.log(`$(urivar)`) })
})
``` ```
## setting.getValue ## setting.getValue
...@@ -257,13 +255,12 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall ...@@ -257,13 +255,12 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall
**示例** **示例**
```ts ```ts
// 获取数据项的URI
settings.getValue(dataAbilityHelper, name, (err, value) => { settings.getValue(dataAbilityHelper, name, (err, value) => {
if (err) { if (err) {
console.error(`Failed to get the setting. ${err.message} `); console.error(`Failed to get the setting. ${err.message} `);
return; return;
} }
console.log(`$(value)`) console.log(`callback:value -> ${JOSN.stringify(value)}`)
}); });
``` ```
...@@ -291,10 +288,13 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<object> ...@@ -291,10 +288,13 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\<object>
**示例** **示例**
```ts ```ts
// 获取数据项的URI settings.getValue(dataAbilityHelper, name).then((err, value) => {
settings.getUri(dataAbilityHelper, name).then((value) => { if (err) {
console.log(`$(value)`) console.error(`Failed to get the setting. ${err.message} `);
}) return;
}
console.log(`promise:value -> ${JOSN.stringify(value)}`)
});
``` ```
## settings.setValue ## settings.setValue
...@@ -310,21 +310,21 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, call ...@@ -310,21 +310,21 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, call
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | | ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
| dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 |
| name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br> - 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 | | name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br>- 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 |
| value | object | 是 | 数据项值。取值范围随业务变动。 | | value | object | 是 | 数据项值。取值范围随业务变动。 |
| callback | AsyncCallback\<boolean> | 是 | 回调函数。返回true表示操作成功,否则操作失败。 | | callback | AsyncCallback\<boolean> | 是 | 回调函数。返回true表示操作成功,否则操作失败。 |
**示例** **示例**
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
//更新数据项亮度的值(该数据项在数据库中已存在,故setValue方法将更新该数据项的值) //更新数据项亮度的值(该数据项在数据库中已存在,故setValue方法将更新该数据项的值)
let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
let helper = featureAbility.acquireDataAbilityHelper(uri); let helper = featureAbility.acquireDataAbilityHelper(uri);
settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => { settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100', (status) => {
console.log('Callback return whether value is set.'); console.log('Callback return whether value is set.');
}); });
``` ```
## settings.setValue ## settings.setValue
...@@ -340,7 +340,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Pro ...@@ -340,7 +340,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Pro
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ | | ----------------- | ------------------------------------------------- | ---- | ------------------------------------------------------------ |
| dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 | | dataAbilityHelper | [DataAbilityHelper](js-apis-dataAbilityHelper.md) | 是 | 数据管理辅助类。 |
| name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br> - 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 | | name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br>- 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 |
| value | object | 是 | 数据项值。取值范围随业务变动。 | | value | object | 是 | 数据项值。取值范围随业务变动。 |
**返回值** **返回值**
...@@ -352,14 +352,14 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Pro ...@@ -352,14 +352,14 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Pro
**示例** **示例**
```ts ```ts
import featureAbility from '@ohos.ability.featureAbility'; import featureAbility from '@ohos.ability.featureAbility';
//更新数据项亮度的值(该数据项在数据库中已存在,故setValue方法将更新该数据项的值) //更新数据项亮度的值(该数据项在数据库中已存在,故setValue方法将更新该数据项的值)
let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
let helper = featureAbility.acquireDataAbilityHelper(uri); let helper = featureAbility.acquireDataAbilityHelper(uri);
settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => { settings.setValue(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100').then((status) => {
console.log('Callback return whether value is set.'); console.log('Callback return whether value is set.');
}); });
``` ```
## settings.enableAirplaneMode ## settings.enableAirplaneMode
...@@ -380,14 +380,14 @@ enableAirplaneMode(enable: boolean, callback: AsyncCallback\<void>): void ...@@ -380,14 +380,14 @@ enableAirplaneMode(enable: boolean, callback: AsyncCallback\<void>): void
**示例** **示例**
```ts ```ts
isEnabled = true; isEnabled =true;
enableAirplaneMode(isEnabled, (err) => { enableAirplaneMode(isEnabled, (err) => {
if(err) { if(err) {
console.log('Failed to enable AirplaneMode.'); console.log('Failed to enable AirplaneMode.');
return; return;
} }
console.log('Return true if enable.'); console.log('Return true if enable.');
}) })
``` ```
## settings.enableAirplaneMode ## settings.enableAirplaneMode
...@@ -413,14 +413,14 @@ enableAirplaneMode(enable: boolean): Promise<void> ...@@ -413,14 +413,14 @@ enableAirplaneMode(enable: boolean): Promise<void>
**示例** **示例**
```ts ```ts
isEnabled = true; isEnabled =true;
enableAirplaneMode(isEnabled).then((err) => { enableAirplaneMode(isEnabled).then((err) => {
if(err) { if(err) {
console.log('Failed to enable AirplaneMode.'); console.log('Failed to enable AirplaneMode.');
return; return;
} }
console.log('Return true if enable.'); console.log('Return true if enable.');
}); });
``` ```
## settings.canShowFloating ## settings.canShowFloating
...@@ -440,9 +440,9 @@ canShowFloating(callback: AsyncCallback\<boolean>): void ...@@ -440,9 +440,9 @@ canShowFloating(callback: AsyncCallback\<boolean>): void
**示例** **示例**
```ts ```ts
canShowFloating((status) => { canShowFloating((status) => {
console.log('Checks whether a specified application can show as float window.'); console.log('Checks whether a specified application can show as float window.');
}); });
``` ```
## settings.canShowFloating ## settings.canShowFloating
...@@ -462,9 +462,9 @@ canShowFloating(): Promise\<boolean> ...@@ -462,9 +462,9 @@ canShowFloating(): Promise\<boolean>
**示例** **示例**
```ts ```ts
canShowFloating().then((status) => { canShowFloating().then((status) => {
console.log('Checks whether a specified application can show as float window.'); console.log('Checks whether a specified application can show as float window.');
}); });
``` ```
## settings.getUriSync<sup>8+</sup> ## settings.getUriSync<sup>8+</sup>
...@@ -479,7 +479,7 @@ getUriSync(name: string): string ...@@ -479,7 +479,7 @@ getUriSync(name: string): string
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------------------------ | | ------ | ------ | ---- | ------------------------------------------------------------ |
| name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br> - 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 | | name | string | 是 | 数据项的名称。数据项名称分为以下两种:<br>- 上述任意一个数据库中已存在的数据项。<br>- 开发者自行添加的数据项。 |
**返回值** **返回值**
...@@ -562,11 +562,3 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): ...@@ -562,11 +562,3 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string):
let helper = featureAbility.acquireDataAbilityHelper(uri); let helper = featureAbility.acquireDataAbilityHelper(uri);
let ret = settings.setValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100'); let ret = settings.setValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100');
``` ```
```ts
import featureAbility from '@ohos.ability.featureAbility';
//更新数据项亮度的值(该数据项在数据库中已存在,故setValueSync方法将更新该数据项的值)
let uri = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS);
let helper = featureAbility.acquireDataAbilityHelper(uri);
let ret = settings.setValueSync(helper, settings.display.SCREEN_BRIGHTNESS_STATUS, '100');
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册