色温

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

需要注意的是：

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

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

SetColorTemperatureRequest

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

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的预期响应，并从技能适配器发送到Smart Home Skill API。

Header

属性	值
name	SetColorTemperatureConfirmation
namespace	SmartHome.Control

Payload

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

重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案，专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发，帮助企业实现从传统行业到互联网的完美转型。截止目前，重庆互联网合作的企业遍布全国各地，20年的开发经验和完善的售后服务体系获得合作客户的高度认可！

关注重庆互联网官方公众号，即可获取粉丝专享福利！

重庆互联网公众号二维码.jpg

网友留言评论

我要评论