---
name: "SmartLampAdvancedAbility.convertTemperature"
mode: "api"
versionRequirements:
  - { name: "", version: "1.15.0" }
title: "convertTemperature - 转换色温值。如果设备启用了高级色温能力，会将色温值转换为带单位的显示值（如 2700K），否则返回原始值。"
summary: "转换色温值，若设备启用高级色温能力则返回带单位的显示值（如 2700K）。"
---

## SmartLampAdvancedAbility.convertTemperature

> [VERSION] v1.15.0+

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `temperature` | `number` | 是 | 色温原始值（面板侧数值，如 2700） |

### 返回值

类型: `ConvertValue`

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

**`type` ConvertValue**

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `number` | 数值 |
| `unit` | `string` | 单位 |

### 引用对象

##### `type` ConvertValue

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `value` | `number` | 数值 |
| `unit` | `string` | 单位 |


### 示例代码

#### 示例

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


**注意事项**

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