附录C.1 【园区版】海康安防设备接入-Rev1.2-20201130

修改记录及版本信息

1 海康支持对接的型号说明

2 应用服务平台创建产品和设备

在安装部署视频监控安防设备前，请确保项目的边缘集群已经部署了Link Visual 边缘视频组件。可以集群管理里查看，如下图所示：

2.1 创建AIBOX网关产品和设备

Link Visual 边缘视频组件，支持多实例。目前已经支持3个实例。每个实例可最多接入256个安防摄像头设备。每个实例有不同的远程服务操作入口。针对3个实例，需要重复2.1.2节和2.1.3节的操作，创建三个AIBOX网关设备。这三个AIBOX设备，将在后面的4.2.3.1(AIBOX设备上云)将用到。

2.1.1 创建AIBOX网关产品

登录物联网平台，点击公共实例，如下图所示：

点击“设备管理 - 产品 - 创建产品”，如下图所示。

产品名称：输入规则：功能+品牌。例如：AIBOX-海康

所属品类：请选择“标准品类：边缘计算/摄像头边缘节点”

节点类型：请选择“网关设备”，如下图所示

连接方式：请选择 " wifi"

数据格式：请选择 " ICA标准数据格式 "

2.1.2 创建AIBOX网关设备

点击“设备管理 - 设备 - 添加设备”，如下图所示。

产品：选择之前在1.1.1流程中创建的AIBOX产品: AIBOX-海康。

DeviceName: 根据甲方给出的规则定义产品名称。建议输入规则：品牌+功能+设备编号。例如：HaiKang-AIBOX-001

备注名称：用户自定义，例如海康AIBOX

2.1.3 查看AIBOX网关设备三元组

查看AIBOX网关三元组方式：在“设备管理-设备”中，找到刚才创建的AIBOX设备，点击查看，如下图所示。

ProductKey、DeviceName、DeviceSecret三个数据即为设备唯一标识，本篇文档中统称为设备三元组，如下图所示。

2.2 创建摄像头产品和设备

2.2.1 创建摄像头产品

说明：如果该账号下已经创建了摄像头产品，请忽略此步骤。

点击“设备管理 - 产品 - 创建产品”，如下图所示。

产品名称： 输入规则：品牌+功能。例如：海康-标准安防摄像头

所属品类：请选择“标准品类：智能生活/家居安防/摄像头”

节点类型：请选择“直连设备”，如下图所示。

2.2.2 无NVR接入摄像头和有NVR接入摄像头类型

摄像头设备分两类，一类是直连AIBOX的摄像头设备，我们定义为无NVR接入摄像头。另外一类摄像头接入到NVR摄像头，然后NVR摄像头再连接AIBOX，我们定义为有NVR接入摄像头。

如何区分有NVR接入摄像头和无NVR接入摄像头：请参照甲方提供的<IoT设备信息表>，在安防-摄像头 TAB页，如果下面红框里与NVR相关的列里有内容，则属于有NVR接入摄像头，否则属于无NVR接入摄像头

2.2.3 创建摄像头设备

点击“设备管理 - 设备 - 批量添加”，如下图所示。

产品选择：选择之前在2.2.1流程中创建的摄像头产品。

添加方式：选择批量上传，如下图所示

批量上传文件：首先点击"下载.csv模板"。模板内容如下图所示。这里的DeviceName, 需要填入设备的IoT编码。

无NVR接入摄像头的DeviceName：请参照甲方提供的<IoT设备信息表>，在安防-摄像头 TAB页查看设备IP

然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码，然后将IoT编码填入上面的csv模板表格里DeviceName列里。

有NVR接入摄像头的DeviceName: 请参照甲方提供的<IoT设备信息表>，在安防-摄像头 TAB页查看设备IP, 然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码，例如CPSBKZQ-000062。由于一个有NVR接入的摄像头可能同时连接多个NVR设备，则需要在IoT平台上为该有NVR接入摄像头创建多个设备。接入第一个NVR对应的IoT编码是CPSBKZQ-000062.1，接入第二个NVR对应的IoT编码是CPSBKZQ-000062.2。后面以此类推。然后将所有的IoT编码填入上面的csv模板表格DeviceName列里。例如下面表格的三个连接NVR的列里都有数据，那需要创建三个IoT编码。

将所有无NVR接入摄像头和有NVR接入摄像头设备的IoT编码添入表格里后。然后点击"上传文件"并确认

添加完成后点击“下载设备证书”（下载好的设备证书 都以“.csv”结尾，例如“设备证书.csv”），如下图所示。

2.3 创建NVR类型的产品和设备

当项目中存在摄像头设备接入到NVR设备中实现上云的情况，需要添加相关的NVR设备。操作示例如下:

2.3.1 创建NVR产品

