文件修改记录
| 版本 | 修改日期 | 修改描述 | 修改人员 |
| v1.1 | 2022-01-17 | 创建此文档 | lyon |
| v1.4 | 2022-06-30 | 增加通用接口 | lyon |
| v1.5 | 2022-09-14 | 增加了字体和显示时间参数 | lyon |
| V1.6 | 2023-02-13 | 增加了配置接口 | lyon |
目录
主题格式
| 发送主题格式 | ||
| 设备标识（不可修改） | 发送标识（不可修改） | 设备 ID(出厂固化) |
| “device/” | “TX/” | “xxxxxxxxxxxxxx” |
- 服务器用这个主题发送消息到设备。
- 设备订阅该主题来接收消息。例子:device/TX/46:FD:9E:67:86:8D
设备回复主题:
设备收到消息后，通过 serverTopic 主题回复。
遗嘱主题格式：
设备上线和掉线会向遗嘱主题发送遗嘱消息。
device/state/ + 设备ID
遗嘱消息格式：
{
“device_id”:“XXXXXX”,//设备 ID
“online”:1 //0 为掉线，1 为上线
}
消息格式
所有数据交互采用JSON 封装，请参考相关 JSON 格式规范文档。
服务端发送消息格式
| 名称 | 类型 | 可选项 | 功能描述 |
| biz_content | 不限定 | 可选 | 消息内容 |
| uuid | 字符串 | 必填 | 消息 uuid,客户端回复的 uuid 与接收的保持一致 |
| method | 字符串 | 必填 | 接口名称 |
| serverTopic | 字符串 | 必填 | 服务端接收主题，设备用这个主题回复 |
设备回复消息格式
| 名称 | 类型 | 可选项 | 功能描述 |
| biz_content | 不限定 | 可选 | 消息内容 |
| uuid | 字符串 | 必填 | 消息 uuid,设备端回复的 uuid 与接收的保持一致 |
| method | 字符串 | 必填 | 接口名称 |
| code | 整型 | 必填 | 返回 200 时，为成功。 |
业务接口
| 接口列表 | |
| 接口名称 | 功能描述 |
| uptate_park_space | 更新余位 |
| reset | 重启设备 |
| common | 通用接口 |
| config | 配置接口 |
更新余位信息- uptate_park_space
| 参数说明 | ||
| 参数名称 | 类型 | 功能 |
| area_list | 数组 | 余位分区列表，最大 8 个分区 |
| area_id | 整型 | 分区 ID,取值范围 0~7 |
| text | 字符串 | 显示内容 |
| font_index | 整型 | 字体索引,取值 0~11，见下表 |
| color_index | 整型 |
颜色索引，取值范围 0~6
对应：红、绿、蓝、黄、青、紫、白 |
发送例子:
{
“method”:”uptate_park_space”, “uuid”:”xxxxxxx”, “serverTopic”:”xxxxxxxx”, “biz_content”:{
“area_list”:[
{
“area_id”:0, “text”:”8888″,
“color_index”:0
},
{
“area_id”:1, “text”:”A 区:888″, “color_index”:0
},
{
“area_id”:2, “text”:”下层:888″,
“color_index”:0
}
]
}
}
回复例子:
{
“method”:”uptate_park_space”, “uuid”:”xxxxxxx”,
“code”:200
}
重启设备- reboot
无参数。发送例子:
{
“method”:”reboot”,
“uuid”:”xxxxxxx”, “serverTopic”:”xxxxxxxx”, “biz_content”:{
}
}
回复例子:
{
“method”:”reboot”,
“uuid”:”xxxxxxx”, “code”:200
}
通用接口- common
| 参数说明 | |||
| 参数名称 | 类型 | 功能 | |
| text_list | 数组 | 文本数组 | |
| line_id | 整型 | 行号,取值范围 0~7 | |
| text | 字符串 | 显示内容 | |
| color_index | 整型 |
颜色索引，取值范围 0~6
对应：红、绿、蓝、黄、青、紫、白 |
|
| font_index | 整型 | 字体索引,取值 0~11，见下表 | |
| Show_time | 整型 |
显示时间，单位秒，取值范围 5~255
255 为一直显示 |
|
| voice | 字符串 | 语音内容 | |
| rgl_time | 整型 |
红绿灯打开时间,单位为妙；
0 为亮红灯； 1~250 为亮绿灯的时间； 255 为一直亮绿灯 |
|
| font_index 取值含义 | |||
| 取值 | 描述 | ||
| 0 | 数字 6X16 | ||
| 1 | 字符 6×8 | ||
| 2 | 汉字 32X16 | ||
| 3 | 汉字 16X16 | ||
| 4 | 汉字 24X24 | ||
| 5 | 汉字 32X32 | ||
| 6 | 汉字 48X48 | ||
| 7 | 汉字 64X64 | ||
| 8 | 数字 16X16 | ||
| 9 | 数字 8X16 | ||
| 10 | 数字 16X32 | ||
| 11 | 数字 32X64 | ||
发送例子:
{
“method”: “common”,
“uuid”: “c1581038X”,
“serverTopic”: “xxxxxxxxx”, “biz_content”: {
“text_list”: [
{
“line_id”: 0,
“color_index”: 0,
“font_index”: 3,
“show_time”: 10, “text”: “粤 B12345”
},
{
“line_id”: 1,
“color_index”: 1,
“font_index”: 3,
“show_time”: 10, “text”: “欢迎光临”
}
],
“voice”: “粤 B12345,欢迎光临”, “rgl_time”: 5
}
}
回复例子:
{
“method”:”common”,
“uuid”:”c1581038″,
“code”:200
}
配置接口-config
| 参数说明 | ||
| 参数名称 | 类型 | 功能 |
| time | 字符串 | 更新时间格式:2023-02-13 16:00:00 |
| volume | 整型 | 音量 0~100 |
发送例子:
{
“method”:”config”, “uuid”:”1234567890″,
“serverTopic”:”xxxxxx”, “biz_content”:{
“time”:”2023-02-13 16:00:00″,
“volume”:100
}
}
回复例子:
{
“method”:”config”, “uuid”:”1234567890″,
“code”:200
}
本站收集的资源仅供内部学习研究软件设计思想和原理使用，学习研究后请自觉删除，请勿传播，因未及时删除所造成的任何后果责任自负。
如果用于其他用途，请购买正版支持作者，谢谢！若您认为「BLOG.SDLINKA.COM」发布的内容若侵犯到您的权益，请联系站长进行删除处理。
本站资源大多存储在云盘，如发现链接失效，请联系我们，我们会第一时间更新。
暂无评论内容