物联网智能视频服务(消费版) 设备端接入（视频流门锁）

一、1. 门锁摄像头扫码配网

·内容格式：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 设备侧解析完 wifi 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 和事件名称的对应关系，后续将持续拓展。

四、4. 消息上报

·设备端对接设备端 SDK：当事件发生时，设备端通过 iv_msg_send_notice（）传入通知 ID 到控制台后台，进行消息模板匹配，将通知参数传入小程序 {{time1.DATA}}
{{enum_string2.DATA}} 后，即可进行消息通知推送。

·通知类型：目前支持通知类型如下表，注意 ID 和通知的对应关系，后续将持续拓展。通知将显示在小程序设备详情页中，保存有效期30天。

注意：说明：

unlock_type 类型如下：

unknown_info_id 类型如下：

五、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 } ]}