设备端接入(视频流门锁)

最近更新时间:2024-04-25 18:14:31

我的收藏

1. 门锁摄像头扫码配网

设备侧需自行完成门锁摄像头扫码解析小程序二维码的功能,具体如下:
1.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" }
1.2 设备侧解析完 Wi-Fi ssid 和密码后,自行完成联网操作。
1.3 连接完成后调用 系统模块 iv_sys_init() 和 物模型模块 iv_dm_init() 初始化必要的功能模块。
1.4 在确认初始化接口返回成功且确保设备上线后,调用 iv_ad_send_bind_info() 配网接口,上报上述配网 token。
1.5 上报成功后,刷新小程序主页面即可看到刚添加的设备。

2. 语音对讲

设备对接协议:设备到小程序上行仅支持 AAC,小程序到设备下行支持 AAC 16K 采样率或者设置任意采样率的 PCM,但下行 PCM 不支持小程序回音消除,推荐使用 AAC 16K。
采样率:为了有更好的延时效果,设备到小程序的 AAC 格式请设置为 8K 采样率以上。

3. 云存回放

购买云存储,需要通过 云 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

4. 消息上报

设备端对接设备端 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。unlock_type 有以下几种:
unlock_type
通知
1
密码开门
2
人脸开门
3
指纹开门
4
卡片开门
5
门内开锁
6
APP蓝牙开门
7
指纹+密码开锁
8
人脸+指纹开锁
9
人脸+密码开锁
设备端通过 iv_msg_send_notice(notice_id:12,ext:{unknown_info_id: xx})上报消息。不传入 unknown_info_id,消息显示为“未知情况”;传入 unknown_info_id,消息显示 id 对应的消息通知。unknown_info_id 有以下几种:
unknown_info_id
通知
1
锁舌无法伸出告警
2
锁舌无法收回告警
3
防遮挡告警
4
布防告警
5
假期模式关闭告警
6
假锁告警


5. 落锁状态

设备端对接设备端 SDK,通过 mqtt 消息上报“落锁状态”属性物模型,同步门锁开关信息。




6. 远程解锁

设备端对接设备端 SDK,通过 SDK 接收到服务器下发的远程解锁行为物模型,接收解锁行为通知后,开锁指令下发成功,待小程序获取到落锁状态物模型由“已落锁”转为“未落锁”,则说明锁已开,提示用户“开锁成功”。



7. 电池电量信息上报

设备端对接设备端 SDK,通过上报“电池电量”属性物模型,同步门锁电量信息。



8. 临时密码解锁

原理:RFC4226
perio:密码有效期间隔,30 秒一个。
将设备 PSK 密钥按照 base64 解码后得到原始二进制,得到 secret。
将时间戳除以 period,向下取整,得到 counter。
对 counter 计算 sha1。
将 sha1 使用 dynamic truncation 计算为6位数字。
设备端需自行实现 RFC4226 算法, 设备端在用户输入临时密码时,获取输入密码对应的时间戳后,通过 RFC4226 算法生成密码,并与输入密码进行逐一比对,至对比成功则可正常开锁。
注意:
当门锁状态显示已开锁时,临时密码不可使用。

9. 主动唤醒

实现流程如下:
1.1 小程序获取唤醒状态物模型的值为0,即休眠状态,则会下发唤醒门锁行为。




1.2 设备 Wi-Fi 收到唤醒命令,唤醒主控。待主控启动,调用 IoT Video SDK,待初始化成功后,设备 Wi-Fi 上报唤醒状态为“唤醒状态”。
1.3 小程序获取唤醒状态为“唤醒状态”时,出图显示门锁实况。

10. 相关物模型

所需的物模型需要在控制台 > 物模型 页面进行操作,主要包括需要导入的相关物模型和添加的必选标准功能的物模型,同时也支持添加自定义功能的物模型。


