117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
### mqtt 基础配置
|
||
|
||
| 配置项 | 内容 | 备注 |
|
||
| ---------- | ------------------------------------ | ---------------- |
|
||
| mqtt 服务器地址 | mqtt.aihang.cn:1883 | |
|
||
| username | ahmqtt | |
|
||
| 指令发送topic | /ah/uav/${deviceId}/command/ | deviceId 为无人机序列号 |
|
||
| 指令响应topic | /ah/uav/${deviceId}/commandResponse/ | deviceId 为无人机序列号 |
|
||
## 指令发送内容
|
||
|
||
| 字段名 | 字段值介绍 | 字段类型 | 是否必填 |
|
||
| ---------- | -------------------- | ------- | ------ |
|
||
| deviceId | 无人机序列号 | String | 是 |
|
||
| code | 指令code(参考指令集) | String | 是 |
|
||
| data | 数据体(参考指令集) | JSONObj | 否 |
|
||
| deviceType | 设备类型(无人机:uav) | String | 是 |
|
||
| sdkType | sdk类型 msdk | osdk) | String |
|
||
| time | 请求时间(ISO dateformat) | String | 否 |
|
||
### 请求示例：
|
||
|
||
```json
|
||
{
|
||
"code": "actionMount",
|
||
"data": {
|
||
"type": "MP",
|
||
"code": "shout",
|
||
"param": {
|
||
"conten": "无人机汉化内容",
|
||
"repeat": false,
|
||
"volume": 80,
|
||
"speed": 50,
|
||
"sex": 1
|
||
}
|
||
},
|
||
"sdkType": "msdk",
|
||
"deviceId": "1ZNDH8500B72MM",
|
||
"requestId": "04c1fbde-2123-48b5-a159-d469b978147d",
|
||
"time": 1667467817551
|
||
}
|
||
```
|
||
|
||
### 响应体：
|
||
|
||
| 字段名 | 字段值介绍 | 字段类型 | 是否都有值 |
|
||
| --------- | ------------------------------------ | ------- | ----------------------- |
|
||
| requestId | 请求ID(由服务端生成) | String | 否(是->code==0) |
|
||
| code | 请求结果(0成功,非0失败) | int | 是 |
|
||
| data | 响应数据 | JSONObj | 否(是->code==0&&是获取数据的请求) |
|
||
| msg | 备注信息(code==0,msg无用;code==1,msg为错误原因) | String | 是 |
|
||
| | | | |
|
||
|
||
### 响应示例：
|
||
|
||
```json
|
||
例1(请求成功无数据)
|
||
{
|
||
"requestId": "04c1fbde-2123-48b5-a159-d469b978147d",
|
||
"code": 0,
|
||
"msg": "",
|
||
"data": ""
|
||
}
|
||
例2(请求失败)
|
||
{
|
||
"requestId": "04c1fbde-2123-48b5-a159-d469b978147d",
|
||
"code": -1,
|
||
"msg": "",
|
||
"data": ""
|
||
}
|
||
```
|
||
|
||
# 指令集
|
||
|
||
\###操作挂载设备
|
||
|
||
code: actionMount
|
||
|
||
data: ↓
|
||
|
||
| 字段名 | 字段值介绍 | 字段类型 | 是否必填 |
|
||
| ------ | -------- | -------------- | ---- |
|
||
| type | 挂载设备类型 | String（喊话器:MP） | 是 |
|
||
| code | 挂载设备操作指令 | String | 是 |
|
||
| params | 挂载设备操作参数 | Obejct | 否 |
|
||
|
||
挂载设备类型：
|
||
|
||
```json
|
||
type（String）：MP 喊话器
|
||
```
|
||
|
||
挂载设备类型对应操作指令：
|
||
|
||
```
|
||
type = MP：
|
||
code1:shout 喊话
|
||
code2:stop 停止
|
||
```
|
||
|
||
```
|
||
code = shout
|
||
param: ↓
|
||
```
|
||
|
||
| 字段名 | 字段值介绍 | 字段类型 | 是否必填 |
|
||
| ------ | ----------------- | ------- | ---- |
|
||
| conten | 文字内容 | String | 是 |
|
||
| repeat | 是否重复喊话 | Boolean | 是 |
|
||
| volume | 声音大小，0-100(默认为50) | Integer | 是 |
|
||
| speed | 喊话语速，0-100(默认为50) | Integer | 是 |
|
||
| sex | 声音男女，0女1男(默认男) | Integer | 是 |
|
||
|
||
```
|
||
code = stop
|
||
param:null
|
||
```
|
||
|