SmartLampAdvancedAbility.convertDp(dpCode: "color_temp_control" | "temp_value" | "bright_value", dpValue: number)

版本要求:
≥1.15.0

描述

按功能点将原始 DP 值转为带单位的显示值；支持 bright_value、temp_value、color_temp_control。

参数

参数类型必填说明
dpCode"color_temp_control" | "temp_value" | "bright_value"是功能点编码
dpValuenumber是功能点原始数值

返回值

类型：ConvertValue | null
成功为显示值与单位；未启用高级能力时返回 { value, unit: '' }；云端无有效翻译时可能为 null。需网络。

引用对象

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

合法值

dpCode
值说明最低版本
color_temp_control--
temp_value--
bright_value--

示例代码

示例

const b = await sdm.lampAdv.convertDp('bright_value', 100);
const t = await sdm.lampAdv.convertDp('temp_value', 2700);
const m = await sdm.lampAdv.convertDp('color_temp_control', 2700);

注意事项

  1. 该方法会自动检测设备是否启用了对应 DP 功能点的高级能力
  2. 如果未启用高级能力，会直接返回原始值和空单位
  3. 转换过程会调用云端接口 ty.device.dpTranslateAdvancedCapability，需要网络连接
  4. 对于 Matter 设备，色温功能点使用 color_temp_control
  5. 对于标准协议设备，色温功能点使用 temp_value
  6. 该方法内部会先调用 getAdvanceHighEnabled 检查能力是否启用