app和后台的mqtt协议

* ## **mqtt指令发送流程**

![](/media/202503/4eb514118db34ded9284b373aa06f18e2098.png)
~~app和后台同时订阅某个Topic，会导致数据重复问题：
后台需要对上报的数据进行过滤，依据条件是序列号，序列号一样就过滤一下~~

* ## 业务Topic设计
指令下发：服务端是server->app是client

**server-> app**

```
app/v1/cmd/{#familyId} 
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "alarm",
    "data": {
        ...
    },
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```

**app->server**

```
app/v1/cmd/reply
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "alarm",
    "code": "000000",
    "data": {
        ...
    },
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```

* ## mqtt 接口地址

* **` 设备的在线`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "online",
    "data": [
         "uuid123456",   //设备uuid
         "uuid000000",   
    ],
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
* **`设备的离线`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "offline",
    "data": [
         "uuid123456",   //设备uuid
         "uuid000000",   
    ],
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
* **` 设备告警`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "alarm",
    "data": {
          "uuid000000"：{
               "doorState": 0：门关、1：门开     //门状态
               "lockState":  0：锁关、1：锁开    //锁状态
               "openTimeout": 0                 //开门超时
               "closeTimeout": 0                //关门超时
               "lowBattery": 0     	        //低电量告警
               "leftAjar":0                     //虚掩报警
               "motorStuck":0                   //电机堵转
          },
     },
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
> data参数说明：
> 是一个key-value格式，key表示设备的uuid，value是对应的告警事件，value参数规则如下：如果发生对应的告警事件即包含这个对应的告警字段，没发生就不要加这个字段。
> 
> 比如：发生了 低电量告警事件，value参数就包含 lowBattery字段，如果没有发生就不要包含了，同理其他字段也是这样规则

* **`删除设备`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "device_delete",
    "data": [
         "uuid123456",   //设备uuid
         "uuid000000",   
    ],
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
* **`人员移除`**

server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "person_delete",
    "data": [
        "userId":"12erx4retq"
    ],
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
* **`解散家庭`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "family_delete",
    "data": {
    },
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```

* **`通知提醒`**
server-> app

```
app/v1/cmd/{#familyId}
{   
    "serialNo": "6w8keif5g6",
    "familyId": "0a1b2c3d",
    "cmd": "notify_red_dot",
    "data": [
        "12erx4retq"
     ],
    "time":1647580466, 
    "sign":"e0k4jrir85tje8ru4jrur499r99ii4ur"
}
```
> 如果==data为空==就所有家庭成员都能看到这个提醒，如果==data不为空==，就只能指定成员可见