产品名称： 输入规则建议：品牌+功能。例如海康-NVR

所属品类：请选择“标准品类：智能生活/家居安防/网络硬盘录像机”

节点类型：请选择“直连设备”，如下图所示。

2.3.2 创建NVR设备

产品选择：选择之前在2.3.1流程中创建的NVR产品。

添加方式：选择批量上传，如下图所示

批量上传文件：首先点击"下载.csv模板"。模板内容与2.2.3节一样，需要填写NVR设备的DeviceName。请参照甲方提供的<IoT设备信息表>，在安防-NVR TAB页查看设备IP(如下图所示), 然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码，并直接填入上面的csv模板表格里。

当所有NVR设备的IoT编码添入csv表格里后，点击"上传文件"并确认。

添加完成后点击“下载设备证书”并保存（下载好的设备证书 都以“.csv”结尾，例如“设备证书.csv”），后续操作将使用。

2.4 添加设备备注信息

安防设备，需要添加设备位置的备注信息，具体方式如下

2.4.1 查找设备

打开物联网应用服务平台。注意不要选择项目，点击设备，如下图所示：

然后将需要填写设备备注信息的设备的IoT编码，添加到上面的DeviceName搜索框里，点击搜索。

设备的IoT编码查找方法：

参照甲方提供的<IoT设备信息表>，在安防-摄像头 TAB页查看某个设备IP(如下图所示), 然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码 和 位置补充描述。如下图所示：

将上面找到的设备的IoT编码，输入到上面打开的物联网应用服务平台的DeviceName搜索框里，点击搜索。结果如如下图所示：

找到搜索到的设备，点击右侧查看

2.4.2 添加备注信息

点击编辑：

将上一节里找到的位置补充描述信息，添加到弹出的编辑框里，点击确认。如下图所示

重复上面操作，将所有安防设备的备注名完成添加。

3 添加设备到数字园区引擎的实例中

登录AIoT开放平台，点击数字园区引擎下面的某个实例，如下图所示：

点击基础能力-设备管理，选择刚才创建的aIbox设备和摄像头设备，最后点击绑定设备。

4. LV边缘视频本地控制台设备操作

4.1 新增三个LV边缘视频远程服务入口

Link Visual 边缘视频组件，支持多实例。目前已经支持3个实例。每个实例可最多接入256个安防摄像头设备。每个实例有不同的远程服务操作入口。下面将为每个实例创建不同的远程服务操作入口

建议在项目部署实施时，先在第一个实例上按照最大支持的256个摄像头完成添加，再对第二个实例按照最大支持的256个摄像头完成添加，最后对第三个实例进行添加。注意同一个NVR设备下面连接的所有摄像头，需要安装部署到同一个实例里。

4.1 登录AIBOX控制台

4.1.1 进入边缘实例

登录LV边缘视频本地控制台，需跳转到阿里云物联网平台，对该项目对应的边缘实例进行操作，具体步骤如下：

点击"基础能力-边缘管理-边缘集群"，点击该边缘集群实例右侧的管理。如图所示

点击组件管理，找到Link Edge边缘设备接入组件，点击实例。如下图所示。

4.1.2 创建远程服务操作入口

点击更多远程操作，如图所示：

4.1.2.1 创建第一个远程服务操作入口：

在打开的对话框里，点击新增

填入下面信息，如下图所示：

服务类型：选择 HTTP

服务名称：填写 HTTP-LH-8080

IP地址： 填写 127.0.0.1

端口号：填入第一个远程服务对应实例的端口号：8080

用户名：固定填写 iiot

密码：固定填写 iiot

填写完成后，点击确认

创建完成后，将展示出第一个远程服务的入口，如下图所示。暂时先关闭该窗口，不做处理

回来点击更多远程服务，从远程服务下拉列表可以看见刚才刚才创建的第一个AIBOX远程服务实例入口：HTTP-LH-8080

4.1.2.2 创建第二个远程服务操作入口：

如刚才创建第一个操作，点击更多远程服务，再点击新增

创建第二个远程服务时，需要更换远程服务名称和端口号，如下图所示：

服务类型：选择 HTTP

服务名称：填写 HTTP-LH-8081

IP地址： 填写 127.0.0.1

端口号：填入第一个远程服务对应实例的端口号：8081

用户名：固定填写 iiot

密码：固定填写 iiot

4.1.2.3 创建第三个个远程服务操作入口

第三个远程服务时，同样需要更换远程服务名称和端口号

服务类型：选择 HTTP

服务名称：填写 HTTP-LH-8082

IP地址： 填写 127.0.0.1

端口号：填入第一个远程服务对应实例的端口号：8082

用户名：固定填写 iiot

密码：固定填写 iiot

4.2 添加设备到第一个LV实例