导入相关物模型:
{
"version": "1.0",
"profile": {
"ProductId": "OSO00VC9U8",
"CategoryId": "595"
},
"properties": [
{
"id": "sensitivity",
"name": "灵敏度",
"desc": "人体移动监测灵敏度",
"mode": "rw",
"define": {
"type": "enum",
"mapping": {
"0": "低",
"1": "中",
"2": "高"
}
},
"required": false
},
{
"id": "battery_percentage",
"name": "电池电量",
"desc": "-1表示未获取到电量",
"mode": "rw",
"define": {
"type": "int",
"min": "-1",
"max": "100",
"start": "0",
"step": "1",
"unit": "百分比"
},
"required": false
},
{
"id": "volume",
"name": "音量",
"desc": "",
"mode": "rw",
"define": {
"type": "enum",
"mapping": {
"0": "静音",
"1": "低",
"2": "中",
"3": "高"
}
},
"required": false
},
{
"id": "wakeup_state",
"name": "唤醒状态",
"desc": "设备主动上报是否处于唤醒状态",
"mode": "r",
"define": {
"type": "bool",
"mapping": {
"0": "休眠状态",
"1": "唤醒状态"
}
},
"required": false
},
{
"id": "faces",
"name": "面容",
"desc": "",
"mode": "rw",
"define": {
"arrayInfo": {
"type": "struct",
"specs": [
{
"id": "id",
"name": "id",
"dataType": {
"type": "string",
"min": "0",
"max": "100"
}
},
{
"id": "face_name",
"name": "face_name",
"dataType": {
"type": "string",
"min": "0",
"max": "20"
}
}
]
},
"type": "array"
},
"required": false
},
{
"id": "cards",
"name": "卡片",
"desc": "",
"mode": "rw",
"define": {
"arrayInfo": {
"type": "struct",
"specs": [
{
"id": "id",
"name": "id",
"dataType": {
"type": "string",
"min": "0",
"max": "100"
}
},
{
"id": "card_name",
"name": "card_name",
"dataType": {
"type": "string",
"min": "0",
"max": "20"
}
}
]
},
"type": "array"
},
"required": false
},
{
"id": "passwords",
"name": "密码",
"desc": "",
"mode": "rw",
"define": {
"arrayInfo": {
"type": "struct",
"specs": [
{
"id": "id",
"name": "id",
"dataType": {
"type": "string",
"min": "0",
"max": "100"
}
},
{
"id": "password_name",
"name": "password_name",
"dataType": {
"type": "string",
"min": "0",
"max": "20"
}
}
]
},
"type": "array"
},
"required": false
},
{
"id": "fingerprints",
"name": "指纹",
"desc": "",
"mode": "rw",
"define": {
"arrayInfo": {
"type": "struct",
"specs": [
{
"id": "id",
"name": "id",
"dataType": {
"type": "string",
"min": "0",
"max": "100"
}
},
{
"id": "fingerprints_name",
"name": "fingerprints_name",
"dataType": {
"type": "string",
"min": "0",
"max": "20"
}
}
]
},
"type": "array"
},
"required": false
},
{
"id": "lock_motor_state",
"name": "落锁状态",
"desc": "",
"mode": "r",
"define": {
"type": "bool",
"mapping": {
"0": "未落锁",
"1": "已落锁"
}
},
"required": false
},
{
"id": "child_lock_state",
"name": "童锁状态",
"desc": "",
"mode": "rw",
"define": {
"type": "bool",
"mapping": {
"0": "关闭",
"1": "开启"
}
},
"required": false
},
{
"id": "disarming",
"name": "布防模式",
"desc": "",
"mode": "rw",
"define": {
"type": "bool",
"mapping": {
"0": "关闭",
"1": "开启"
}
},
"required": false
},
{
"id": "inner_lock_state",
"name": "反锁状态",
"desc": "",
"mode": "rw",
"define": {
"type": "bool",
"mapping": {
"0": "关闭",
"1": "开启"
}
},
"required": false
},
{
"id": "user_list",
"name": "绑定终端用户列表",
"desc": "",
"mode": "rw",
"define": {
"type": "struct",
"specs": [
{
"id": "owner",
"name": "主人",
"dataType": {
"type": "string",
"min": "0",
"max": "2048"
}
},
{
"id": "shared_person",
"name": "被分享者",
"dataType": {
"type": "array",
"arrayInfo": {
"type": "string",
"min": "0",
"max": "2048"
}
}
}
]
},
"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
}
],
"events": [],
"actions": [
{
"id": "wake_up",
"name": "唤醒门锁",
"desc": "",
"input": [],
"output": [
{
"id": "wakeup_state",
"name": "唤醒状态",
"define": {
"type": "bool",
"mapping": {
"0": "未唤醒",
"1": "已成功唤醒"
}
}
}
],
"required": false
},
{
"id": "unlock_remote",
"name": "远程解锁",
"desc": "",
"input": [],
"output": [
{
"id": "result",
"name": "开锁成功状态",
"define": {
"type": "bool",
"mapping": {
"0": "开锁失败",
"1": "开锁成功"
}
}
}
],
"required": false
}
]
}