From d92e92e70bbb37bd4e749705ad96d21be51780c2 Mon Sep 17 00:00:00 2001 From: david Date: Wed, 18 Jun 2025 11:43:17 +0800 Subject: [PATCH 1/2] =?UTF-8?q?settings=E6=96=87=E6=A1=A3=E5=88=A0?= =?UTF-8?q?=E9=99=A4=E6=9A=82=E4=B8=8D=E6=94=AF=E6=8C=81=E5=AD=97=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: david --- .../js-apis-settings.md | 116 +----------------- 1 file changed, 4 insertions(+), 112 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md index 1392e34f278..f8ec35ea6f2 100644 --- a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md @@ -28,7 +28,7 @@ import { settings } from '@kit.BasicServicesKit'; ## date -提供设置时间和日期格式的数据项（暂不支持）。 +提供设置时间和日期格式的数据项。 ### 属性 @@ -36,14 +36,11 @@ import { settings } from '@kit.BasicServicesKit'; | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------- | ------ | ---- | ---- |----------------------------------------------------------------------------| -| 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 -提供设置显示效果的数据项（暂不支持）。 +提供设置显示效果的数据项。 ### 属性 @@ -51,21 +48,13 @@ import { settings } from '@kit.BasicServicesKit'; | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------------------- | ------ | ---- | ---- |----------------------------------------------------------------------------------------------------------------------| -| FONT_SCALE | string | 是 | 是 | 字体的比例因子，值为浮点数。（当前版本参数仅支持固定值查询。） | | SCREEN_BRIGHTNESS_STATUS | string | 是 | 是 | 屏幕亮度。取值范围:0到255。 | | AUTO_SCREEN_BRIGHTNESS | string | 是 | 是 | 是否启用屏幕亮度自动调整。
- 值为AUTO_SCREEN_BRIGHTNESS_MODE，表示启用自动调整。
- 值为MANUAL_SCREEN_BRIGHTNESS_MODE，表示不启用自动调整。 | -| 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 -提供设置设备常规信息的数据项（暂不支持）。 +提供设置设备常规信息的数据项。 ### 属性 @@ -73,26 +62,12 @@ import { settings } from '@kit.BasicServicesKit'; | 名称 | 类型 | 可读 | 可写 | 说明 | | -------------------------------- | ------ | ---- | ---- |-------------------------------------------------------------------------------------------------------------------------------------| -| SETUP_WIZARD_FINISHED | string | 是 | 是 | 是否已运行启动向导。
- 值为0，表示启动向导尚未运行。
- 值为非0，表示启动向导已运行。 | -| END_BUTTON_ACTION | string | 是 | 是 | 当用户不在呼叫中时，由用户按下呼叫结束按钮后会发生的情况。
- 值为0，表示没有任何反应。
- 值为1，表示显示主屏幕。
- 值为2，表示设备进入睡眠状态，屏幕锁定。
- 值为3，表示显示主屏幕。如果用户已在主屏幕上，设备将进入睡眠状态。 | | ACCELEROMETER_ROTATION_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，表示不启用同步。 | | DEVICE_NAME | string | 是 | 是 | 设备名称。 | -| USB_STORAGE_STATUS | string | 是 | 是 | 是否启用USB大容量存储。
- 值为true，表示启用USB大容量存储。
- 值为false，表示不启用USB大容量存储。 | -| DEBUGGER_WAITING | string | 是 | 是 | 设备在启动应用程序进行调试时是否等待调试器进行调试。
- 值为1，表示设备等待调试器。
- 值为0，表示系统不会等待调试器，应用程序正常运行。 | -| DEBUG_APP_PACKAGE | string | 是 | 是 | 要调试的应用程序的bundle name。 | -| 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 -提供设置有关输入法信息的数据项（暂不支持）。 +提供设置有关输入法信息的数据项。 ### 属性 @@ -100,28 +75,7 @@ import { settings } from '@kit.BasicServicesKit'; | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------------------------ | ------ | ---- | ---- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| DEFAULT_INPUT_METHOD | string | 是 | 是 | 默认输入法及其ID。 | | ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 是 | 默认输入法键盘类型及其ID。 | -| ACTIVATED_INPUT_METHODS | string | 是 | 是 | 已激活的输入法的列表。
该列表是一个字符串，由已激活的输入法ID和输入法键盘类型组成。
输入法ID后添加冒号':'连接，输入法的键盘类型后添加分号';'连接。
用ima代表输入法ID，keyboardType代表键盘类型，示例格式是ima0:keyboardType0;keyboardType1;ima1:ima2:keyboardTypes0。 | -| 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 | 是 | 是 | 要使用网络的用户首选项。 | ## phone @@ -135,68 +89,6 @@ import { settings } from '@kit.BasicServicesKit'; | ------------------ | ------ | ---- | ---- |--------------------------------------------------------------------------------------------| | 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）模式更改的影响。要求特定的音频流受到振铃模式和DND模式变化的影响，将对应比特位设置为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 | 是 | 是 | 设备是否启用触觉反馈。
- 值为true，表示启用触觉反馈。
- 值为false，表示不启用触觉反馈。 | - -## 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的已激活插件包列表，多个插件包用空格分隔。 | - - -## 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 | 是 | 否 | 常量，作为AIRPLANE_MODE_RADIOS的取值时表示蓝牙在飞行模式下禁用。 | -| CELL_RADIO | string | 是 | 否 | 常量，作为AIRPLANE_MODE_RADIOS的取值时表示蜂窝无线电在飞行模式下禁用。 | -| NFC_RADIO | string | 是 | 否 | 常量，作为AIRPLANE_MODE_RADIOS的取值时表示NFC在飞行模式下禁用。 | -| WIFI_RADIO | string | 是 | 否 | 常量，作为AIRPLANE_MODE_RADIOS的取值时表示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，表示不可用。 | - ## settings.setValue10+ -- Gitee From 67ab03a659e51cecd0d3fe274c45079281f5153d Mon Sep 17 00:00:00 2001 From: david Date: Wed, 18 Jun 2025 14:20:57 +0800 Subject: [PATCH 2/2] =?UTF-8?q?settings=E6=96=87=E6=A1=A3=E5=88=A0?= =?UTF-8?q?=E9=99=A4=E6=9A=82=E4=B8=8D=E6=94=AF=E6=8C=81=E5=AD=97=E6=AE=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: david --- .../apis-basic-services-kit/js-apis-settings.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md index f8ec35ea6f2..758290a6b69 100644 --- a/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md +++ b/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-settings.md @@ -77,18 +77,6 @@ import { settings } from '@kit.BasicServicesKit'; | ------------------------------------ | ------ | ---- | ---- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ACTIVATED_INPUT_METHOD_SUB_MODE | string | 是 | 是 | 默认输入法键盘类型及其ID。 | -## phone - -提供设置来电和去电接听方式的数据项（暂不支持）。 - -### 属性 - -**系统能力：** SystemCapability.Applications.Settings.Core - -| 名称 | 类型 | 可读 | 可写 | 说明 | -| ------------------ | ------ | ---- | ---- |--------------------------------------------------------------------------------------------| -| RTT_CALLING_STATUS | string | 是 | 是 | 是否启用实时文本（RTT）呼叫。启用表示来电和去电在设备以及运营商支持时作为RTT呼叫应答。
- 值为1，表示启用RTT呼叫。
- 值为0，表示不启用RTT呼叫。 | - ## settings.setValue10+ -- Gitee