如4.1节开始解释，可以最多添加256个摄像头设备添加到LV边缘视频的一个实例里。下面具体说明

4.2.1 登录第一个LV实例本地控制台

点击更多远程服务，远程服务选择“HTTP HTTP-LH-8080”, 点击确定，如图所示

弹出的页面，输入账号密码，登录AIBOX边缘控制台。登录账号：admin ； 密码 admin 。

登录后可进行设备的相关配置操作，如下图所示。

4.2.2 添加摄像头

4.2.2.1 添加无NVR接入摄像头

需要将IPC设备加入到AIBOX中，点击“设备管理 - 添加设备”进行设备信息的相关配置，如下图所示。

设备名称: 填写无NVR接入设备的IoT编码。与2.2.3节类似，请参照甲方提供的<IoT设备信息表>，在安防-摄像头 TAB页先查找到无NVR接入摄像头设备，查找方法参见前面的2.2.2节介绍。 找到无NVR接入的设备IP, 然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码。输入示例为SXJ-001274

设备类型: 直接接入IPC设备则选择“设备“即可。

协议类型：选择海康

IP：在上面填写设备名称时，已经查找到<IoT设备信息表>安防-摄像头 TAB页 的设备IP。输入示例为10.249.20.23

端口，用户名，密码：参照甲方提供的<IoT设备信息表>，安防-摄像头 TAB页的设备端口，账号，密码，如下图所示

备注信息：参照甲方提供的<IoT设备信息表>，根据安防-摄像头 TAB页的类型名称填写：

普通摄像头：类型编码是ipcamera, 备注信息内容："CategoryCode":"community/security/ipcamera"

违停球相机：类型编码是tptzcamera, 备注信息内容："CategoryCode":"community/security/tptzcamera"

人脸抓拍机：类型编码是frcamera, 备注信息内容："CategoryCode":"community/security/frcamera"

周界相机：类型编码是pmcamera, 备注信息内容："CategoryCode":"community/security/pmcamera"

4.2.2.2 添加NVR设备

在AIBOX本地控制台，当添加NVR设备之前，需要确认两点：

a: 要确保NVR设备内网正常。因为在添加NVR摄像头时，NVR设备下面连接的摄像头，将自动拉取添加。如果NVR设备不在线情况下完成添加，当NVR摄像头上线后，不会自动拉取。

b: 需要将NVR设备的所有IPC摄像头信息，配置到NVR设备里。这个需要请NVR设备厂商处理

将NVR设备加入到AIBOX方法：点击“设备管理 - 添加设备”进行设备信息的相关配置，如下图所示。

设备名称: 填写设备的IoT编码。与2.2.3节类似，请参照甲方提供的<IoT设备信息表>，如下图。在安防-NVR TAB页查看设备IP, 然后在<IoT设备信息表>的通用模板 TAB页，查找设备IP对应的IoT编码。输入示例为YPLXJ-000118

设备类型: NVR类型的设备在添加的时候，设备类型需要选择网关。

协议类型：选择海康

IP：参照甲方提供的<设备信息表>中的摄像头IP。输入示例为10.249.20.23

端口，用户名，密码：参照甲方提供的<设备信息表>中的账号密码和端口

备注信息：参照甲方提供的<IoT设备信息表>，根据安防-NVR TAB页的类型名称填写：

普通NVR：类型编码是nnvr, 备注信息内容："CategoryCode":"community/security/nnvr"

智能分析NVR：类型编码是invr, 备注信息内容："CategoryCode":"community/security/invr"

人脸识别NVR：类型编码是frnvr, 备注信息内容："CategoryCode":"community/security/frnvr"

4.2.3 设备上云

4.2.3.1 AIBOX设备上云

点击上云配置，将在2.1.3 节获取的AIBOX三元组信息输入到控制台，即可使AIBOX在云端上线。特别注意，对于三个不同的实例，需要分别使用在2.1节创建的三个不同的AIBOX设备。

4.2.3.2 摄像头设备上云

在“上云配置 - 设置三元组”栏目中，点击“上传三元组 - 文件上传”，可以将从云端获取到的摄像头三元组到AIBOX中（“文件上传”中的文件选择我们在之前2.2.3步骤中下载好的“设备证书.csv”即可），如下图所示。

注意：nvr自动拉取摄像头设备的三元组信息也需要上传设备证书，这些设备在2.2.3都创建完成

4.2.4 摄像头设备和设备三元组映射

4.2.4.1 无NVR接入摄像头

在4.2.2.1节添加普通摄像头时，如果设备名称是IOT编码，则AIBOX控制台系统会自动进行三元组匹配。如果不是，则参考下面流程进行操作：

选择“上云配置 - 摄像头身份”，对于云端身份未分配的设备，点击编辑 ，进行本地设备与云端设备身份映射，如下图所示。

