SmartLampAdvancedAbility.convertTemperature(temperature: number)

版本要求:
≥1.15.0

描述

转换色温值:若设备启用高级色温能力则返回带单位的显示值(如 2700K),否则返回原始值与空单位。

参数

参数类型必填说明
temperaturenumber是色温原始值(面板侧数值,如 2700)

返回值

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

引用对象

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

示例代码

示例

const result = await sdm.lampAdv.convertTemperature(2700);
console.log('色温:', result.value, result.unit);

注意事项

  1. 该方法会自动检测设备是否启用了高级色温能力
  2. 如果未启用高级能力,会直接返回原始值和空单位
  3. 对于 Matter 设备,会自动使用 color_temp_control 进行转换
  4. 对于标准协议设备,会自动使用 temp_value 进行转换
  5. 转换过程会调用云端接口,需要网络连接