文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>物联网智能视频服务（消费版）>应用端接入手册>低代码小程序应用端接入手册>设备端接入（图片流门锁）

设备端接入（图片流门锁）

最近更新时间：2024-09-06 15:42:31

我的收藏

本页目录：

门锁摄像头扫码配网

设备侧需自行完成门锁摄像头扫码解析小程序二维码的功能，具体如下：
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 和密码后，自行完成联网操作。
3. 连接完成后调用 系统模块 iv_sys_init() 和 物模型模块 iv_dm_init() 初始化必要的功能模块。
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
    }
  ]
}

中国站
目录