外观
system.settings
约 276 字小于 1 分钟
2026-07-15
厂商系统属性键值桥。它不是快应用自己的 system.storage:system.settings 读写系统业务属性,并能订阅跨进程更新。
import settings from '@system.settings'方法
getProp(options: {
key: string
success?: (value: string | number | object) => void
fail?: Function
complete?: Function
}): void
setProp(options: {
key: string
value: string | number
success?: Function
fail?: Function
complete?: Function
}): void
subscribeProp(options: {
key: string
callback: (value: unknown) => void
success?: Function
fail?: Function
complete?: Function
}): void
unsubscribeProp(key: string): void| 方法 | 行为 |
|---|---|
getProp | 异步读取指定 key |
setProp | 写入字符串或数值;其他 value 类型会被拒绝 |
subscribeProp | 订阅 key 的更新,callback 必须是函数 |
unsubscribeProp | 取消对应 key 的订阅 |
settings.getProp({
key: 'car',
success(value) { console.log(value) },
fail(data, code) { console.error(code, data) }
})
settings.subscribeProp({
key: 'car',
callback(value) { console.log('car settings changed', value) }
})
// 页面销毁时
settings.unsubscribeProp('car')预装汽车应用也使用 car.vid 等带前缀的 key。key 不是公共注册表;不要枚举、覆盖或删除其他系统组件的属性。
机型可用性
| Xiaomi Smart Band 10 Pro | Xiaomi Watch S4 41mm |
|---|---|
| ❌ | △ |
获取源代码
- openvela Feature Framework 当前没有公开该厂商模块的 JIDL 或 C++ 实现。
- Feature Framework 仓库