news 2026/1/22 22:12:00

萤石开放平台 国标设备接入 | 三方品牌设备接入文档/大华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进行投诉反馈,一经查实,立即删除!
网站建设 2025/12/27 4:25:11

终极指南:免费在Mac上读写NTFS磁盘的简单方法

终极指南&#xff1a;免费在Mac上读写NTFS磁盘的简单方法 【免费下载链接】ntfstool A ntfs tool for mac 项目地址: https://gitcode.com/gh_mirrors/nt/ntfstool 还在为Mac电脑无法写入NTFS格式的移动硬盘而头疼吗&#xff1f;NTFSTool这款开源工具正是为你量身定制的…

作者头像 李华
网站建设 2026/1/6 13:35:55

【CMake 】CMake 中的 target_include_directories 详解

CMake 中的 target_include_directories 详解 引言 在使用 CMake 构建 C/C 项目时&#xff0c;我们经常需要告诉编译器在哪里查找头文件。target_include_directories 是 CMake 中用于设置头文件搜索路径的核心命令。本文将深入探讨这个命令的用法、参数含义以及最佳实践。 …

作者头像 李华
网站建设 2025/12/24 6:49:56

不懂英语,真的不能学黑客技术吗?

很多想入门网络安全&#xff08;俗称 “黑客技术”&#xff09;的朋友&#xff0c;第一步就被 “英语门槛” 吓退了&#xff1a;“代码全是英文&#xff0c;工具界面也是英文&#xff0c;我英语差得一批&#xff0c;肯定学不会吧&#xff1f;” 其实这是最大的误解&#xff01…

作者头像 李华
网站建设 2025/12/23 16:19:23

【C++】C++内联函数定义在头文件中的问题详解

【C】C内联函数定义在头文件中的问题详解 一、问题背景 1.1 内联函数的基本要求 在C中&#xff0c;内联函数&#xff08;inline function&#xff09;有一个重要特性&#xff1a;每个使用内联函数的编译单元&#xff08;translation unit&#xff09;都必须能看到其完整定义。 …

作者头像 李华
网站建设 2026/1/1 13:48:53

从混乱到有序,Lsky-Pro+CPolar 搭建你的专属远程素材库

文章目录前言1. 添加镜像源2. 创建Lsky Pro图床容器3. lsky-pro安装配置4. lsky-pro图床简单使用5. 安装内网穿透5.1 安装cpolar内网穿透5.2 配置图床公网地址6. 配置固定公网地址前言 Lsky-Pro 是一款功能全面的图床工具&#xff0c;支持多图拖拽上传、剪贴板粘贴、全屏预览等…

作者头像 李华