news 2026/6/23 8:37:02

萤石开放平台 国标设备接入 | 三方品牌设备接入文档/宇视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地址不能用或者修改过,则需要使用宇视的EZTools(PC端)工具按照下图步骤搜索局域网设备(图1),搜索到设备后,按照步骤勾选需要配置的设备,点击登录,并在列表的IP字段中,获取到设备的IP地址(图2)。

2. 选择需要注册的设备,获取其IP地址(以EZTools获取设备IP为例)

图1 搜索设备

图2 登录设备并获取设备IP

三. 注册设备(共5步)

1. 在浏览器(IE9及以上)地址栏中输入设备IP地址,按Enter键,进入设备web客户端界面。(账号和密码默认为admin和123456,如果更改过则填入更改过的账号和密码)

2. 进入国标接入配置入口(登陆系统后点击{配置}-{网络配置}-{国标},进入配置界面。)

【控制台配置指南】

【Excel配置指南】

3. 配置相关信息

所需配置信息名称获取方式备注
平台接入方式28181一个设备一般只能通过一种协议接入一个平台。
SIP服务器编码对应SIP服务器ID。Excel文件中,对应“项目信息”表格中的“项目编号”值。
SIP服务器域对应SIP服务器域。(项目编号的前10位数字)
SIP服务器地址可以选择填写域名 或 IP
● 域名:devgb28181.das.ys7.com;
● IP:电脑连接在设备所在网络环境下,“Win+R”-“输入cmd”-输入“ping devgb28181.das.ys7.com” 会拿到当前网络对应运营商的服务注册IP地址。

ping域名时,“请求超时”为正常现象。
SIP服务器端口对应SIP服务器端口。Excel文件中,对应“项目信息”表格中的“端口号”值。
用户名对应NVR的国标设备ID。可通过“设备列表”-“设备详情”获取,或通过“设备列表”页的“导出设备”按钮下载接入参数的Excel文件获取。
密码对应NVR的设备密码。可通过“设备列表”-“设备详情”获取,或通过“设备列表”页的“导出设备”按钮下载接入参数的Excel文件获取。
SIP用户认证ID对应SIP用户名。Excel文件中,对应“设备信息”表格中的“设备国标ID”值。
注册有效期3600请按照平台建议的参数值进行填写
行政区划码无需配置
心跳周期30请按照平台建议的参数值进行填写
最大心跳超时次数3
视频通道编码对应指定NVR下通道的视频通道编码ID。可通过“设备列表”-NVR-“通道列表”获取,或通过“设备列表”页的“导出设备”按钮下载接入参数的Excel文件获取。可根据需要接入云的通道数,进行个性化配置
注意!通道的编码与通道号需要与云平台中的配置对应。以保障通道不会乱序

4. 进入IPC配置页面(通道配置-IPC配置)

5. 添加或修改IPC的通道,直到状态显示的图标变为绿色,表示IPC与录像机连接成功且在线。

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

四. 测试设备(共1步)

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

五. 常见问题

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

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

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

  • “传输协议”

    · 如果设备支持TCP传输协议,请首选“TCP”(可在UDP和TCP之间切换尝试);

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

  • “SIP服务器地址”

    如果填写内容为域名(devgb28181.das.ys7.com),但设备无法正常在线,请核查:

    · 设备本身可能并不支持解析域名,请尝试将填写内容修改为服务端IP(IP可通过ping域名获取,具体参照注册步骤);

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

  • 如果设备连接的网络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/6/23 19:21:29

实习面试题-Rust 面试题

1.Rust 有哪些特点?它和 C、C++ 有什么区别? 回答重点 Rust 是一门系统编程语言,最大的特点就是在保证高性能的同时,通过编译器在编译期就能保证内存安全。简单来说,Rust 既有 C/C++ 那样的性能,又不会出现 C/C++ 那些令人头疼的内存问题。 Rust 的核心特点包括所有权…

作者头像 李华
网站建设 2026/6/23 19:36:58

视频字幕精确生成方法 用到字幕api开发文档

视频字幕精确生成方法 用到字幕api开发文档 本文档将详细介绍如何调用 /api/stt/audiototexturls 接口完成音频转文字&#xff0c;并基于接口返回的时间轴数据生成 SRT 等格式的精准字幕&#xff0c;帮助开发者快速实现相关功能。 一、接口核心信息梳理 你需要调用的是一个支持…

作者头像 李华
网站建设 2026/6/23 19:37:38

SPA 应用中的路由切换内存泄漏:未注销的 Scroll 监听与全局变量

SPA 应用中的路由切换内存泄漏&#xff1a;未注销的 Scroll 监听与全局变量大家好&#xff0c;我是你们的技术讲师。今天我们来深入探讨一个在现代前端开发中非常常见却又容易被忽视的问题——单页应用&#xff08;SPA&#xff09;中的内存泄漏问题&#xff0c;特别是由 未注销…

作者头像 李华
网站建设 2026/6/23 21:07:27

游泳池漆专用施工涂料如何选?专业视角解析耐水抗氯性能

说到游泳池漆哪个牌子好&#xff0c;很多工程方都会头疼。去年我亲自跟进一个市政泳池项目&#xff0c;施工队试了三种漆都出现脱落。后来改用海瑞的水池蓝池底漆&#xff0c;效果确实稳定。 环保安全与施工便捷的双重优势 游泳池漆哪个牌子好&#xff0c;首先要看环保指标。海…

作者头像 李华
网站建设 2026/6/23 5:05:03

中国RFID设备十大企业综合实力解析

&#xff08;注&#xff1a;以下排名基于技术研发、市场份额、行业应用等维度综合评估&#xff09;行业领军企业远望谷技术深耕物联网识别领域20年&#xff0c;其超高频读写设备在铁路物流管理市占率达38%&#xff0c;自主研发的$ \lambda \frac{c}{f} $抗干扰算法显著提升多标…

作者头像 李华