作者:重庆互联网小徐 发布时间:2024-12-26 浏览:14268 赞(1850) 收藏 评论(0)
示例语句:
“小微,设置空调温度到25度”
目的:将指定设备设置为指定的温度,单位为摄氏度。 从Smart Home Skill API发送到技能适配器。
Header
属性 | 值 |
---|---|
name | SetTargetTemperatureRequest |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
accessToken | 与客户的设备云账户相关的访问令牌。 | 是 |
appliance object | 执行操作的设备。 | 是 |
appliance.applianceID | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外,标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符:_ - = # ; : ? @ &。 该值不能超过256个字符。 | 是 |
appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且,Smart Home Skill API即不理解也不使用这些数据。 | 是,但列表可以为空。 |
targetTemperature | 设置由applianceId指定的设备的目标温度(摄氏度)。 | 否 |
targetTemperature.value | 一个浮点数,设定的目标温度 | 是 |
degree | 对象描述为温度设置的程度。 | 否 |
degree.value | 描述控制的程度。对应的值为string类型的max或者min | 是 |
SetTargetTemperatureRequest示例:
{ "header": { "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6", "name": "SetTargetTemperatureRequest", "namespace": "SmartHome.Control", "payloadVersion":"2" }, "payload": { "accessToken": "[OAuth token here]", "appliance": { "additionalApplianceDetails": {}, "applianceId": "[Device ID]" }, "targetTemperature": { "value": 26.00 } "degree": { "value": "min" } } }
小微响应示例:“空调已设置成26摄氏度”
目的:表示目标温度设置成功。 对SetTargetTemperatureRequest的预期响应,并从技能适配器发送到Smart Home Skill API。
Header
属性 | 值 |
---|---|
name | SetTargetTemperatureConfirmation |
namespace | SmartHome.Control |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
targetTemperature | 指示设备设置的目标温度(以摄氏度为单位)的对象。 仅包含一个值是数字的属性value。 | 是 |
temperatureMode | 指示设备设置的温度模式的对象。 包含单个属性value,其值为以下字符串之一:AUTO,COOL,HEAT。 | 是 |
previousState object | 表示设备的先前模式和温度。 | 是 |
previousState.targetTemperature | 指示设备设置的目标温度(以摄氏度为单位)的对象。 仅包含一个值是数字的属性value。 | 是 |
previousState. temperatureMode | 指示设备设置的温度模式的对象。 包含单个属性value,其值为以下字符串之一:AUTO,COOL,HEAT。 | 是 |
SetTargetTemperatureConfirmation示例:
{ "header": { "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6", "name": "SetTargetTemperatureConfirmation", "namespace": "SmartHome.Control", "payloadVersion":"2" }, "payload": { "targetTemperature": { "value": 25.0 }, "temperatureMode": { "value": "AUTO" }, "previousState": { "targetTemperature": { "value": 21.0 }, "temperatureMode": { "value": "AUTO" } } } }
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!