萤石开放平台 国标设备接入 | 三方品牌设备接入文档/大华NVR对接文档

接入流程概览：

· 完整接入流程：

一. 绑定设备，获取接入参数（共3步）

1. 进入“国标控制台-设备管理”页，支持 绑定设备/批量绑定设备 申请国标设备所需的设备信息。

（以下操作以“绑定设备”为例展示，不进行批量绑定的操作展示。）

*注意：绑定设备后，即开始进行计费。

填写项	说明
设备类型	如您需要接入1个前端设备（IPC摄像头），则选择前端设备（IPC）；如果您需要接入1个后端设备（NVR摄像头），则选择后端设备（NVR）。
设备名称	可支持自定义，用于标注设备的具体名字。
设备国标ID	设备的国标ID编码。当前支持自动生成/手动生成。根据国标协议中对于国标编码格式定义，前端设备国标编码为20位数字编码，其中11-13位固定为132；后端设备国标编码为20位数字编码，其中11-13位固定为111。
设备密码	设备的密码，4-20位，可包含大小写字母、数字（大小写字母敏感）。

2. 绑定通道。

进入指定NVR的“通道列表”，点击“绑定通道”，申请该NVR下通道设备接入开放平台所需要的配置参数。

（注意，在设备的配置过程中，保持通道号-视频通道编码ID的云端控制台对应关系与本地设备端配置的对应关系一致。可以保证云端不乱序哦！）

填写项	说明
通道号	对应NVR下的通道号。0-999的编码，一般情况下，仅NVR本身自带视频能力时会使用通道0。
视频通道编码ID	视频通道的国标ID编码。当前支持自动生成/手动生成。根据国标协议中对于国标编码格式定义，通道国标编码为20位数字编码，其中11-13位固定为132。
通道名称	可支持自定义，用于标注设备的具体名字。

3. 完成后，您可以在“国标控制台-设备管理-后端设备（NVR）”中查看到申请的设备信息。

在配置过程中，所需的设备信息，可以通过 “设备详情” 按钮进行查看。（如您需要导出为excel，可通过页面右上角的 “导出设备” 按钮进行导出。）

二. 获取设备IP，准备进行设备注册（共2步）

1. 在配置设备前，都需要将设备和PC接在同一个局域网内，采用以下三种方式获取到设备的IP。

        a) 在大华NVR自带的软件配置见面，点击网络配置-TCP/IP 可以获取到设备的IP地址。

        b) 若设备IP没有更改过，那么可以通过购买设备时提供的设备说明书获取到设备的IP。

        c) 如果说明书遗失、默认IP地址不能用或者修改过，则需要使用大华的ConfigTool（PC端）工具按照下图步骤搜索局域网设备。

2. 搜索到设备后，选择需要注册的设备，获取其IP地址（下图红框标注处为设备IP）

三. 注册设备（共5步）

1. 在浏览器（IE9及以上）地址栏中输入设备IP，按Enter键，进入设备web客户端界面。

2. 进入国标接入配置页面（登陆系统后点击{设置}-{网络设置}-{平台接入}，进入配置界面。）

【控制台配置指南】 

 【Excel配置指南】 

3. 配置相关信息

所需配置信息名称	获取方式	备注
平台接入方式	28181	一个设备只能通过一种协议接入一个平台。
SIP服务器编号	对应SIP服务器ID。Excel文件中，对应“项目信息”表格中的“项目编号”值。
SIP服务器域	对应SIP服务器域。（项目编号的前10位数字）
SIP服务器IP	· IP：电脑连接在设备所在网络环境下，“Win+R”-“输入cmd”-输入“ping devgb28181.das.ys7.com” 会拿到当前网络对应运营商的服务注册IP地址。	ping域名时，“请求超时”为正常现象。
设备编号	对应SIP用户名。Excel文件中，对应“设备信息”表格中的“设备国标ID”值。
注册密码	对应密码。Excel文件中，对应“设备信息”表格中的“设备密码”值。
本地SIP端口	5060	设备默认设置的5060本地SIP端口可能会被局域网屏蔽，如连接不成功可尝试修改为5061、5062等其他端口。
注册有效期	3600	请按照平台建议的参数值进行填写
心跳周期	30	请按照平台建议的参数值进行填写
最大心跳超时次数	3
行政区划代码	有默认值	无需配置
接入模块识别码	有默认值	无需配置
通道信息-通道	选择需要添加IPC设备的通道
通道信息-通道编号	对应指定NVR下通道的视频通道编码ID。可通过“设备列表”-NVR-“通道列表”获取，或通过“设备列表”页的“导出设备”按钮下载接入参数的Excel文件获取。	可根据需要接入云的通道数，进行个性化配置 注意！通道的编码与通道号需要与云平台中的配置对应。以保障通道不会乱序
通道信息-报警级别		无需配置

4. 进入通道管理页面

5. 添加通道

