门锁摄像头扫码配网
设备侧需自行完成门锁摄像头扫码解析小程序二维码的功能,具体如下:
1. 启动小程序,选择手动添加设备,确认设备重置后,选择家庭 Wi-Fi 并输入密码,则可使用摄像头扫描小程序生成的配网二维码,其中二维码解析后的格式如下:
内容格式:len str len str len str。其中 len:2个字符,代表紧随内容 utf-8 解码的长度,str 顺序:ssid、password、token。
示例:
以 Tencent-wifi,密码为 l,token 为 v3_00d……为例,设备侧需要解析的字符串为:
其对应的3个字段如下:
{ "SSID": "Tencent-wifi","password": "l","token": "v3_00d02b0248546d5a5fbf95a5812e4" }
2. 设备侧解析完 wifi ssid 和密码后,自行完成联网操作。
4. 在确认初始化接口返回成功且确保设备上线后,调用 iv_ad_send_bind_info() 配网接口,上报上述配网 token。
5. 上报成功后,刷新小程序主页面即可看到刚添加的设备。
语音对讲
设备对接协议:设备到小程序上行仅支持 AAC,小程序到设备下行支持 AAC 16K 采样率或者设置任意采样率的 PCM,但下行 PCM 不支持小程序回音消除,推荐使用 AAC 16K。
采样率:为了有更好的延时效果,设备到小程序的 AAC 格式请设置为 8K 采样率以上。
云存回放
购买云存储,需要通过 云 API 后台操作,为设备配置云存储套餐。
设备端对接设备端 SDK,某一个事件发生时,通过事件上报接口 iv_cs_event_start() 或者 iv_cs_event_directly_report() 向控制台后台传入事件 ID、图片,并根据回调进行音视频流推送。
事件类型:目前支持事件类型见下表,注意 ID 和事件名称的对应关系,后续将持续拓展。
事件类型 | 事件 ID |
有人按门铃 | event ID = 3 |
撬锁告警 | event ID = 4 |
密码/指纹错误冻结告警 | event ID = 5 |
胁迫告警 | event ID = 6 |
徘徊告警 | event ID = 7 |
开门通知 | event ID = 8 |
关门通知 | event ID = 9 |
指纹禁试告警 | event ID = 10 |
密码禁试告警 | event ID = 11 |
卡片禁试告警 | event ID = 12 |
人脸禁试告警 | event ID = 13 |
逗留侦测 | event ID = 14 |
系统禁试告警 | event ID = 15 |
假锁告警 | event ID = 16 |
防遮挡告警 | event ID = 17 |
消息上报
设备端对接设备端 SDK:当事件发生时,设备端通过 iv_msg_send_notice()传入通知 ID 到控制台后台,进行消息模板匹配,将通知参数传入小程序 {{time1.DATA}}
{{enum_string2.DATA}} 后,即可进行消息通知推送。
通知类型:目前支持通知类型见下表,注意 ID 和通知的对应关系,后续将持续拓展。通知将显示在小程序设备详情页中,保存有效期30天。
通知类型 | 通知 ID |
开门通知 | notice ID = 1 |
关门通知 | notice ID = 2 |
忘拔钥匙 | notice ID = 3 |
反锁 | notice ID = 4 |
低电量告警 | notice ID = 5 |
有人按门铃 | notice ID = 6 |
钥匙开门 | notice ID = 7 |
临时密码开门 | notice ID = 8 |
门未关提醒 | notice ID = 9 |
未上锁提醒 | notice ID = 10 |
门虚掩提醒 | notice ID = 11 |
未知情况 | notice ID = 12 |
说明:
设备端通过 iv_msg_send_notice(notice_id:1,ext:{unlock_type: xx})上报开门通知。不传入 unlock_type,消息显示为“开门通知”;传入unlock_type,消息显示对应的 unlock_type。
设备端通过 iv_msg_send_notice(notice_id:12,ext:{unknown_info_id: xx})上报消息。不传入 unknown_info_id,消息显示为“未知情况”;传入unknown_info_id,消息显示 id 对应的消息通知。
unlock_type 有下表几种:
unlock_type | 通知 |
1 | 密码开门 |
2 | 人脸开门 |
3 | 指纹开门 |
4 | 卡片开门 |
5 | 门内开锁 |
6 | App 蓝牙开门 |
7 | 指纹+密码开锁 |
8 | 人脸+指纹开锁 |
9 | 人脸+密码开锁 |
unknown_info_id 有下表几种:
unknown_info_id | 通知 |
1 | 锁舌无法伸出告警 |
2 | 锁舌无法收回告警 |
3 | 防遮挡告警 |
4 | 布防告警 |
5 | 假期模式关闭告警 |
6 | 假锁告警 |
落锁状态
设备端对接设备端 SDK,通过 mqtt 消息上报“落锁状态”属性物模型,同步门锁开关信息。
物模型模块介绍
远程解锁
设备端对接设备端 SDK,通过 SDK 接收到服务器下发的远程解锁行为物模型,接收解锁行为通知后,开锁指令下发成功,待小程序获取到落锁状态物模型由“已落锁”转为“未落锁”,则说明锁已开,提示用户“开锁成功”。
电池电量信息上报
设备端对接设备端 SDK,通过上报“电池电量”属性物模型,同步门锁电量信息。
临时密码解锁
原理:RFC4226
perio:密码有效期间隔,30 秒一个。
将设备 PSK 密钥按照 base64 解码后得到原始二进制,得到 secret。
将时间戳除以 period,向下取整,得到 counter。
对 counter 计算 sha1。
将 sha1 使用 dynamic truncation 计算为6位数字。
设备端需自行实现 RFC4226 算法,设备端在用户输入临时密码时,获取输入密码对应的时间戳后,通过 RFC4226 算法生成密码,并与输入密码进行逐一比对,至对比成功则可正常开锁。
注意:
当门锁状态显示已开锁时,临时密码不可使用。
相关物模型
所需的物模型需要在控制台的物模型页面进行操作,主要包括需要导入的相关物模型和添加的必选标准功能的物模型,同时也支持添加自定义功能的物模型。
导入相关物模型:
{"version": "1.0","profile": {"ProductId": "OSO00VC9U8","CategoryId": "595"},"properties": [{"id": "battery_percentage","name": "电池电量","desc": "-1表示未获取到电量","mode": "rw","define": {"type": "int","min": "-1","max": "100","start": "0","step": "1","unit": "百分比"},"required": false},{"id": "lock_state","name": "门锁状态","desc": "","mode": "rw","define": {"type": "enum","mapping": {"0": "未落锁","1": "已落锁","3": "门锁异常"}},"required": false},{"id": "_sys_xp2p_info","name": "xp2p信息","desc": "","mode": "rw","define": {"type": "string","min": "0","max": "64"},"required": false},{"id": "_sys_cs_days","name": "云存全时天数","desc": "","mode": "rw","define": {"type": "int","min": "0","max": "100","start": "0","step": "1","unit": ""},"required": false},{"id": "_sys_cs_status","name": "云存开关","desc": "","mode": "rw","define": {"type": "bool","mapping": {"0": "关","1": "开"}},"required": false},{"id": "_sys_cs_type","name": "云存类型","desc": "","mode": "rw","define": {"type": "enum","mapping": {"1": "全时","2": "事件"}},"required": false},{"id": "_sys_ai_status","name": "AI开关","desc": "","mode": "rw","define": {"type": "bool","mapping": {"0": "关","1": "开"}},"required": false},{"id": "mjpg_info","name": "图片流标识","desc": "","mode": "rw","define": {"type": "struct","specs": []},"required": false}],"events": [],"actions": [{"id": "unlock_remote","name": "远程解锁","desc": "","input": [],"output": [{"id": "result","name": "开锁成功状态","define": {"type": "bool","mapping": {"0": "开锁失败","1": "开锁成功"}}}],"required": false}]}