参照甲方提供的<IoT设备信息表>，如下图。在通用模板 TAB页，根据设备名称，找到对应的IOT编码

然后在下拉列表里找到对应的IOT编码，点击确定进行匹配，如下图所示。

匹配成功后，云端身份显示“已分配”，如下图所示。

4.2.4.2 有NVR接入摄像头

在4.2.2.2节添加完成某个NVR设备后，边缘控制台上会自动拉取的通过该NVR设备连接的所有IPC摄像头设备，即有NVR接入摄像头设备，如下图所示。

上面显示的就是所有通过某个NVR设备连接的所有IPC摄像头设备。有NVR接入摄像头的设备名称由三部分组成：

NVR设备的IoT编码+“有NVR接入摄像头”设备的通道号+“有NVR接入摄像头”设备的空间信息。

例如：YPLXJ-000105_2_4#3单元西电梯：其中NVR设备的IoT编码是YPLXJ-000105，“有NVR接入摄像头”设备的通道号是2，“有NVR接入摄像头”设备的空间信息是4#3单元西电梯

下面举例说明如何对这个设备名称为 YPLXJ-000105_2_4#3单元西电梯 的设备如何配置三元组

(1) 查找这个有NVR接入摄像头的设备连接的NVR IP地址

通过该设备连接的NVR的IOT编码是YPLXJ-000105，通过甲方提供的<设备信息表>的通用模板TAB页，可以找到对应的IP地址。如下图所示：

(2) 查找该有NVR接入摄像头设备的IP地址

参照甲方提供的<设备信息表>，在安防-摄像头TAB页， 根据NVR设备的IP地址和设备名称里的通道号信息，找到该有NVR接入摄像头设备的IP地址。如图所示

关于通道号的补充说明：

由于某些NVR设备，由于1~32的通道保留处理，对外提供的通道号是从33开始。这时根据自动拉取的有NVR接入摄像头的名称查找通道号时，需要将通道号减32。例如：YPLXJ-000105_33_14#东电梯，该设备的通道号可能是1，也可能是33. 具体可以查看上面安防-摄像头TAB页，如果对应NVR的通道信息显示是从1开始，而且最大通道号小于33，则实际通道号很可能是1。

(3) 查找该有NVR接入摄像头设备的IoT编码

通过甲方提供的<设备信息表>的通用模板TAB页，可以通过IP地址，找到该设备对应的IoT编码

(4) 对该有NVR接入摄像头设备配置三元组

回到本小结开始AIBOX本地控制台，点击该有NVR接入摄像头设备右侧的编辑，在弹出的对话框里，查找选择（3）里找到的IoT编码，然后点击确定

匹配成功后，该设备的云端身份显示“已分配”。

4.2.4.3 NVR设备

NVR设备必须手动分配三元组，无论NVR设备名称与三元组的DeviceName是否相同

对NVR设备分配三元组操作，与4.2.4.1节无NVR接入摄像头类似：选择“上云配置 - 摄像头身份”，对于云端身份未分配的NVR设备，点击编辑。然后在下拉列表里选择NVR设备对应的IOT编码。NVR设备的IOT编码查找方法：在通用模板 TAB页，根据NVR设备的IP地址，找到对应的IOT编码。

4.2.5 设备联通性验证

在进行设备联通性验证前，需要首先查验厂商的设备状态

1、厂商设备的软件版本已经升级到完成与阿里物业一体机对接过的版本。

2、厂商的设备配置正确，例如配置了物业一体机(AIBOX)的IP地址和端口号。

3、厂商的设备IP地址设置正确，物业一体机可以正常ping通厂商设备

所有设备按照上面描述操作完成后，可以在本地控制台，点击设备管理，逐个查看上面添加的所有设备状态，验证设备的联通性。如果云端连接和本地连接状态都是在线，则说明设备成功与AIBOX网关连接成功，如下图所示；如果有任何一个显示离线，说明设备与AIBOX网关没有连接成功，这时可以排查的点：

a 排查NVR设备内网是否通的。可以登录网关，去ping NVR设备

b 排查NVR设备配置是否正确：需要配置 AIBOX的IP地址，端口号，以及其下面接入的IPC摄像头信息

c 排查AIBOX本地控制台，创建NVR设备时配置是否有问题。例如接入方式应该是网关，而不是设备

d. 排查NVR设备分配的三元组，是否是有效的

当设备联通性验证失败时，也可以参考<FAQ：常见问题排查手册>进行问题排查

4.3 添加设备到第二个/第三个LV实例

操作与4.2节类似，只是登录LV实例时，远程服务选择不同，后续操作完全相同

登录第二个LV实例本地控制台，远程服务选择“HTTP HTTP-LH-8081”：

登录第二个LV实例本地控制台，远程服务选择“HTTP HTTP-LH-8082”：