作者:重庆互联网小徐 发布时间:2024-12-31 浏览:19774 赞(1850) 收藏 评论(0)
以下指令要求并响应对可变色光的色调的变化。 照明颜色以色相,饱和度,亮度(HSB)值进行测量。
SetColorRequest
SetColorConfirmation
示例语句:
“小微, 帮我设置{设备名}的灯光颜色为白色”
“小微, 卧室灯颜色设置为白色”
目的:在指定的设备上请求照明颜色更改。 从Smart Home Skill API 发送到技能适配器。
Header
属性 | 值 |
---|---|
name | SetColorRequest |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
accessToken | 与客户的设备云账户相关的访问令牌。 | 是 |
appliance object | 执行操作的设备。 | 是 |
appliance.applianceID | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外,标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符:_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是 |
appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且,Smart Home Skill API即不理解也不使用这些数据。 | 是,但列表可以为空。 |
color object | 描述为灯设置的颜色。 在色相,饱和度,亮度(HSB)颜色模型中指定。 | 是 |
color.hue | double类型,表示需要设置的色调。 有效范围为0.00〜360.00(含)。 | 是 |
color.saturation | double类型,表示需要设置的饱和度。 有效范围为0.0000至1.0000(含)。 | 是 |
color.brightness | double类型,表示需要设置的亮度。 有效范围为0.0000至1.0000(含)。 | 是 |
SetColorRequest示例:
{ "header": { "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6", "namespace": "SmartHome.Control", "name": "SetColorRequest", "payloadVersion": "2" }, "payload": { "accessToken": "[OAuth Token here]", "appliance": { "applianceId": "[Device ID for RGB-capable bulb]", "additionalApplianceDetails": {} }, "color": { "hue": 0.0, "saturation": 1.0000, "brightness": 1.0000 } } }
小微响应示例:“好的”
目的:表示设备已成功更改为请求的颜色。 对SetColorRequest的预期响应,并从技能适配器发送到Smart Home Skill API。
Header
属性 | 值 |
---|---|
name | SetColorConfirmation |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
status object | 指示颜色更改后设备的状态。 此对象是必需的,但请注意,如果无法查询设备的状态,或者不希望引起查询的额外延迟,则可以返回SetColorRequest中发送的值。 | 是 |
status.color object | 表示颜色变化后设备的颜色。 | 是 |
color.hue | double类型,表示设置后的色调。 有效范围为0.00〜360.00(含)。 | 是 |
color.saturation | double类型,表示设置后的饱和度。 有效范围为0.0000至1.0000(含)。 | 是 |
color.brightness | double类型,表示设置后的亮度。 有效范围为0.0000至1.0000(含)。 | 是 |
SetColorConfirmation示例:
{ "header": { "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6", "namespace": "SmartHome.Control", "name": "SetColorConfirmation", "payloadVersion": "2" }, "payload": { "status": { "color": { "hue": 0.0, "saturation": 1.0000, "brightness": 1.0000 } } } }
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!