diff --git a/zh-cn/application-dev/reference/apis/js-apis-settings.md b/zh-cn/application-dev/reference/apis/js-apis-settings.md index 9a57c71ef47ac520cc5d4b6a33b4895c37754b72..e478f099df8b8b03dd68b08d69aed6fc4fc931ee 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis/js-apis-settings.md @@ -14,176 +14,176 @@ import settings from '@ohos.settings'; ## date -提供用于设置时间和日期格式的数据项。 +提供设置时间和日期格式的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| DATE_FORMAT | string | 是 | 否 | 日期格式。
日期格式包括mm/dd/yyyy、dd/mm/yyyy和yyyy/mm/dd ，其中mm、dd和yyyy分别代表月份、日期和年份。 | -| TIME_FORMAT | string | 是 | 否 | 时间是以12小时格式还是24小时格式显示。
值为 “12” 表示12小时格式；
值为 ”24“ 表示24小时格式。 | -| AUTO_GAIN_TIME | string | 是 | 否 | 是否自动从网络获取日期、时间和时区。
值为true表示自动从网络获取信息；
值为false表示不自动获取。 | -| AUTO_GAIN_TIME_ZONE | string | 是 | 否 | 是否自动从 NITZ 获取时区。
值为true表示自动获取；
值为false表示不自动获取。 | +| DATE_FORMAT | string | 是 | 是 | 日期格式。
日期格式包括mm/dd/yyyy、dd/mm/yyyy和yyyy/mm/dd ，其中mm、dd和yyyy分别代表月份、日期和年份。 | +| TIME_FORMAT | string | 是 | 是 | 时间是以12小时格式还是24小时格式显示。
值为 “12” 表示12小时格式；
值为 ”24“ 表示24小时格式。 | +| AUTO_GAIN_TIME | string | 是 | 是 | 是否自动从网络获取日期、时间和时区。
值为true表示自动从网络获取信息；
值为false表示不自动获取。 | +| AUTO_GAIN_TIME_ZONE | string | 是 | 是 | 是否自动从NITZ获取时区。
值为true表示自动获取；
值为false表示不自动获取。 | ## display 提供设置显示效果的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| FONT_SCALE | string | 是 | 否 | 字体的比例因子，值为浮点数。 | -| SCREEN_BRIGHTNESS_STATUS | string | 是 | 否 | 屏幕亮度。该值的范围从0到255。 | -| AUTO_SCREEN_BRIGHTNESS | string | 是 | 否 | 是否启用屏幕亮度自动调整。
值为1，表示启用自动调整；
值为0，表示不启用自动调整。 | -| AUTO_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度自动调整时 AUTO_SCREEN_BRIGHTNESS 的值。 | -| MANUAL_SCREEN_BRIGHTNESS_MODE | number | 是 | 否 | 使用屏幕亮度手动调整时的 AUTO_SCREEN_BRIGHTNESS 值。 | -| SCREEN_OFF_TIMEOUT | string | 是 | 否 | 设备在一段时间不活动后进入睡眠状态的等待时间（单位：ms）。 | -| DEFAULT_SCREEN_ROTATION | string | 是 | 否 | 启用自动旋转时，此常量无效；不启用自动旋转时，以下值可用：
值为0，表示屏幕旋转0度；
值为1，表示屏幕旋转90度；
值为2，表示屏幕旋转180度；
值为3，表示屏幕旋转270度。 | -| ANIMATOR_DURATION_SCALE | string | 是 | 否 | 动画持续时间的比例因子。这会影响所有此类动画的开始延迟和持续时间。
值为0，表示动画将立即结束，默认值为1。 | -| TRANSITION_ANIMATION_SCALE | string | 是 | 否 | 过渡动画的比例因子。
值为0，表示禁用过渡动画。 | -| WINDOW_ANIMATION_SCALE | string | 是 | 否 | 普通窗口动画的比例因子。
值为0，表示禁用窗口动画。 | -| DISPLAY_INVERSION_STATUS | string | 是 | 否 | 是否启用显示颜色反转。
值为1，表示启用显示颜色反转；
值为0，表示不启用显示颜色反转。 | +| FONT_SCALE | string | 是 | 是 | 字体的比例因子，值为浮点数。 | +| SCREEN_BRIGHTNESS_STATUS | string | 是 | 是 | 屏幕亮度。该值的范围从0到255。 | +| AUTO_SCREEN_BRIGHTNESS | string | 是 | 是 | 是否启用屏幕亮度自动调整。
值为1，表示启用自动调整；
值为0，表示不启用自动调整。 | +| AUTO_SCREEN_BRIGHTNESS_MODE | number | 是 | 是 | 使用屏幕亮度自动调整时AUTO_SCREEN_BRIGHTNESS的值。 | +| MANUAL_SCREEN_BRIGHTNESS_MODE | number | 是 | 是 | 使用屏幕亮度手动调整时的AUTO_SCREEN_BRIGHTNESS值。 | +| SCREEN_OFF_TIMEOUT | string | 是 | 是 | 设备在一段时间不活动后进入睡眠状态的等待时间（单位：ms）。 | +| DEFAULT_SCREEN_ROTATION | string | 是 | 是 | 启用屏幕的自动旋转时，此属性无效；不启用自动旋转时，以下值可用：
值为0，表示屏幕旋转0度；
值为1，表示屏幕旋转90度；
值为2，表示屏幕旋转180度；
值为3，表示屏幕旋转270度。 | +| ANIMATOR_DURATION_SCALE | string | 是 | 是 | 动画持续时间的比例因子。这会影响所有此类动画的开始延迟和持续时间。
值为0，表示动画将立即结束，默认值为1。 | +| TRANSITION_ANIMATION_SCALE | string | 是 | 是 | 过渡动画的比例因子。
值为0，表示禁用过渡动画。 | +| WINDOW_ANIMATION_SCALE | string | 是 | 是 | 普通窗口动画的比例因子。
值为0，表示禁用窗口动画。 | +| DISPLAY_INVERSION_STATUS | string | 是 | 是 | 是否启用显示颜色反转。
值为1，表示启用显示颜色反转；
值为0，表示不启用显示颜色反转。 | ## general -提供用于设置设备常规信息的数据项。 +提供设置设备常规信息的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | -------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| SETUP_WIZARD_FINISHED | string | 是 | 否 | 是否已运行启动向导。
值为0，表示启动向导尚未运行；
值不是0，表示启动向导已运行。 | -| END_BUTTON_ACTION | string | 是 | 否 | 在用户不在呼叫中时用户按下呼叫结束按钮后发生的情况。
值为0，表示没有任何反应；
值为1，表示显示主屏幕；
值为2，表示设备进入睡眠状态，屏幕锁定；
值为3，表示显示主屏幕。用户已在主屏幕上，表示设备将进入睡眠状态。 | -| ACCELEROMETER_ROTATION_STATUS | string | 是 | 否 | 是否使用加速计更改屏幕方向，即是否启用自动旋转。
值1表示默认情况下启用加速度计；
值为0表示默认情况下不启用加速计。 | -| AIRPLANE_MODE_STATUS | string | 是 | 否 | 是否启用飞行模式。
值为1，表示启用飞行模式；
值为0，表示不启用飞行模式。 | -| DEVICE_PROVISION_STATUS | string | 是 | 否 | 是否预配设备。
在具有单个系统用户的多用户设备上，当值为true时，屏幕可能会被锁定。此外，其他功能无法在系统用户上启动，除非它们被标记为在屏幕锁定上显示。 | -| HDC_STATUS | string | 是 | 否 | 是否启用 USB 设备上的硬盘控制器 （HDC）。
值为true，表示启用 HDC；
值为false，表示不启用 HDC。 | -| BOOT_COUNTING | string | 是 | 否 | 设备开机后的启动操作数。 | -| CONTACT_METADATA_SYNC_STATUS | string | 是 | 否 | 是否启用联系人元数据同步。
值为true，表示启用同步；
值为false，表示不启用同步。 | -| DEVELOPMENT_SETTINGS_STATUS | string | 是 | 否 | 是否启用开发人员选项。
值为true，表示启用开发人员选项；
值为false，表示不启用开发人员选项。 | -| DEVICE_NAME | string | 是 | 否 | 设备名称。 | -| USB_STORAGE_STATUS | string | 是 | 否 | 是否启用 USB 大容量存储。
值为true，表示启用 USB 大容量存储；
值为false，表示不启用 USB 大容量存储。 | -| DEBUGGER_WAITING | string | 是 | 否 | 设备在启动应用程序进行调试时是否等待调试器进行调试。
值为1，表示设备等待调试器；
值为0，表示系统不会等待调试器，因此应用程序会正常运行。 | -| DEBUG_APP_PACKAGE | string | 是 | 否 | 要调试的应用程序的捆绑包名称。 | -| ACCESSIBILITY_STATUS | string | 是 | 否 | 是否启用任何辅助功能。
值为1，表示启用辅助功能；
值为0，表示不启用辅助功能。 | -| ACTIVATED_ACCESSIBILITY_SERVICES | string | 是 | 否 | 已激活的辅助功能的列表。 | -| GEOLOCATION_ORIGINS_ALLOWED | string | 是 | 否 | 浏览器可以使用的默认地理位置。多个地理位置由空格分隔。 | -| SKIP_USE_HINTS | string | 是 | 否 | 应用程序是否应在首次启动时尝试跳过所有介绍性提示。这适用于临时用户或熟悉环境的用户。
值为1，表示应用程序将尝试在第一次启动时跳过所有介绍性提示；
值为0，表示应用程序不会在首次启动时跳过介绍性提示。 | -| TOUCH_EXPLORATION_STATUS | string | 是 | 否 | 是否启用触摸浏览。
值为1，表示启用触摸浏览；
值为0，表示不启用触摸浏览。 | +| SETUP_WIZARD_FINISHED | string | 是 | 是 | 是否已运行启动向导。
值为0，表示启动向导尚未运行；
值不是0，表示启动向导已运行。 | +| END_BUTTON_ACTION | string | 是 | 是 | 在用户不在呼叫中时，用户按下呼叫结束按钮会发生的情况。
值为0，表示没有任何反应；
值为1，表示显示主屏幕；
值为2，表示设备进入睡眠状态，屏幕锁定；
值为3，表示显示主屏幕。如果用户已在主屏幕上，设备将进入睡眠状态。 | +| ACCELEROMETER_ROTATION_STATUS | string | 是 | 是 | 是否使用加速计更改屏幕方向，即是否启用自动旋转。
值为1，表示启用加速度计；
值为0，表示不启用加速计。 | +| AIRPLANE_MODE_STATUS | string | 是 | 是 | 是否启用飞行模式。
值为1，表示启用飞行模式；
值为0，表示不启用飞行模式。 | +| DEVICE_PROVISION_STATUS | string | 是 | 是 | 是否预配设备。
在具有单个系统用户的多用户设备上，当值为true时，屏幕可能会被锁定。此外，其他功能无法在系统用户上启动，除非它们被标记为在屏幕锁定上显示。 | +| HDC_STATUS | string | 是 | 是 | 是否启用USB设备上的硬盘控制器（HDC）。
值为true，表示启用HDC；
值为false，表示不启用HDC。 | +| BOOT_COUNTING | string | 是 | 是 | 设备开机后的启动操作数。 | +| CONTACT_METADATA_SYNC_STATUS | string | 是 | 是 | 是否启用联系人元数据同步。
值为true，表示启用同步；
值为false，表示不启用同步。 | +| DEVELOPMENT_SETTINGS_STATUS | string | 是 | 是 | 是否启用开发人员选项。
值为true，表示启用开发人员选项；
值为false，表示不启用开发人员选项。 | +| DEVICE_NAME | string | 是 | 是 | 设备名称。 | +| USB_STORAGE_STATUS | string | 是 | 是 | 是否启用USB大容量存储。
值为true，表示启用USB大容量存储；
值为false，表示不启用USB大容量存储。 | +| DEBUGGER_WAITING | string | 是 | 是 | 设备在启动应用程序进行调试时是否等待调试器进行调试。
值为1，表示设备等待调试器；
值为0，表示系统不会等待调试器，因此应用程序会正常运行。 | +| DEBUG_APP_PACKAGE | string | 是 | 是 | 要调试的应用程序的捆绑包名称。 | +| ACCESSIBILITY_STATUS | string | 是 | 是 | 是否启用辅助功能。
值为1，表示启用辅助功能；
值为0，表示不启用辅助功能。 | +| ACTIVATED_ACCESSIBILITY_SERVICES | string | 是 | 是 | 已激活的辅助功能的列表。 | +| GEOLOCATION_ORIGINS_ALLOWED | string | 是 | 是 | 浏览器可以使用的默认地理位置。多个地理位置由空格分隔。 | +| SKIP_USE_HINTS | string | 是 | 是 | 应用程序是否应在首次启动时尝试跳过所有介绍性提示。这适用于临时用户或熟悉环境的用户。
值为1，表示应用程序将尝试在第一次启动时跳过所有介绍性提示；
值为0，表示应用程序不会在首次启动时跳过介绍性提示。 | +| TOUCH_EXPLORATION_STATUS | string | 是 | 是 | 是否启用触摸浏览。
值为1，表示启用触摸浏览；
值为0，表示不启用触摸浏览。 | ## input -提供用于设置有关输入法的信息的数据项。 +提供设置有关输入法信息的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | -| DEFAULT_INPUT_METHOD | string | 是 | 否 | 默认输入法及其 ID。 | -| ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 否 | 默认输入法键盘类型及其 ID。 | -| ACTIVATED_INPUT_METHODS | string | 是 | 否 | 已激活的输入法的列表。
该列表是一个字符串，其中包含已激活输入法的 ID。ID 由冒号':'分隔，输入法的键盘类型由分号';'分隔。示例格式是 ima0: keyboardType0; keyboardType1; ima1: ima2: keyboardTypes0。imaID 的类型是 ElementName，keyboard的类型是 int。 | -| SELECTOR_VISIBILITY_FOR_INPUT_METHOD | string | 是 | 否 | 输入法选择器是否可见。
值为1，表示输入法选择器可见；
值为0，表示输入法选择器不可见。 | -| AUTO_CAPS_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动大写。
值为0，表示不启用自动大写；
值为1，表示启用自动大写。 | -| AUTO_PUNCTUATE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动标点符号。自动标点符号使文本编辑器能够将两个空格转换为句点'.'和空格。
值为0，表示不启用自动标点符号；
值为1，表示启用自动标点符号。 | -| AUTO_REPLACE_TEXT_INPUT | string | 是 | 否 | 是否为文本编辑器启用自动更正。自动更正使文本编辑器能够更正拼写错误。
值为0，表示不启用自动更正；
值为1，表示启用自动更正。 | -| SHOW_PASSWORD_TEXT_INPUT | string | 是 | 否 | 是否在文本编辑器中启用密码显示。密码显示使文本编辑器能够在用户键入密码字符时显示密码字符。
值为0，表示不启用密码显示；
值为1，表示启用密码显示。 | +| DEFAULT_INPUT_METHOD | string | 是 | 是 | 默认输入法及其ID。 | +| ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 是 | 默认输入法键盘类型及其ID。 | +| ACTIVATED_INPUT_METHODS | string | 是 | 是 | 已激活的输入法的列表。
该列表是一个字符串，其中包含已激活输入法的ID。ID由冒号':'分隔，输入法的键盘类型由分号';'分隔。示例格式是 ima0: keyboardType0; keyboardType1; ima1: ima2: keyboardTypes0。imaID 的类型是 ElementName，keyboard的类型是 int。 | +| SELECTOR_VISIBILITY_FOR_INPUT_METHOD | string | 是 | 是 | 输入法选择器是否可见。
值为1，表示输入法选择器可见；
值为0，表示输入法选择器不可见。 | +| AUTO_CAPS_TEXT_INPUT | string | 是 | 是 | 是否为文本编辑器启用自动大写。
值为0，表示不启用自动大写；
值为1，表示启用自动大写。 | +| AUTO_PUNCTUATE_TEXT_INPUT | string | 是 | 是 | 是否为文本编辑器启用自动标点符号。自动标点符号使文本编辑器能够将两个空格转换为句点'.'和空格。
值为0，表示不启用自动标点符号；
值为1，表示启用自动标点符号。 | +| AUTO_REPLACE_TEXT_INPUT | string | 是 | 是 | 是否为文本编辑器启用自动更正。自动更正使文本编辑器能够更正拼写错误。
值为0，表示不启用自动更正；
值为1，表示启用自动更正。 | +| SHOW_PASSWORD_TEXT_INPUT | string | 是 | 是 | 是否在文本编辑器中启用密码显示。密码显示使文本编辑器能够在用户键入密码字符时显示密码字符。
值为0，表示不启用密码显示；
值为1，表示启用密码显示。 | ## network -提供用于设置网络信息的数据项。 +提供设置网络信息的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | -| DATA_ROAMING_STATUS | string | 是 | 否 | 是否启用数据漫游。
值为true，表示启用数据漫游；
值为false，表示不启用数据漫游。 | -| HTTP_PROXY_CFG | string | 是 | 否 | 全局 HTTP 代理的主机名和端口号。主机名和端口号由冒号':'分隔。 | -| NETWORK_PREFERENCE_USAGE | string | 是 | 否 | 要使用的网络的用户首选项。 | +| DATA_ROAMING_STATUS | string | 是 | 是 | 是否启用数据漫游。
值为true，表示启用数据漫游；
值为false，表示不启用数据漫游。 | +| HTTP_PROXY_CFG | string | 是 | 是 | 全局 HTTP 代理的主机名和端口号。主机名和端口号由冒号':'分隔。 | +| NETWORK_PREFERENCE_USAGE | string | 是 | 是 | 要使用的网络的用户首选项。 | ## phone 提供设置来电和去电接听方式的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------ | ------ | ---- | ---- | ------------------------------------------------------------ | -| RTT_CALLING_STATUS | string | 是 | 否 | 是否启用实时文本 (RTT) 呼叫。启用，来电和去电在设备和运营商支持时作为 RTT 呼叫应答。
值为1，表示启用RTT 呼叫；
值为0，表示不启用 RTT 呼叫。 | +| RTT_CALLING_STATUS | string | 是 | 是 | 是否启用实时文本 (RTT) 呼叫。启用，来电和去电在设备和运营商支持时作为 RTT 呼叫应答。
值为1，表示启用RTT 呼叫；
值为0，表示不启用 RTT 呼叫。 | ## sound 提供设置声音效果的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ---------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| VIBRATE_WHILE_RINGING | string | 是 | 否 | 设备在来电响铃时是否振动。此常量将由电话和设置应用程序使用。 该值是布尔类型，仅影响设备因来电而响铃的情况，不影响任何其他应用程序或场景。 | -| DEFAULT_ALARM_ALERT | string | 是 | 否 | 系统默认告警的存储区域。 | -| DTMF_TONE_TYPE_WHILE_DIALING | string | 是 | 否 | 拨号时播放的双音多频 (DTMF) 音的类型。
值为0表示常规的短音效，
值为1表示长音效。 | -| DTMF_TONE_WHILE_DIALING | string | 是 | 否 | 拨号时是否播放 DTMF 音。
值为1，表示播放 DTMF 音；
值为0，表示不播放。 | -| AFFECTED_MODE_RINGER_STREAMS | string | 是 | 否 | 哪些音频流受振铃模式和请勿打扰 (DND) 模式更改的影响。希望特定的音频流受到振铃模式和 DDN 模式变化的影响，请将对应比特位设置为1。 | -| AFFECTED_MUTE_STREAMS | string | 是 | 否 | 受静音模式影响的音频流。希望特定音频流在静音模式下保持静音，请将相应位设置为1。 | -| DEFAULT_NOTIFICATION_SOUND | string | 是 | 否 | 系统默认通知音的存储区域。 | -| DEFAULT_RINGTONE | string | 是 | 否 | 系统默认铃声的存储区域。 | -| SOUND_EFFECTS_STATUS | string | 是 | 否 | 声音功能是否可用。
值为0表示不可用；
值为1表示可用 | -| VIBRATE_STATUS | string | 是 | 否 | 设备是否为事件振动。该参数在系统内部使用。
值为1，表示设备会因事件而振动；
值为0，表示设备不因事件振动。 | -| HAPTIC_FEEDBACK_STATUS | string | 是 | 否 | 设备是否启用触觉反馈。该参数为boolean类型。 | +| VIBRATE_WHILE_RINGING | string | 是 | 是 | 设备在来电响铃时是否振动。此属性将由电话和设置应用程序使用。 该值是布尔类型，仅影响设备因来电而响铃的情况，不影响任何其他应用程序或场景。 | +| DEFAULT_ALARM_ALERT | string | 是 | 是 | 系统默认告警的存储区域。 | +| DTMF_TONE_TYPE_WHILE_DIALING | string | 是 | 是 | 拨号时播放的双音多频 (DTMF) 音的类型。
值为0表示常规的短音效，
值为1表示长音效。 | +| DTMF_TONE_WHILE_DIALING | string | 是 | 是 | 拨号时是否播放 DTMF 音。
值为1，表示播放 DTMF 音；
值为0，表示不播放。 | +| AFFECTED_MODE_RINGER_STREAMS | string | 是 | 是 | 哪些音频流受振铃模式和请勿打扰 (DND) 模式更改的影响。希望特定的音频流受到振铃模式和 DDN 模式变化的影响，请将对应比特位设置为1。 | +| AFFECTED_MUTE_STREAMS | string | 是 | 是 | 受静音模式影响的音频流。希望特定音频流在静音模式下保持静音，请将相应位设置为1。 | +| DEFAULT_NOTIFICATION_SOUND | string | 是 | 是 | 系统默认通知音的存储区域。 | +| DEFAULT_RINGTONE | string | 是 | 是 | 系统默认铃声的存储区域。 | +| SOUND_EFFECTS_STATUS | string | 是 | 是 | 声音功能是否可用。
值为0表示不可用；
值为1表示可用 | +| VIBRATE_STATUS | string | 是 | 是 | 设备是否为事件振动。该参数在系统内部使用。
值为1，表示设备会因事件而振动；
值为0，表示设备不因事件振动。 | +| HAPTIC_FEEDBACK_STATUS | string | 是 | 是 | 设备是否启用触觉反馈。该参数为boolean类型。 | ## TTS 提供设置文本到语音 (TTS) 转换信息的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| DEFAULT_TTS_PITCH | string | 是 | 否 | 文本转语音 (TTS) 引擎的默认音高。
其中100=1x，该值设置为200，表示频率是正常声音频率的两倍。 | -| DEFAULT_TTS_RATE | string | 是 | 否 | TTS 引擎的默认语速。
其中100=1x。 | -| DEFAULT_TTS_SYNTH | string | 是 | 否 | 默认TTS引擎。 | -| ENABLED_TTS_PLUGINS | string | 是 | 否 | 用于 TTS 的已激活插件包列表， 多个插件包以空格分隔。 | +| DEFAULT_TTS_PITCH | string | 是 | 是 | 文本转语音 (TTS) 引擎的默认音高。
其中100=1x，该值设置为200，表示频率是正常声音频率的两倍。 | +| DEFAULT_TTS_RATE | string | 是 | 是 | TTS 引擎的默认语速。
其中100=1x。 | +| DEFAULT_TTS_SYNTH | string | 是 | 是 | 默认TTS引擎。 | +| ENABLED_TTS_PLUGINS | string | 是 | 是 | 用于TTS的已激活插件包列表， 多个插件包以空格分隔。 | ## wireless -提供无线网络信息设置数据项。 +提供设置无线网络信息的数据项。 -### 常量 +### 属性 **系统能力：** SystemCapability.Applications.settings.Core | 名称 | 类型 | 可读 | 可写 | 说明 | | --------------------------------- | ------ | ---- | ---- | ------------------------------------------------------------ | -| BLUETOOTH_DISCOVER_ABILITY_STATUS | string | 是 | 否 | 设备是否可以被其他设备通过蓝牙发现或连接。
值为0表示设备不可以被连接或发现；
值为1表示设备可以被连接但不可以被发现；
值为2表示设备可以被连接和发现。 | -| BLUETOOTH_DISCOVER_TIMEOUT | string | 是 | 否 | 可以通过蓝牙发现设备的持续时间（以秒为单位）。
这段时间之后，设备不可以被蓝牙搜寻到。 | -| AIRPLANE_MODE_RADIOS | string | 是 | 否 | 启用飞行模式时要禁用的无线电信号列表。
多个无线电信号用逗号 (,) 分隔。取值包括以下常量：BLUETOOTH_RADIO、 CELL_RADIO、 NFC_RADIO、 WIFI_RADIO。 | -| BLUETOOTH_RADIO | string | 是 | 否 | 常量，用来表示蓝牙在飞行模式下禁用。 | -| CELL_RADIO | string | 是 | 否 | 常量，用来表示蜂窝无线电在飞行模式下禁用。 | -| NFC_RADIO | string | 是 | 否 | 常量，用来表示NFC在飞行模式下禁用。 | -| WIFI_RADIO | string | 是 | 否 | 常量，用来表示Wi-Fi在飞行模式下禁用。 | -| BLUETOOTH_STATUS | string | 是 | 否 | 蓝牙是否可用。
值为true表示蓝牙可用；
值为false表示蓝牙不可用。 | -| OWNER_LOCKDOWN_WIFI_CFG | string | 是 | 否 | 是否应锁定由设备所有者的应用程序创建的 Wi-Fi 配置。
值为true表示Wi-Fi配置应该被锁定；
值为false表示不应该被锁定。 | -| WIFI_DHCP_MAX_RETRY_COUNT | string | 是 | 否 | 尝试从 DHCP 服务器获取 IP 地址的最大次数。 | -| WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT | string | 是 | 否 | Wi-Fi连接断开后等待移动数据连接建立时保持唤醒锁的最长时间。 | -| WIFI_STATUS | string | 是 | 否 | Wi-Fi是否可用。
值为true表示Wi-Fi可用；
值为false表示Wi-Fi不可用。 | -| WIFI_WATCHDOG_STATUS | string | 是 | 否 | Wi-Fi的WatchDog是否可用。
值为true表示可用；
值为false表示不可用。 | +| BLUETOOTH_DISCOVER_ABILITY_STATUS | string | 是 | 是 | 设备是否可以被其他设备通过蓝牙发现或连接。
值为0表示设备不可以被连接或发现；
值为1表示设备可以被连接但不可以被发现；
值为2表示设备可以被连接和发现。 | +| BLUETOOTH_DISCOVER_TIMEOUT | string | 是 | 是 | 可以通过蓝牙发现设备的持续时间（以秒为单位）。
这段时间之后，设备不可以被蓝牙搜寻到。 | +| AIRPLANE_MODE_RADIOS | string | 是 | 是 | 启用飞行模式时要禁用的无线电信号列表。
多个无线电信号用逗号 (,) 分隔。取值包括以下常量：BLUETOOTH_RADIO、 CELL_RADIO、 NFC_RADIO、 WIFI_RADIO。 | +| BLUETOOTH_RADIO | string | 是 | 是 | 常量，用来表示蓝牙在飞行模式下禁用。 | +| CELL_RADIO | string | 是 | 是 | 常量，用来表示蜂窝无线电在飞行模式下禁用。 | +| NFC_RADIO | string | 是 | 是 | 常量，用来表示NFC在飞行模式下禁用。 | +| WIFI_RADIO | string | 是 | 是 | 常量，用来表示Wi-Fi在飞行模式下禁用。 | +| BLUETOOTH_STATUS | string | 是 | 是 | 蓝牙是否可用。
值为true表示蓝牙可用；
值为false表示蓝牙不可用。 | +| OWNER_LOCKDOWN_WIFI_CFG | string | 是 | 是 | 是否应锁定由设备所有者的应用程序创建的Wi-Fi配置。
值为true表示Wi-Fi配置应该被锁定；
值为false表示不应该被锁定。 | +| WIFI_DHCP_MAX_RETRY_COUNT | string | 是 | 是 | 尝试从DHCP服务器获取 IP 地址的最大次数。 | +| WIFI_TO_MOBILE_DATA_AWAKE_TIMEOUT | string | 是 | 是 | Wi-Fi连接断开后等待移动数据连接建立时保持唤醒锁的最长时间。 | +| WIFI_STATUS | string | 是 | 是 | Wi-Fi是否可用。
值为true表示Wi-Fi可用；
值为false表示Wi-Fi不可用。 | +| WIFI_WATCHDOG_STATUS | string | 是 | 是 | Wi-Fi的WatchDog是否可用。
值为true表示可用；
值为false表示不可用。 | ## setting.getURI @@ -195,14 +195,14 @@ getURI(name: string, callback: AsyncCallback\): void **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------- | ---- | ------------------------------------------------------------ | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | -| callback | AsyncCallback\ | 是 | 回调函数。返回true表示操作成功，否则操作失败。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------- | ---- | ------------------------------------------------------------ | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | +| callback | AsyncCallback\ | 是 | 回调函数。获取数据项的URI。 | **示例**： -```ts +```js settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS, (uri) => { console.log(`callback:uri -> ${JSON.stringify(uri)}`) }) @@ -220,17 +220,17 @@ getURI(name: string): Promise\ | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | +| name | string | 是 | 数据项的名称。数据项名称分为以下两种：
- 上述任意一个数据库中已存在的数据项。
- 开发者自行添加的数据项。 | **返回值**： -| 类型 | 说明 | -| ---------------- | ---------------------------- | -| Promise\ | 使用promise获取数据项的URI。 | +| 类型 | 说明 | +| ---------------- | ------------------------------------ | +| Promise\ | Promise对象。返回获取的数据项的URI。 | **示例**： -```ts +```js settings.getUri(settings.display.SCREEN_BRIGHTNESS_STATUS).then((uri) => { console.log(`promise:uri -> ${JSON.stringify(uri)}`) }) @@ -240,7 +240,7 @@ getURI(name: string): Promise\ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCallback\): void -获取数据库中指定字符串的值。使用callback异步回调。 +获取数据库中指定数据项的值。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -254,7 +254,7 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall **示例**： -```ts +```js settings.getValue(dataAbilityHelper, name, (err, value) => { if (err) { console.error(`Failed to get the setting. ${err.message} `); @@ -268,7 +268,7 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string, callback: AsyncCall getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ -获取数据库中字符串的值，使用Promise异步回调。 +获取数据库中指定数据项的值。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -283,16 +283,12 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ | 类型 | 说明 | | ---------------- | ----------------------------------- | -| Promise\ | 使用promise获取数据库中字符串的值。 | +| Promise\ | Promise对象。返回获得的数据项的值。 | **示例**： -```ts - settings.getValue(dataAbilityHelper, name).then((err, value) => { - if (err) { - console.error(`Failed to get the setting. ${err.message} `); - return; - } +```js + settings.getValue(dataAbilityHelper, name).then((value) => { console.log(`promise:value -> ${JOSN.stringify(value)}`) }); ``` @@ -301,7 +297,7 @@ getValue(dataAbilityHelper: DataAbilityHelper, name: string): Promise\ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, callback: AsyncCallback\): void -将字符串名称及其值保存到数据库中。使用callback异步回调。 +将数据项名称及数据项的值保存到数据库中。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -316,7 +312,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, call **示例**： -```ts +```js import featureAbility from '@ohos.ability.featureAbility'; //更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） @@ -331,7 +327,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object, call setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Promise\ -将字符串名称及其值保存到数据库中。使用Promise异步回调。 +将数据项名称及数据项的值保存到数据库中。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -351,7 +347,7 @@ setValue(dataAbilityHelper: DataAbilityHelper, name: string, value: object): Pro **示例**： -```ts +```js import featureAbility from '@ohos.ability.featureAbility'; //更新数据项亮度的值（该数据项在数据库中已存在，故setValue方法将更新该数据项的值） @@ -372,14 +368,14 @@ enableAirplaneMode(enable: boolean, callback: AsyncCallback\): void **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| -------- | -------------------- | ---- | ------------------------------------------------------------ | -| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | -| callback | AsyncCallback\ | 是 | 回调函数。当具体的操作（视具体接口功能描述）成功，err为undefined，否则为错误对象。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------- | ---- | ----------------------------------------------- | +| enable | boolean | 是 | 是否开启飞行模式。true表示开启，false表示禁用。 | +| callback | AsyncCallback\ | 是 | 回调函数。 | **示例**： -```ts +```js isEnabled =true; enableAirplaneMode(isEnabled, (err) => { if(err) { @@ -406,13 +402,13 @@ enableAirplaneMode(enable: boolean): Promise **返回值**： -| 类型 | 说明 | -| -------------- | -------------------------------------- | -| Promise\ | Promise对象。无返回结果的Promise对象。 | +| 类型 | 说明 | +| -------------- | ------------------------- | +| Promise\ | 无返回结果的Promise对象。 | **示例**： -```ts +```js isEnabled =true; enableAirplaneMode(isEnabled).then((err) => { if(err) { @@ -427,7 +423,7 @@ enableAirplaneMode(enable: boolean): Promise canShowFloating(callback: AsyncCallback\): void -检查应用能够作为悬浮窗显示。使用callback异步回调。 +检查应用是否能够以悬浮窗形式显示。使用callback异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -435,11 +431,11 @@ canShowFloating(callback: AsyncCallback\): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ----------------------- | ---- | ------------------------------------------------------------ | -| callback | AsyncCallback\ | 是 | 回调函数。当具体的操作（视具体接口功能描述）成功，err为undefined，data为获取到的boolean值；否则为错误对象。 | +| callback | AsyncCallback\ | 是 | 回调函数。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | **示例**： -```ts +```js canShowFloating((status) => { console.log('Checks whether a specified application can show as float window.'); }); @@ -449,7 +445,7 @@ canShowFloating(callback: AsyncCallback\): void canShowFloating(): Promise\ -检查应用能够作为悬浮窗显示。使用Promise异步回调。 +检查应用是否能够以悬浮窗形式显示。使用Promise异步回调。 **系统能力**：SystemCapability.Applications.settings.Core @@ -457,11 +453,11 @@ canShowFloating(): Promise\ | 类型 | 说明 | | ----------------- | ------------------------------------------------------------ | -| Promise\ | Promise对象。返回true表示应用程序可以覆盖其他应用程序，否则返回false。 | +| Promise\ | Promise对象。
返回true，表示应用能够以悬浮窗形式显示；返回false，则表示不能。 | **示例**： -```ts +```js canShowFloating().then((status) => { console.log('Checks whether a specified application can show as float window.'); }); @@ -489,7 +485,7 @@ getUriSync(name: string): string **示例**： -```ts +```js // 获取数据项的URI let urivar = settings.getUriSync(settings.display.SCREEN_BRIGHTNESS_STATUS); ``` @@ -518,7 +514,7 @@ getValueSync(dataAbilityHelper: DataAbilityHelper, name: string, defValue: strin **示例**： -```ts +```js import featureAbility from '@ohos.ability.featureAbility'; //获取数据项亮度的值（该数据项在数据库中已存在） @@ -550,11 +546,11 @@ setValueSync(dataAbilityHelper: DataAbilityHelper, name: string, value: string): | 类型 | 说明 | | ------- | ------------------------------------------------------------ | -| boolean | 返回设置数据项的值是否成功的结果。true表示设置成功，false表示表示设置失败。 | +| boolean | 返回设置数据项的值是否成功的结果。true表示设置成功，false表示设置失败。 | **示例**： -```ts +```js import featureAbility from '@ohos.ability.featureAbility'; //更新数据项亮度的值（该数据项在数据库中已存在，故setValueSync方法将更新该数据项的值）