WiFi锁对接指南

WiFi锁可以直连WiFi,不再需要网关设备中转就可以直接联网,联网后的支持的功能和连接了网关的锁基本相同,接口调用方式和传参不变。

1、WiFi锁的初始化

开发者可以先使用科技侠APP添加和配置WiFi锁。

也可以自己开发APP集成我们的APP SDK来实现WiFi锁的初始化,具体参考APP SDK锁接口示例

(1)APP SDK完成WiFi锁的初始化配置,如果配置的网络正确,锁会自动连接服务器,完成在云端的初始化。

(3)调用云端WiFi锁更新网络信息接口上传上传连接网络信息到云端,方便后续查看和维护。

WiFi锁配置成功后,联网信息可以通过获取Wifi锁信息接口查询到。

2、关于WiFi锁的省电模式

WiFi锁默认关闭省电模式,与服务器维持长连接,云端可以实时向锁下发指令,但比较耗电。

开启省电模式后,WiFi锁只有在有开锁记录需要上报时才会连接服务器,这样会更省电,但将不再支持云端主动向锁发起指令,比如调用云端远程开锁接口,将返回错误码-3035,提示WiFi锁处于省电模式。

开发者可以集成我们的APP SDK来设置WiFi锁省电模式开关,具体参考APP SDK锁接口示例,设置好后调用云端修改锁设置项接口将设置同步到云端。

3、关于WiFi唤醒异步下发指令

当WiFi锁处于休眠模式时,允许用户异步发起远程操作请求,请求将被放到缓存队列里,当WiFi锁唤醒连上服务器时下发。

比如,当WiFi锁处于休眠模式时采用异步下发指令的方式添加自定义密码(addType传4),请求会立即成功,返回相应的密码ID,但该密码的状态为"添加中",还未添加到锁里。

当WiFi锁唤醒重新连上服务器时,服务器将缓存的指令下发,如果密码添加成功,相应的密码状态变为”正常“,添加失败则状态变为”添加失败“,当添加失败时,如果应用有配置回调通知地址,会通过回调地址通知第三方应用系统。