该NVR关联的所有通道设备都需要在这个界面进行添加，而需要接入萤石云的通道在“通道信息-通道编号”处进行个性化添加。

四. 测试设备（共1步）

1.您可在“国标控制台-设备列表”页面，核对“设备状态”是否为在线，并点击“播放”等按钮测试设备是否能否正常播放。若设备不在线/没有可用播放地址/播放失败，请优先参照接入文档“常见问题”，核查接入参数是否遗漏或配置错误。

五. 常见问题

1. 摄像头注册不成功问题？请按照如下步骤进行初步排查：

• 请核对各项参数填写的正确性，确保每一组接入参数都只对应一台设备使用。特别注意NVR需要单独配置设备的“通道管理”界面。只有在“视频通道编码ID”处填写NVR下通道设备的“通道编码”，其余填写项均为NVR的接入参数；请核对“注册有效期”为3600，“心跳周期”为30。

• 若设备出现频繁“在线-离线”的切换，请核查“通道编码”填写是否有误，正确的填写项应为指定NVR下通道设备的“视频通道编码ID”。若使用物联网卡，请确保没有出现同一台设备使用多网卡的情况。

• 若设备上线失败且设备所连网络有防火墙相关设置，可以将开放平台的ip端口添加到白名单中，放开网络对开放平台的限制（电信：60.190.232.116；联通：124.160.120.116 移动：112.13.217.116；域名: devgb28181.das.ys7.com；端口：6800）。

• “传输协议”：

  · 如果设备支持TCP传输协议，请首选“TCP”（可在UDP和TCP之间切换尝试）；

  · 如果选择“UDP”，请核查设备连接的网络（内网请特别注意）、设备连接的路由器以及设备本身是否限制UDP协议（设备防dos攻击即为限制UDP协议）？请核查是否有配置过白名单限制了萤石的服务ip端口？并可以使用sockettool检查设备所处网络是否有限制。

• 如果设备连接的网络IP端口有范围，建议开启DHCP为设备动态获取IP（特别是发现设备IP固定无法修改时），并检查设备所在网络的路由期配置DHCP租期是否过短，一般是2天。

• 目前国标设备直播的视频编码格式不支持“H265”，需要在音视频相关配置界面将该属性修改为“H264”。

• 若以上排查无误，请联系设备商或设备售后，确认设备固件是否需要升级（例如NVR只有部分通道能正常观看的情况，建议更新NVR的固件版本）。

2. 注册设备前获取运营商的服务注册IP地址产生ping不通的问题？（如下图所示）

解决方案：红色框中的地址就是您的网络注册地址，端口号为6800。蓝框中的请求超时是因为服务端出于安全因素的考虑，是禁止ping的，做ping这一步的操作主要目的是为了拿到对应的注册IP地址。

3. SIP服务器地址使用域名和使用IP地址有什么区别？

解决方案：如果设备支持解析域名，建议您最好可以使用域名，目前海康、大华、宇视最近几年的设备都已支持域名方式，如果使用的是IP地址，假设您对应的宽带网络运营商发生机房故障，您的设备也会受到对应时长的影响。使用域名在后期便于平台做异地多活、自动灾备，有效规避上述问题，更好的保障服务可用性。

4. 关于如何确认设备端的网络有入口限制：

排查方案：

• 使用SocketTool工具模拟设备，向服务端发送SIP注册报文，看是否能收到服务端主动发出的设备信息查询请求。
• 首先，发送设备注销请求，将以下报文完整复制到发送窗口，点击“发送数据”按钮：

REGISTER sip:33010142992577394892@devgb28181.das.ys7.com:6800 SIP/2.0
Via: SIP/2.0/UDP 192.168.1.1:5060;rport;branch=z9hG4bK1011558205
From: <sip:33010706991327201387@3301089499>;tag=1571777767
To: <sip:33010706991327201387@3301089499>
Call-ID: 120965105@3301089499
CSeq: 1 REGISTER
Contact: <sip:33010706991327201387@192.168.1.1:5060>
Max-Forwards: 70
Expires: 0
Content-Length: 0

]

• 然后，发送设备注册请求，将以下报文完整复制到发送窗口，点击“发送数据”按钮：

REGISTER sip:33010142992577394892@devgb28181.das.ys7.com:6800 SIP/2.0
Via: SIP/2.0/UDP 192.168.1.1:5060;rport;branch=z9hG4bK1011558205
From: <sip:33010706991327201387@3301089499>;tag=1571777767
To: <sip:33010706991327201387@3301089499>
Call-ID: 120965105@3301089499
CSeq: 1 REGISTER
Contact: <sip:33010706991327201387@192.168.1.1:5060>
Max-Forwards: 70
Expires: 3600
Content-Length: 0

]

• 最后，观察数据接收窗口，是否有有DeviceInfo信息的请求报文，如果有表示网络正常，如果没有，表示设备端网络入口存在限制条件。需要进一步排查防火墙或路由器设置。