作者:重庆互联网小徐 发布时间:2024-12-23 浏览:14289 赞(1850) 收藏 评论(0)
这些消息类型包含温度,并提供获取和设置设备温度的指令。 重要的是要注意,Smart Home Skill API始终将摄氏温度设置传递给您的技能适配器,而您的技能适配器应该以摄氏温度返回温度。 您还需要将温度保存至少两位小数,这能确保内部转换需要的足够精度。
GetTemperatureReadingRequest
GetTemperatureReadingResponse
GetTargetTemperatureRequest
GetTargetTemperatureResponse
SetTargetTemperatureRequest
SetTargetTemperatureConfirmation
IncrementTargetTemperatureRequest
IncrementTargetTemperatureConfirmation
DecrementTargetTemperatureRequest
DecrementTargetTemperatureConfirmation
示例语句:
“小微,空调的温度现在是多少?”
目的:请求指定设备的温度读数。 从Smart Home Skill API发送到技能适配器。
Header
属性 | 值 |
---|---|
name | GetTemperatureReadingRequest |
namespace | SmartHome.Query |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
accessToken | 与客户的设备云账户相关的访问令牌。 | 是 |
appliance object | 执行操作的设备。 | 是 |
appliance.applianceID | 设备标识符。 标识符在技术适配器的域内的最终用户拥有的所有设备上必须是唯一的。 此外,标识符需要在同一设备的多个发现请求之间保持一致。 标识符可以包含任何字母或数字和以下特殊字符:_-=#;:?@&。 该值不能超过256个字符。 | 是 |
appliance.additionalApplianceDetails | 提供关于技能适配器使用的设备的附加信息的字符串名称/值对。 该属性的内容不能超过5000字节。 而且,Smart Home Skill API即不理解也不使用这些数据。 | 是,但列表可以为空。 |
GetTemperatureReadingRequest示例:
{ "header": { "messageId": "9422676d-2356-4aa7-aa88-c642f12bfcd6", "name": "GetTemperatureReadingRequest", "namespace": "SmartHome.Query", "payloadVersion":"2" }, "payload": { "accessToken": "[OAuth token here]", "appliance": { "applianceId": "[Device ID for the specified thermostat, thermometer, or temperature sensor]", "additionalApplianceDetails": { } }, } }
小微响应示例:“空调的温度是26摄氏度”
目的:说明指定设备的当前温度读数。 对GetTemperatureReadingRequest的预期响应,并从技能适配器发送到Smart Home Skill API。
Header
属性 | 值 |
---|---|
name | GetTemperatureReadingResponse |
namespace | SmartHome.Query |
Payload
属性 | 描述 | 是否必需 |
---|---|---|
temperatureReading object | 表示来自指定设备的温度读数,以摄氏度为单位。 | 是 |
temperatureReading.value | 浮点数,表示以摄氏度为单位的温度。 | 是 |
applianceResponseTimestamp | 指示从目标设备检索到温度的最后更新时间。 这有助于表明响应的新鲜度,这可能会影响小微的响应。 该值的精度是特定于设备的,可以由技能适配器估计。 | 否 |
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,20年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!