news 2026/4/18 1:46:40

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
萤石开放平台 国标设备接入 | 三方品牌设备接入文档/大华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信息的请求报文,如果有表示网络正常,如果没有,表示设备端网络入口存在限制条件。需要进一步排查防火墙或路由器设置。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/15 15:12:12

DeepLX终极指南:免费翻译API的完整解决方案

还在为DeepL官方API的高昂费用和Token限制而烦恼吗&#xff1f;DeepLX来了&#xff01;这是一个完全开源的DeepL免费API实现&#xff0c;让你无需任何Token就能享受高质量的翻译服务。无论你是个人开发者还是小型团队&#xff0c;DeepLX都能为你提供简单高效的翻译解决方案。 【…

作者头像 李华
网站建设 2026/4/16 15:52:48

ModernWMS开源仓库管理系统:3小时从零搭建企业级仓储平台

ModernWMS开源仓库管理系统&#xff1a;3小时从零搭建企业级仓储平台 【免费下载链接】ModernWMS The open source simple and complete warehouse management system is derived from our many years of experience in implementing erp projects. We stripped the original c…

作者头像 李华
网站建设 2026/4/7 17:17:26

5分钟快速上手gif-h:轻量级C++ GIF动画生成终极指南

5分钟快速上手gif-h&#xff1a;轻量级C GIF动画生成终极指南 【免费下载链接】gif-h Simple C one-header library for the creation of animated GIFs from image data. 项目地址: https://gitcode.com/gh_mirrors/gi/gif-h 想要在C项目中轻松创建动态GIF动画吗&#…

作者头像 李华
网站建设 2026/4/17 2:11:56

C#转java的最好利器easy-query就是efcore4j sqlsugar4j freesql4j

数据库模型image点击查看实体代码案例查询用户信息和最早开户的银行卡信息通过模型我们可以清晰的看到SysUser和BankCard是一对多的关系&#xff0c;eq如何实现这种一对多的数据返回呢&#xff1f;使用临时对象返回var list easyEntityQuery.queryable(SysUser.class).select(…

作者头像 李华
网站建设 2026/4/18 4:37:03

在线服务器的应用场景都有哪些?

在线服务器作为现代网络架构的核心组件&#xff0c;凭借其强大的计算、存储和数据处理能力&#xff0c;广泛应用于众多领域&#xff0c;深刻改变着人们的生活与工作方式。在线服务器用于对重要数据进行定期备份&#xff0c;防止数据丢失&#xff0c;备份数据可以存储在本地服务…

作者头像 李华
网站建设 2026/4/18 0:26:38

压电雨量监测站:物联网驱动的降雨监测

压电雨量监测站是一款基于物联网技术的现代雨量监测设备&#xff0c;由压电雨量传感器、采集器、太阳能供电系统及立杆支架等部分组成&#xff0c;该设备能够记录分钟级雨量、小时累计雨量、日累计雨量等不同时间维度的数据&#xff0c;并支持自定义日分界时间与降雨报警阈值。…

作者头像 李华