HTLock MQTT接入指南

MQTT是一个安全级别很高的接入方式,这个接入可以让客户的信息进行安全的传输,但是这种接入方式会比较困难,最少需要用到两台电脑或两台服务器进行部署HTLock系统和EMQX服务,这两个服务是必须要分开放的,具体如何接入可以看MQTT对接流程

注意:MQTT通常都会有DESKEY进行加解密数据的,如要不加密传输可以去666后台设置那边把DESKEY关闭即可。

发布:/localhost_hotel/酒店AppId/dev_pub 订阅:/localhost_hotel/酒店AppId/dev_sub 例子: /localhost_hotel/b5d0769c550d4f6699c8ecbd668f8132/dev_pub /localhost_hotel/b5d0769c550d4f6699c8ecbd668f8132/dev_sub

MQTT因为跟HTTP的对接方式有点区别,MQTT只需要把需要收到订阅的服务器连接到EMQX服务上并且订阅了HTLock的消息,就会收到订阅。

远程操作是指门锁关联了网关的情况下,对门锁进行的操作。具体功能如下: 自定义下发密码 自定义下发卡片 离线密码 房间入住列表 入住详情 远程开锁 待处理列表 手机授权 续住 周期常开设置 获取周期常开信息 设置门锁系统参数 读取门锁系统参数和状态

HTLock MQTT对接支持两种方式删除授权,一种是只对单个入住进行退房的删除单个授权。 还有一种是房间退房,该接口可以把一个房间里面的所有授权都退房处理,也可以对离线卡片的授权进行退房操作。

HTLock MQTT是支持对授权进行续住操作的,续住只需要调续住接口即可。

下发的授权是在HTLock是支持冻结/解冻的,只需要调入住冻结/解冻接口即可。

在房间关联网关的情况下,可以对房间进行封房/解封的操作,已经封房的房间是无法进行下发授权等操作的,只能解封后才能下发。

找不到宾客卡的情况下,可以通过制作挂失卡让丢失的宾客卡进行挂失处理,调挂失卡片接口即可。

当门锁下发失败的时候可以通过看待处理列表进行确认哪个授权是下发失败的,然后调重新下发待处理接口。 如若是想下发新授权,不想对待处理列表的授权进行处理的话,可以调忽略待处理入住接口。

首先需要把发卡器指纹采集仪添加到该HTLock下。 然后通过发卡器MAC调发卡器录入指纹模式接口,然后方手指上去进行按压。 按压过程中可以通过订阅发卡器按压指纹推送查看按压次数和相关推送。 在推送中拿到指纹标识或指纹特征值给到指纹下发接口进行下发,订阅后即可收到成功下发指纹推送。 注意:发卡器按压指纹的时候只有最后一包才会有指纹标识和指纹特征值推送。

把需要下发的人脸转换成baes64编码,然后调我们的图片处理接口对编码进行处理。 拿到图片处理返回的baes64编码后调下发人脸接口进行下发,订阅后能看到下发结果。

二维码授权是只有个别门锁才支持的功能,调二维码授权接口成功后会返回baes64编码,把编码转换成图片后扫二维码即可开门。

MQTT对接是支持对HTLock的房源进行操作的。具体功能如下: 楼栋列表 房间列表 房间类型列表 添加楼栋 修改楼栋 删除楼栋 添加房间 修改房间 删除房间 添加房间类型 修改房间类型 删除房间类型 房间电量 房间网关信号

想要一张卡开HTLock所有的门锁可以通过制作总卡接口制作出来,该卡片可以开HTLock下所有的房间。 楼栋卡是对指定楼栋制作一张开门的卡,该卡片可以开指定楼栋的所有房间,可通过制作楼栋卡接口完成。 楼层卡是对指定楼栋楼层制作一张开门卡,该卡片可以对指定的楼栋楼层进行开锁的卡片,可通过制作楼层卡接口完成。

查看房间操作日志可以通过房间日志列表进行查询。 HTLock事件推送会通过事件推送接口进行推送。