news 2026/4/29 4:58:55

萤石开放平台 国标设备接入 | 三方品牌设备接入文档/宇视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/4/27 19:05:03

每日八股——Go(4)

gRPC是什么&#xff1f; gRPC (Google Remote Procedure Call) 是一个由谷歌开发的高性能、开源的RPC&#xff08;远程调用&#xff09;框架。简单来说&#xff0c;他的核心目的是&#xff1a;让你调用远程服务器上的函数&#xff08;方法&#xff09;&#xff0c;就像调用本…

作者头像 李华
网站建设 2026/4/28 1:41:45

灌区PLC阀门远程监控运维系统方案

一、项目背景灌区作为农业用水的重要区域&#xff0c;其水资源的合理分配与高效利用直接关系到农业生产的稳定与发展。传统灌区管理方式中&#xff0c;PLC阀门往往依赖人工现场操作与监控&#xff0c;存在响应速度慢、管理效率低、资源分配不均等问题。随着物联网技术的发展&am…

作者头像 李华
网站建设 2026/4/18 17:19:39

Kubernetes集群升级指南

前言本文演示kubernetes集群从v1.24.1升级到v1.29.15。一、集群升级过程辅助命令&#xff08;1&#xff09;查看节点上运行的pod。kubectl get pod -o wide |grep <nodename>&#xff08;2&#xff09;查看集群配置文件。kubectl -n kube-system get cm kubeadm-config -…

作者头像 李华
网站建设 2026/4/23 20:42:04

维智 MCP 接口服务技术支持指南

&#xff08;一&#xff09;服务概述 维智 MCP Server 基于标准化 MCP 协议&#xff0c;整合丰富地理信息数据&#xff0c;为智能体提供地点搜索、正 / 逆地理编码、IP 定位解析、天气查询四大核心能力。数据覆盖城市级、街道级、坐标级查询&#xff0c;支持 HTTP/SSE 双传输协…

作者头像 李华
网站建设 2026/4/23 23:37:30

制造企业如何打通“三链”协同?一文讲清

目录 一、概念区分 1.产业链 2.供应链 3.价值链 二、那么&#xff0c;不协同具体会带来哪些问题&#xff1f; 1.目标不一致导致的行动矛盾 2.部门之间的优化相互冲突 3.创新想法受制于现实条件 三、怎么才能推动协同&#xff1f; 第一步&#xff0c;从统一目标和评价…

作者头像 李华
网站建设 2026/4/23 19:18:11

【老毛桃WinPE启动盘制作全攻略,附镜像获取渠道】

经常遇到电脑蓝屏、系统崩溃、忘记开机密码的情况&#xff1f;别急着送修&#xff01;一个WinPE启动盘就能轻松解决这些问题。今天就给大家带来超详细的老毛桃WinPE启动盘制作教程&#xff0c;从工具准备到系统安装&#xff0c;每一步都讲得明明白白&#xff0c;零基础小白也能…

作者头像 李华