NVR方案配置说明

更新时间:2022-07-14 02:50:42下载pdf

涂鸦 NVR 方案是在智能生活 App 视频功能基础上引入 NVR 一拖多路的产品特性,在 App 上实现批量激活 IPC 和多通道设备预览、管理等功能。

创建产品

涂鸦 IoT 开发平台上,选择 创建产品 > 摄像机 > NVR > 自定义方案,完善产品信息后产品创建完成,平台会自动生成 PID 信息。

创建产品的详细步骤,请参考 选品类创建产品

一般标准产品设备类型选 普通设备,包含网关模组/SDK 的设备选 网关设备

NVR方案配置说明

标准功能

此为涂鸦 NVR 方案提供的标准功能,开发者可根据产品的实际功能选择。功能开启后,对应的图标将展示在 App 操作页面和设备设置页面。

NVR方案配置说明

自定义功能

NVR 方案平台还提供了多路预览、硬盘存储、蜂鸣、远程重启等丰富自定义功能,需要开发者手动添加后才能展示。

NVR方案配置说明

多路预览

App 操作页面如下:

NVR方案配置说明

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
多路预览路数 ipc_multi_view 只上报(ro) 字符型(String) - 数据示意:{“4,9,16”},支持 4、9、16 路预览,App 根据 DP 点上报内容动态适配。

存储设置

App 操作页面如下:

NVR方案配置说明

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
支持的存储设备 supported_storage 可下发可上报(rw) 数值型(Value) {“min”:0,“max”:65535,“scale”:0,“step”:1,“type”:“value”} 位计算,1 表示检测到,0 表示未检测到。
  • bit0:表示SD卡。
  • bit1:表示HDD1
  • bit2:表示 HDD2
  • bit3:表示 HDD3
  • bit15:表示 HDD15
当前存储设备 current_storage 可下发可上报(rw) 数值型(Value) {“min”:0,“max”:65535,“scale”:0,“step”:1,“type”:“value”} 位计算,1 表示启用,0 表示关闭。
  • bit0:表示 SD 卡。
  • bit1:表示 HDD1
  • bit2:表示 HDD2
  • bit3:表示 HDD3
  • bit15:表示 HDD15
获取存储容量 storage_capacity 只上报(ro) 字符型(String) {“type”:“string”,“maxlen”:255} 单位改为 kb。 NVR方案配置说明其中第一字符串是总容量,第二个字符串是已使用的容量,第三个是剩余容量。
存储状态 storage_status 可下发可上报(rw) 数值型(Value) {“min”:1,“max”:5,“scale”:0,“step”:1,“type”:“value”} status:存储模块状态。
  • 1:正常
  • 2:异常
  • 3:空间不足
  • 4:正在格式化
  • 5:无 SD 卡。
存储格式化 storage_format 可下发可上报(rw) 布尔型(Bool) {“type”:“bool”} 下发 true,设备执行格式化动作。
存储格式化状态 storage_format_status 可下发可上报(rw) 数值型(Value) {“min”:-2000,“max”:2000,“scale”:0,“step”:1,“type”:“value”} 返回错误码。
  • -2000:存储模块正在格式化。
  • -2001:存储模块格式化异常。
  • -2002:无存储模块。
  • -2003:存储模块错误。
  • 正数为格式化进度。
卸载存储设备 storage_umount 可下发可上报(rw) 布尔型(Bool) {“type”:“bool”} true:卸载存储设备。

存储模块识别状态发生改变或者云端下发 DP 指令查询/控制存储模块时,开发者需将相关的 DP 状态上报。

举例一

当设备识别到新存储模块接入时,按实际情况上报 支持存储的设备当前存储设备存储状态获取存储容量

举例二

App 上轻按 存储设置,设备收到 存储状态 为 NULL 的查询指令后,按实际情况上报当前存储模块的 存储状态获取存储容量

蜂鸣器

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
警笛 siren_switch 可下发可上报(rw) 布尔型(Bool) - -

App 操作页面如下:

NVR方案配置说明

远程重启

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
重启设备 device_restart 可下发可上报(rw) 布尔型(Bool) - -

App 操作页面如下:

NVR方案配置说明

IPC 子设备配置说明

NVR 通道设备为通用 IPC 功能,创建过程参考 IPC 基础产品方案配置说明。以下为 NVR 产品特色功能,DP 功能点配置需在子设备 PID 上配置。

视频、图片拉伸

App 操作页面如下:

NVR方案配置说明

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
视频拉伸 ipc_res_change 只上报(ro) 字符型(String) - 数据示意:{“video”:[{“restype”:“4”,“oldres”:“9441080",“newres”:“19201080"},{“restype”:“2”,“oldres”:“9441080"“newres”:"19201080”}],“message”:“1920*1080”}
格式说明:
  • restype:码流类型,4 为高清,2 为标清。目前这个设备只有高清视频流会压缩。
  • oldres:拉伸前的源分辨率。
  • newres:需要拉伸的期望分辨率。
  • message: 侦测消息中携带的多媒体文件的拉伸期望清晰度,包括图片和视频。

