系统设置
更新时间：
接口声明
{ "name": "blueos.service.settings" }复制代码
导入模块
import settings from '@blueos.service.settings'复制代码
在工程里面的 manifest 文件中配置如下内容
申请权限
{
"permissions": [{ "name": "watch.permission.SETTINGS" }]
}复制代码
接口定义
settings.getValue(OBJECT)
获取设置
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | 相应设置的字段名 |
| success | Function | 否 | 成功回调 |
| fail | Function | 否 | 失败回调 |
| complete | Function | 否 | 执行结束后的回调 |
success 返回值：
| 参数值 | 类型 | 说明 |
|---|---|---|
| key | String | 相应设置的字段名 |
| value | String/Object/Array 等 JS 原生对象 | 相应设置的值 |
示例：
settings.getValue({
key: 'brightness',
success: function (data) {
console.log(data.key + ': ' + data.value)
},
fail: function (data, code) {
console.log(`handling fail, code = ${code}`)
},
})复制代码
settings.getValueSync(String)
同步获取设置
参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| key | String | 是 | 相应设置的字段名 |
返回值
| 参数值 | 类型 | 说明 |
|---|---|---|
| value | String/Object/Array 等 JS 原生对象 | 相应设置的值 |
示例
const value = settings.getValueSync('brightness')复制代码
设置相关的字段
brightness 屏幕亮度
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| brightness | Number | 系统屏幕亮度值设置 | 取值范围 0-255 |
{
brightness: 60
}复制代码
wearHand 佩戴手
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| wearHand | String | 佩戴手设置 | L: 左手， R: 右手 |
{
wearHand: 'R'
}复制代码
raiseWristSwitch 抬腕监听开关
注意: 此处的监听仅代表用户感知的监听设置，和真实的监听无关
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| raiseWristSwitch | Boolean | 抬腕监听开关设置 | true: 开启抬腕监听， false: 关闭抬腕监听 |
{
raiseWristSwitch: true
}复制代码
raiseWristSensitivity 抬腕监听灵敏度
注：灵敏度改变会影响 sensor 接口监听的灵敏度
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| raiseWristSensitivity | String | 抬腕监听灵敏度设置 | H: 高灵敏度， M: 标准灵敏度 |
{
raiseWristSensitivity: `H`
}复制代码
silentMode 静音模式
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| silentMode | Boolean | 静音模式设置 | true: 开启静音模式， false: 关闭静音模式 |
{
silentMode: false
}复制代码
flipScreen 屏幕翻转
| 字段名 | 类型 | 功能 | 说明 |
|---|---|---|---|
| flipScreen | Boolean | 屏幕翻转设置 | true: 翻转到正向， false: 翻转到反向 |
{
flipScreen: false
}复制代码