# 色温

以下指令请求并响应可调白光的色温变化。可调的白光是一种光，您可以调整白色的“温度”。色温值用开尔文测量。 Smart Home Skill API支持2200K（暖白）至7000K（冷白）的值，其中2700K相当于柔和的白色紧凑型荧光灯或LED灯。

SetColorTemperatureRequest
SetColorTemperatureConfirmation
IncrementColorTemperatureRequest
IncrementColorTemperatureConfirmation
DecrementColorTemperatureRequest
DecrementColorTemperatureConfirmation

需要注意的是：

增量色温请求是当客户要求更冷色温时发送的指令，这导致更高的色温值。

相反降低色温的请求是当客户要求更暖的光线时发出的指令，这导致较低的色温值。

# SetColorTemperatureRequest

示例语句： “小微，设置客厅灯为暖光”
目的：请求将指定设备的色温更改为指定设置。从Smart Home Skill API发送到技能适配器。下表列出了智能家居技巧API会发送的一些可能的色温请求和相关值。如果您的照明设备不支持请求的值，建议您将设备设置为最接近的值。

白色色调	温度值（开氏度）
暖光	2200
柔光	2700
白光	4000
日光	5500
冷光	7000

Header

属性	值
name	SetColorTemperatureRequest
namespace	SmartHome.Control

Payload

属性	描述	是否必需
accessToken	与客户的设备云账户相关的访问令牌。	是
appliance object	执行操作的设备。	是
appliance.applianceID	设备标识符。标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。该值不能超过256个字符。	是
appliance.additionalApplianceDetails	提供关于技能适配器使用的设备的附加信息的字符串名称/值对。该属性的内容不能超过5000字节。而且，Smart Home Skill API即不理解也不使用这些数据。	是，但列表可以为空。
colorTemperature	对象描述为灯设置的色温。以开尔文度表示。	否
colorTemperature.value	以开尔文度表示所请求的色温的整数。有效范围为1000～10000(含)。	是
degree	对象描述为色温设置的程度。	否
degree.value	描述控制的程度。对应的值为string类型的max或者min。	是

SetColorTemperatureRequest示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "SetColorTemperatureRequest",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "accessToken": "[OAuth Token here]",
    "appliance": {
      "additionalApplianceDetails": {},
      "applianceId": "[Device ID]"
    },
    "colorTemperature": {
      "value": 2700
    },
    "degree": {
      "value": "min"
    }
  }
}

# SetColorTemperatureConfirmation

小微响应示例：“好的”
目的：表示设备已成功更改为要求的色温。对SetColorTemperatureRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	SetColorTemperatureConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status对象	指示颜色更改后设备的状态。此对象是必需的，但请注意，如果无法查询设备的状态，或者不希望引起查询的额外延迟，则可以返回SetColorTemperatureRequest中发送的值。	是
status.colorTemperature对象	表示颜色变化后设备的色温。	是
colorTemperature.value	表示以开尔文度为单位的色温设置的整数。有效范围为1000〜10000（含）。	是

SetColorTemperatureConfirmation示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "SetColorTemperatureConfirmation",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "status": {
      "colorTemperature": {
        "value": 2700
      }
    }
  }
}

# IncrementColorTemperatureRequest

示例语句：
“小微，把客厅灯设置的更冷一些”
目的：要求将指定设备的色温设置为较冷的灯光设置，这意味着提高设备的开尔文温度值。从Smart Home Skill API发送到技能适配器。此指令不指定特定设置，但要求相对于当前设备设置的更冷/更白的设置。您可以根据当前的设置，功能和其他值选择多少调整指定设备的设置。如果设备不能进一步增加，请将其设置为其最大色温。如果您收到此指令，并且指定的设备当前设置为颜色，则应返回NotSupportedInCurrentModeError，将currentDeviceMode设置为COLOR。

Header

属性	值
name	IncrementColorTemperatureRequest
namespace	SmartHome.Control

Payload

属性	描述	是否必需
accessToken	与客户的设备云账户相关的访问令牌。	是
appliance object	执行操作的设备。	是
appliance.applianceID	设备标识符。标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。该值不能超过256个字符。	是
appliance.additionalApplianceDetails	提供关于技能适配器使用的设备的附加信息的字符串名称/值对。该属性的内容不能超过5000字节。而且，Smart Home Skill API即不理解也不使用这些数据。	是，但列表可以为空。

IncrementColorTemperatureRequest示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "IncrementColorTemperatureRequest",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "accessToken": "[OAuth Token here]",
    "appliance": {
      "additionalApplianceDetails": {},
      "applianceId": "[Device ID]"
    }
  }
}

# IncrementColorTemperatureConfirmation

小微响应示例：“好的”
目的：表示设备已成功提高了色温。对IncrementColorTemperatureRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	IncrementColorTemperatureConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status对象	指示色温提高后设备的状态。	是
status.colorTemperature对象	表示色温提高后设备的色温。	是
colorTemperature.value	表示以开尔文度为单位的色温设置的整数。有效范围为1000〜10000（含）。	是

IncrementColorTemperatureConfirmation示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "IncrementColorTemperatureConfirmation",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "status": {
      "colorTemperature": {
        "value": 2700
      }
    }
  }
}

# DecrementColorTemperatureRequest

示例语句：
“小微，把客厅灯设置的更暖一些”
目的：要求将指定设备的色温设置为较暖的灯光设置，这意味着降低设备的开尔文温度值。从Smart Home Skill API发送到技能适配器。此指令不指定特定设置，但要求相对于当前设备设置的更暖／更柔的设置。您可以根据当前的设置，功能和其他值选择多少调整指定设备的设置。如果设备不能进一步降低，请将其设置为其最小色温。如果您收到此指令，并且指定的设备当前设置为颜色，则应返回NotSupportedInCurrentModeError，将currentDeviceMode设置为COLOR。

Header

属性	值
name	DecrementColorTemperatureRequest
namespace	SmartHome.Control

Payload

属性	描述	是否必需
accessToken	与客户的设备云账户相关的访问令牌。	是
appliance object	执行操作的设备。	是
appliance.applianceID	设备标识符。标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。此外，标识符需要在同一设备的多个发现请求之间保持一致。标识符可以包含任何字母或数字和以下特殊字符：_ - = # ; : ? @ &。该值不能超过256个字符。	是
appliance.additionalApplianceDetails	提供关于技能适配器使用的设备的附加信息的字符串名称/值对。该属性的内容不能超过5000字节。而且，Smart Home Skill API即不理解也不使用这些数据。	是，但列表可以为空。

DecrementColorTemperatureRequest示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "DecrementColorTemperatureRequest",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "accessToken": "[OAuth Token here]",
    "appliance": {
      "additionalApplianceDetails": {},
      "applianceId": "[Device ID]",
    }
  }
}

# DecrementColorTemperatureConfirmation

小微响应示例：“好的”
目的：表示设备已成功降低了色温。对DecrementColorTemperatureRequest的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	DecrementColorTemperatureConfirmation
namespace	SmartHome.Control

Payload

属性	描述	是否必需
status对象	指示色温降低后设备的状态。	是
status.colorTemperature对象	表示色温降低后设备的色温。	是
colorTemperature.value	表示以开尔文度为单位的色温设置的整数。有效范围为1000〜10000（含）。	是

DecrementColorTemperatureConfirmation示例：

{
  "header": {
    "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6",
    "name": "DecrementColorTemperatureConfirmation",
    "namespace": "SmartHome.Control",
    "payloadVersion": "2"
  },
  "payload": {
    "status": {
      "colorTemperature": {
        "value": 2700
      }
    }
  }
}