录像计划设置

App 操作页面如下:

NVR方案配置说明

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
录像开关 record_switch 可下发可上报(rw) 布尔型(Bool) - -
录像模式 record_mode 可下发可上报(rw) 枚举型(Enum) 枚举值: 1, 2, 3
  • 1:事件录像
  • 2:连续录像
  • 3:定时录像
定时录像设置 record_timing_set 可下发可上报(rw) 字符型(String) - 由 8 个无符号整数(十进制)组成的数组 json 字符串从左到右分别为周日、周一、周二……周六每一组有 24 个数字,代表 00:00-01:00、01:00-02:00……23:00-24:00 每个小时的录像配置,其中 0 代表无录像、1 代表普通录像、2 代表事件录像,3-9 预留以后扩展使用。{001122222222222111111111,001122222222222111111111,
001122222222222111111111,001122222222222111111111,
001122222222222111111111,001122222222222111111111,
001122222222222111111111}

本地录像检索

App 操作页面如下:

NVR方案配置说明

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
事件类型检索 recoding_event_list 只上报(ro) 字符型(String) - 格式{1,2,5,7,12}。每个数字代表一种事件类型,此外还需设备对接 SDK 回放事件协议相关 API。

事件说明:

数值 事件类型 数值 事件类型
0 移动侦测 9 人形检测
1 门铃 10 宠物检测
2 设备联动 11 车辆检测
3 有人经过 12 婴儿哭声
4 有人徘徊 13 异响
5 门铃消息留言 14 检测到人脸
6 门铃已接听 15 强拆报警
7 门铃未接听 16 摄像头接入 IO 设备告警
8 门铃拒接 17 低电告警

子设备能力动态适配

适用场景说明:

NVR 接入的前端设备品类众多,功能上存在差异,如前端接入卡片机和摇头机。卡片机设备面板不显示云台控制功能,摇头机设备面板显示云台控制功能。因此需要引入子设备能力上报,App 根据上报的能力值动态显示子设备功能。

DP 点定义如下:

功能点名称 标识符 数据传输类型 数据类型 功能点属性 备注
子设备能力上报 sub_dp_report 只上报(ro) 字符型(String) - 数据示意:[4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295,4294967295]。从右往左数,序号从 1 开始,每一位的序号代表 DP ID,每一位上 1 代表此 DP ID 支持,0 代表不支持。8 个无符号整数最多可以标识 DP ID 1-256 的支持情况,App 根据子设备上报能力来动态显示功能。

硬件开发

NVR 方案需要开发者自行实现硬件设计,软件上嵌入涂鸦 XVR SDK,流程如下:

  1. 下载 XVR SDK。若平台没有对应工具链的下载,请联系涂鸦项目经理提供。
  2. 按照 XVR SDK 开发手册进行对接,手册联系涂鸦项目经理提供。

设备消息推送设置

设备消息推送是产品的告知提醒,您可以自定义产品的告警条件,实时监控产品状态。运行产品时,如果某项功能的值超出常规状态,或者您需要通知用户某些实时信息时,即可第一时间将消息触达用户,保障产品正常运行。

涂鸦 IoT 开发平台操作页面如下图所示:

NVR方案配置说明

  • 开发者账号须为企业版或旗舰版,才能支持配置设备消息推送。
  • NVR 和 IPC 子设备消息推送需要分开配置。

OTA 升级设置

平台提供固件升级功能,开发者需先将升级固件文件上传至涂鸦服务器,之后 SDK 对接 OTA 功能接收升级包并写入本地闪存,最终实现固件 OTA 升级。详细操作方法,请参考 场景2:升级自定义上传的固件

涂鸦 IoT 开发平台操作页面如下图所示:

NVR方案配置说明

NVR 和通道设备的 OTA 需要在各自的 PID 下维护。

快速创建产品

访问以下 OEM PID 链接,可快速在您的 IoT 账号下复制示例 PID 的配置。

虚拟设备调试

下载 XVR SDK 并运行 Demo。

Demo 设备参数参考:

#define IPC_App_PID " 6q4d0m7odkazdqrt" 
#define IPC_App_UUID "zy00fac576ee7586ac6b" 
#define IPC_App_AUTHKEY "wm1TZ4M9xKM2kO4xYhLc22cX3yBI7eAF" 
#define IPC_App_SUB_DEV_PID " qxqduhvs1x7brlc9"
  • IPC_App_PIDIPC_App_SUB_DEV_PID NVR 可替换成快速创建产品中 OEM 的 NVR 和通道设备 PID。
  • 本 Demo 提供的参考 UUID 最多可激活 16 路通道设备。