蓝牙锁打不开怎么办(蓝牙锁)

蓝牙锁

蓝牙锁

1.本地APP开锁（蓝牙锁的蓝牙直连通信）

1.1 概述

慧居仕是一款拥有完全自主知识产权的软硬件结合的门锁产品，通过手机 APP替代传统的钥匙实现开门。针对合作伙伴系统定制的需求，科技侠提供了开放平台 Open API 和 APP SDK。合作伙 伴可方便地在自己的应用系统和 APP中集成科技侠的各项功能。 本文档对 APP的集成开发进行说明。

1.2 应用架构

系统应用架构如下图所示。

APP借助SDK通过蓝牙与锁通信，实现锁的初始化、开锁、读取锁操作记录等； 建议APP不直接调用开放平台的Open API，由APP后台应用系统与Open API交互，并暴露相应的接口给APP。 应用系统通过慧居仕开放平台提供的 Open API 与平台实现用户绑定和授权，并进行门锁、电子钥匙以及键盘密码等的管理。

1.3 开发步骤

（1）注册开发者账号并创建应用，得到client_id和client_secret。 （2）APP里导入APP SDK开发包，调用其中的方法，并实现相应的回调方法。 （3）APP后台服务端应用系统通过Open API获取访问令牌。 （4）携带访问令牌，就可以调用Open API的锁、钥匙、密码相关接口，具体的请参考后续应用流程。

1.4 应用流程

系统涉及的主要流程包括：初始化门锁，电子钥匙开锁

1.4.1 绑定门锁

管理员使用APP实现对门锁的初始化设置，并通过应用系统将门锁信息传给开放平台。 应用系统可以对房间和门锁进行关联。

1.4.2 电子钥匙发放及开锁

应用系统向用户发送带有时效的电子钥匙。 用户使用APP从服务端同步获取钥匙，并进行开门。

2.远程APP开锁 (蓝牙锁的远程控制原理）

智能门锁本身不联网，只能通过蓝牙连接与外界通迅，网关是一个可以联网的小设备，使远程管理智能锁成为可能。

网关添加好后，会自动搜索其附近的锁，如果搜索到的锁和网关属于同一个管理员账号，网关服务器会保存网关和锁之间的连接关系，锁和网关是多对多的关系，允许一个网关连接多个锁，锁也可以连接多个网关，没有数量限制，后续用户想远程操作锁，系统会自动选择蓝牙连接信号强度最好的网关下发操作指令。

1、网关的初始化

开发者可以先使用科技侠APP添加网关，G2网关请参考说明文档：G2网关添加说明。也可以自己开发APP集成我们的APP SDK来实现网关的初始化，具体参考APP SDK网关接口示例，初始化网关时需要传用户主键ID和密码以标识网关归属的用户，其中的用户主键ID在获取访问令牌时会返回，也可以通过云端获取用户主键ID接口获取。

（1）APP SDK完成网关的初始化配置，如果配置的网络正确，网关会自动连接网关服务器，完成在云端的初始化。

（2）调用云端查询某网关是否初始化成功接口确认网关已经成功在云端完成初始化，初始化成功会返回gatewayId。

（3）调用云端上传网关信息接口上传网关的固件版本信息和网络名称，方便后续网关固件升级和维护。

网关添加成功后，可以通过获取名下网关列表接口查询到。

2、网关与锁的连接

不需要用户去手动关联。网关初始化完成即会自动搜索附近的锁，如果搜索到的锁和网关属于同一个管理员账号，就会自动关联上，所以请确保锁和网关是用同一个账号添加的。

可以通过获取网关管理的锁列表和获取锁连接的网关列表两个接口查询锁和网关之间的关联关系和信号强度。

当向锁发起远程操作时，系统会选择信号强度最好的网关下发操作指令。

3、连接网关后支持哪些远程操作？

锁连接上网关后，很多锁管理工作就不需要再到锁边上通过蓝牙连接来执行了，可以通过网关远程下发指令给锁，如开锁、闭锁，查询锁的开关状态，管理（增、删除、改）密码，管理IC卡，管理指纹，查询锁电量、查询和校准锁时间等。

锁连接上网关后，不再需要到锁边上去读取操作记录，开锁记录也会自动通过网关准实时（一般几秒钟内）的上传到云端，在科技侠APP上的锁管理员会收到开锁的推送消息，开放平台也支持将记录实时推送给开发者,参考文档：锁记录回调通知

4、远程操作耗时过长和失败的原因

通过网关执行远程操作，网关需要和锁之间建立蓝牙连接通讯，这个过程一般需要几秒钟时间，网关和锁之间的蓝牙连接信号强度越弱，耗时会越长，甚至有失败的可能性。通讯过程中蓝牙连接被打断（如触碰到面板等）也会导致耗时增加甚至操作失败。

网关远程操作请求时间可能会很长，云端设置的超时时间是30秒，建议开发者调用远程指令下发相关接口的请求也设置30秒的超时时间。有些开发者设置10秒超时，会有可能收不到请求反馈判定请求失败，但指令已经下发成功。

网关和锁同一时间都只能建立一个蓝牙连接，网关只能串行执行远程操作指令，如果网关当前正在执行远程操作，再用该网关发起远程操作则会直接返回失败。

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锁接口示例，设置好后调用云端修改锁设置项接口将设置同步到云端。

4.小程序开锁

小程序临时密码开锁原理是授时功能。这个非常关键,因为只有对码,只能设置开启一次，但无法在固定时间内开门的。

授时功能,这个逻辑其实也不复杂。双方各有一个时间,保证时间同步或者内置程序设置同步有校时卡或相应的功能,这样保证在密码对应上的时候,两者的时间是一致的,就可以了。