SmartLampAdvancedAbility.convertBrightness(brightness: number)
版本要求:
≥1.15.0
描述
转换亮度值:若设备启用千分之一亮度能力则返回带单位的显示值,否则返回原始值与空单位。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
brightness | number | 是 | 亮度原始值(常见范围如 10~1000) |
返回值
类型:ConvertValue
转换后的数值与单位;未启用高级能力时 unit 为空字符串。依赖云端接口,需网络。
引用对象
type
ConvertValue| 属性 | 类型 | 描述 |
|---|---|---|
value | number | 数值 |
unit | string | 单位 |
示例代码
示例
注意事项
- 该方法会自动检测设备是否启用了千分之一亮度能力
- 如果未启用高级能力,会直接返回原始值和空单位
- 转换过程会调用云端接口,需要网络连接
- 亮度值的范围通常是 10-1000(千分之一亮度)