NVR方案配置说明

更新时间：2024-11-20 08:51:28下载pdf

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

创建产品

在涂鸦开发者平台上，选择 创建产品 > 摄像机 > 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。其中第一字符串是总容量，第二个字符串是已使用的容量，第三个是剩余容量。
存储状态	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，流程如下：

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

设备消息推送设置

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

涂鸦开发者平台操作页面如下图所示：

NVR方案配置说明

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

OTA 升级设置

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

涂鸦开发者平台操作页面如下图所示：

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_PID 和 IPC_App_SUB_DEV_PID NVR 可替换成快速创建产品中 OEM 的 NVR 和通道设备 PID。
本 Demo 提供的参考 UUID 最多可激活 16 路通道设备。