0. 阿里云 IoT 物模型
物模型定义了产品的属性、服务、事件通信协议,IoT 设施和云端须要按约定规定通信,能力实现物模型转化。
1. 设施属性通信
1.1 设施上报属性
设施上报 pubTopic
/sys/{productKey}/{deviceName}/thing/event/property/post
设施上报 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": {
"属性 key1": "属性 value1",
"属性 key2": "属性 value2"
},
"method": "thing.event.property.post"
}
IoT 云端响应 replyTopic
/sys/{productKey}/{deviceName}/thing/event/property/post_reply
云端响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {}}
1.2 云端设置设施属性
设施订阅 subTopic
/sys/{productKey}/{deviceName}/thing/service/property/set
IoT 云端上行的 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": {
"属性 key1": "属性 value1",
"属性 key2": "属性 value2"
},
"method": "thing.service.property.set"
}
设施响应 replyTopic
/sys/{productKey}/{deviceName}/thing/service/property/set_reply
设施响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {}}
1.3 云端获取设施属性
设施订阅 subTopic
/sys/{productKey}/{deviceName}/thing/service/property/get
IoT 云端上行的 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": [
"属性 key1",
"属性 key2"
],
"method": "thing.service.property.get"
}
设施响应 replyTopic
/sys/{productKey}/{deviceName}/thing/service/property/get_reply
设施响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {
"属性 key1": "属性 value1",
"属性 key2": "属性 value2"
}
}
2. 设施服务调用
2.1 服务的异步调用
设施订阅 subTopic
留神:服务订阅 Topic 这里不反对 + 通配符
/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}
或者订阅指定 service/sys
/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}
IoT 云端上行的 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": {
"入参 key1": "入参 value1",
"入参 key2": "入参 value2"
},
"method": "thing.service.{tsl.service.identifier}"
}
设施响应 replyTopic
/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}_reply
设施响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {
"出参 key1": "出参 value1",
"出参 key2": "出参 value2"
}
}
2.2 服务的同步调用
设施订阅 subTopic
留神: 服务同步调用 API 是 InvokeThingService
/sys/${productKey}/${deviceName}/rrpc/request/+
IoT 云端上行的 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": {
"入参 key1": "入参 value1",
"入参 key2": "入参 value2"
},
"method": "thing.service.{tsl.service.identifier}"
}
设施响应 replyTopic
/sys/${productKey}/${deviceName}/rrpc/response/request 的音讯 Id
设施响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {
"出参 key1": "出参 value1",
"出参 key2": "出参 value2"
}
}
3. 设施事件上报
3.1 事件上报
设施上报 pubTopic
/sys/{productKey}/{deviceName}/thing/event/{tsl.event.identifier}/post
设施上报 payload 格局
{
"id": 3536123,
"version": "1.0",
"params": {
"入参 key1": "入参 value1",
"入参 key2": "入参 value2"
},
"method": "thing.event.{tsl.event.identifier}.post"
}
IoT 云端响应 replyTopic
/sys/{productKey}/{deviceName}/thing/event/{tsl.event.identifier}/post_reply
云端响应 payload 格局
{
"id": 3536123,
"code": 200,
"data": {}}
物联网平台产品介绍详情:https://www.aliyun.com/product/iot/iot_instc_public_cn
阿里云物联网平台客户交换群