人脸识别相机对人脸库进行增删改查——MQTT协议

备注
设备购买链接：

https://item.taobao.com/item.htm?id=610783570896

一、 MQTT 服务器安装
Windows mqtt 平台服务搭建
1、 安装 JAVA 环境
在https://www.java.com/zh_CN/ 网站下载安装
2、 下载MQTT 服务器软件
下 载 apache-apollo-1.7.1-windows 版 本 ，
从：http://archive.apache.org/dist/activemq/activemq-apollo/1.7.1/
3、 安装服务器软件
以管理员身份打开 cmd，进入解压后文件里的 bin 目录

执行 apollo create myapollo C:\apache-apollo\broker
执行完毕后，进入到 C:\apache-apollo\broker\bin 目录
执行 apollo-broker.cmd run
注意：下载后解压缩的apache-apollo-1.7.1-windows 目录不能有中文字符
成功后效果：

管理页面： http://127.0.0.1:61680
默认账号 admin，密码 password，
注意 这里网页的端口是 61680，但是 mqtt 服务的端口是 61613
二、 MQTT 客户端工具
下载mqttbox
http://workswithweb.com/html/mqttbox/downloads.html
下载windows 版本
安装后生成图标

打开软件，点击 Create MQTT Client

在打开的软件内输入 服务器的IP:端口，用户名，密码，协议选择 mqtt/tcp

点击 save
连接成功后

三、 设备配置操作
1、设备配置：
1、 打开客户端，在设备管理内添加设备到右边列表，
2、 在视频浏览内，图像上点右键，选远程设置

3、 选择中心平台接入配置：

2、订阅话题
设备认证识别结果发送至话题 mqtt/face/ID/Rec
设备陌生人抓拍结果发送至话题 mqtt/face/ID/Snap
设备相应消息发送至话题 mqtt/face/ID/Ack
（其中 ID 指本机 ID，例如 305266）。
输入要订阅的话题

订阅成功后会收到设备发送的推送消息

四、 数据传输
云平台（服务器）对人脸识别一体机设备发送的指令全部都是往人脸识别一体机
订阅的话题（mqtt/face/ID ，其中 ID 指本机 ID，例如 305266）里面发送，人 脸
识别一体机相应回复对应指令的操作结果都是往（mqtt/face/ID/Ack ，其中 ID 指
本机 ID，例如 305266）主题推送。
1、 增加和修改人员名单接口

示例：

{"operator":"EditPerson","info":{
"customId":"713BCEF6393955E0DC8822354D0D61E1",
"name":"美女",
"telnum1":"13800138000",
"gender":1,
"idCard":"400400199912120001",
"iccard":"1111221112",
"valid_time_type":0,
"start_time":0,
"expire_time":33333,
"department_name":"军委调查科",
"personType":0,
"notes":"张三",
"pic":"data:image/jpg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD/2w
BDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkS…(base64 image)"},
"messageId":"111222111666"}

注意：上推数据中，中文需要使用UTF8 进行编码，返回数据同样使用
UTF8 编码

返回的消息：

返回示例：

{"messageId":"111222111666","operator":"EditPerson-Ack",
"info":{"facesluiceId":"305266","personId":"0","customId":"713BCEF6393955E0DC8822354D0D61E1",
"result":"ok","detail":""}}

2、查询人员名单信息
2.1 查询设备中所有人员

输入示例：

{"operator":"QueryPerson","info":{},"messageId":"111222111333"}

返回的消息：

示例：

{"messageId":"111222111333","operator":"QueryPerson-Ack",
"info":{"facesluiceId":"305266","customId":"713BCEF6393955E0DC8822354D0D61E1,3281BA36B742
2275D0C654E90A84E4F9","result":"ok","detail":""}}

2.2 查询单个人员名单详细信息

示例：

{"operator":"SearchPerson","info":{"customId":"713BCEF6393955E0DC8822354D0D61E1"},"mes
sageId":"111222111333"}

返回的消息：

返回示例：

{"messageId":"111222111333","operator":"SearchPerson-Ack",
"info":{"facesluiceId":"305266","customId":"713BCEF6393955E0DC8822354D0D61E1",
"personId":"1","name":"张三丰","gender":"1","idCard":"","iccard":"3176838571",
"notes":"","valid_time_type":"0",
"start_time":"0","expire_time":"86399","personType":"0","telnum1":"","result":"ok","detail":""}}

3、删除单个人员名单

示例：

{"operator":"DelPerson","info":{"customId":"713BCEF6393955E0DC8822354D0D61E1"},"messageId":"
111222111555"}

返回：

返回示例：

{
"messageId":"111222111555","operator":"DelPerson-Ack","info":
{
"facesluiceId":"305266",
"customId":"713BCEF6393955E0DC8822354D0D61E1","result":"ok","detail":""

4、删除所有人员

示例：

{"operator":"DeleteAllPerson","messageId":"111222111555"}

返回：

返回示例：

{
"messageId":"111222111555","operator":"DeleteAllPerson -Ack","info":
{
"facesluiceId":"305266",
"result":"ok","detail":""
}
}

五、认证识别人员信息上传


六、陌生人人员信息上传

七、远程开门
远程开门指令由服务器端发送对应升级信息到人脸识别一体机，确认
信息由人脸识别一体机发送到服务器端。

示例：

{"operator":"Unlock","info":{"uid":"322234432243243"},"messageId":"111222111444"}

设备返回：


八、心跳
为了解决许多平台无法及时检测到人脸识别一体机与平台的联通情况，设备 主动增加心跳
信息，设备将连接MQTT 成功后，发送一次心跳消息，后续每间隔 30 秒左右推送心跳消息到主
题 mqtt/face/heartbeat 中：

示例：

{"operator":"HeartBeat","info":{"facesluiceId":"305266",”time”:”2020-01-21 12:12:10”,”index”:1}}

如果设备心跳重新从1 开始，表示设备掉电重启或设备第一次推送心跳消息