SmartLampAdvancedAbility.convertTemperature(temperature: number)
版本要求:
≥1.15.0
描述
转换色温值:若设备启用高级色温能力则返回带单位的显示值(如 2700K),否则返回原始值与空单位。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
temperature | number | 是 | 色温原始值(面板侧数值,如 2700) |
返回值
类型:ConvertValue
转换后的数值与单位;未启用高级能力时 unit 为空字符串。依赖云端 dpTranslateAdvancedCapability,需网络。
引用对象
type
ConvertValue| 属性 | 类型 | 描述 |
|---|---|---|
value | number | 数值 |
unit | string | 单位 |
示例代码
示例
注意事项
- 该方法会自动检测设备是否启用了高级色温能力
- 如果未启用高级能力,会直接返回原始值和空单位
- 对于 Matter 设备,会自动使用
color_temp_control进行转换 - 对于标准协议设备,会自动使用
temp_value进行转换 - 转换过程会调用云端接口,需要网络连接