SmartLampAdvancedAbility.convertBrightness(brightness: number)

版本要求:
≥1.15.0

描述

转换亮度值:若设备启用千分之一亮度能力则返回带单位的显示值,否则返回原始值与空单位。

参数

参数类型必填说明
brightnessnumber是亮度原始值(常见范围如 10~1000)

返回值

类型:ConvertValue
转换后的数值与单位;未启用高级能力时 unit 为空字符串。依赖云端接口,需网络。

引用对象

typeConvertValue
属性类型描述
valuenumber数值
unitstring单位

示例代码

示例

const result = await sdm.lampAdv.convertBrightness(100);
console.log('亮度:', result.value, result.unit);

注意事项

  1. 该方法会自动检测设备是否启用了千分之一亮度能力
  2. 如果未启用高级能力,会直接返回原始值和空单位
  3. 转换过程会调用云端接口,需要网络连接
  4. 亮度值的范围通常是 10-1000(千分之一亮度)