萤石开放平台 国标设备接入 | 三方品牌设备接入文档/宇视IPC对接文档

原创 于 2025-12-15 17:51:20 发布 · 682 阅读 · 6 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#萤石 #萤石云 #萤石开放平台 #国标协议 #开源协议

接入流程概览：

· 完整接入流程：

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

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

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

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

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

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

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

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

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

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

        b) 如果说明书遗失、默认IP地址不能用或者修改过，则需要使用宇视的EZTools（PC端）工具按照下图步骤搜索局域网设备（图1），搜索到设备后，按照步骤勾选需要配置的设备，点击登录，并在列表的IP字段中，获取到设备的IP地址（图2）。

图1 搜索设备

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

三. 注册设备（共3步）

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

2. 进入国标接入配置页面（登陆系统后点击{配置}-{常用}-{服务器}，进入配置界面。）

【控制台配置指南】

【Excel配置指南】

3. 服务器配置信息

所需配置信息名称获取方式备注
平台接入方式28181一个设备一般只能通过一种协议接入一个平台。
设备ID对应SIP用户认证ID。Excel文件中，对应“设备信息”表格中的“设备国标ID”值。
管理协议GB/T28181
密码对应密码。Excel文件中，对应“设备信息”表格中的“设备密码”值。
视频通道ID自定义
音频通道ID自定义
设备名称自定义
服务器ID对应SIP服务器ID。Excel文件中，对应“项目信息”表格中的“项目编号”值。
服务器地址可以选择填写域名 或 IP。
● 域名：devgb28181.das.ys7.com；
● IP：电脑连接在设备所在网络环境下，“Win+R”-“输入cmd”-输入“ping devgb28181.das.ys7.com” 会拿到当前网络对应运营商的服务注册IP地址。

ping域名时，“请求超时”为正常现象。
SIP服务器端口对应SIP服务器端口。Excel文件中，对应“项目信息”表格中的“端口号”值。
注册有效期3600请按照平台建议的参数值进行填写
SIP服务器编号对应SIP服务器ID。Excel文件中，对应“项目信息”表格中的“项目编号”值。
SIP服务器域对应SIP服务器域。（项目编号的前10位数字）
用户名对应SIP用户名。Excel文件中，对应“设备信息”表格中的“设备国标ID”值。
心跳周期30请按照平台建议的参数值进行填写
最大心跳超时次数3
通道编码对应视频通道编码ID。Excel文件中，对应“设备信息”表格中的“设备国标ID”值。

四. 测试设备（共1步）

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

五. 常见问题

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

  • 请核对各项参数填写的正确性，确保每一组接入参数都只对应一台设备使用。特别注意“注册有效期”为3600，“心跳周期”为30。

  • 若设备出现频繁“在线-离线”的切换，请核查“视频通道编码ID”填写是否有误，正确的填写项应为“设备国标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”。

  • 若以上排查无误，请联系设备售后，确认设备固件是否需要升级（例如海康设备可在官网下载固件升级包）。

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信息的请求报文，如果有表示网络正常，如果没有，表示设备端网络入口存在限制条件。需要进一步排查防火墙或路由器设置。

什么设备可以接入萤石开放平台二次开发？
hq123897的博客
08-12 1515
如何判断我的设备能否接入萤石开放平台进行二次开发？
vue web端项目接入萤石摄像头（ezuikit）+实时播放+历史回看
12-09
萤石开放平台url：https://open.ys7.com/console/application.html vue web端项目 安装轻应用EZUIKit：npm install ezuikit-js@0.7.2 资源中的 设备序列号、appKey、appSecret 请替换成自己的
萤石开放平台 国标设备接入 | 三方品牌设备接入文档/海康IPC对接文档
hq123897的博客
12-09 845
国标设备接入流程主要分为五个步骤：1.绑定设备获取参数，需填写设备类型、名称、国标ID和密码；2.获取设备IP地址，需将设备与PC置于同一局域网；3.注册设备，需配置平台接入方式、传输协议等参数；4.测试设备状态和播放功能；5.排查常见问题，如注册失败、网络限制等。接入时需注意参数准确性、网络配置及设备兼容性，建议优先使用TCP协议和域名方式接入。遇到问题可参考文档进行排查或联系售后支持。
萤石开放平台 国标设备接入 | 三方品牌设备接入文档/大华IPC对接文档
hq123897的博客
12-11 742
国标设备接入流程主要分为五个步骤：1）在控制台绑定设备并获取接入参数；2）通过局域网搜索获取设备IP；3）在设备端配置SIP服务器信息完成注册；4）在控制台测试设备在线状态；5）遇到问题时排查参数配置、网络限制或固件版本。接入时需注意设备类型选择、国标ID格式、传输协议设置等关键参数，建议优先使用域名方式接入以提高服务可用性。常见问题包括设备注册失败、网络限制检测等，可通过参数核对、网络测试工具等方式排查。
萤石开放平台 国标设备接入 | 三方品牌设备接入文档/大华NVR对接文档
hq123897的博客
12-12 580
国标设备接入流程主要包括五个步骤：1.绑定设备获取参数（设备类型、国标ID、密码等）；2.获取设备IP地址；3.注册设备（配置SIP服务器、端口等参数）；4.测试设备在线状态；5.常见问题排查（注册失败、网络限制等）。注意事项包括：保持通道号与编码ID对应、建议使用域名接入、检查防火墙设置等。流程涉及前端设备（IPC）和后端设备（NVR）的不同配置要求，需严格遵循国标编码格式。
萤石开放平台 国标设备接入 | 三方品牌设备接入文档/海康NVR对接文档
hq123897的博客
12-10 963
本文详细介绍了国标设备接入平台的完整流程：1.设备绑定阶段（3步）：包括设备信息配置、通道绑定及参数获取；2.设备准备阶段（2步）：局域网搜索获取设备IP；3.设备注册阶段（5步）：详细说明Web端配置参数及注意事项；4.设备测试；5.常见问题排查指南。重点强调了参数配置准确性、网络环境检查、协议选择等关键环节，并提供了域名解析、网络限制检测等实用解决方案。整个流程覆盖了从设备绑定到最终上线的完整操作指引和故障处理方案。
HIK录像机GB28181对接相机不在线问题随笔
qq_39965491的博客
06-03 1633
型号：DS-8664N-I16-V3 V4.63.000 build 230412HIK录像机使用GB28181对接相机无法正常上线，对接HIK相机可以正常上线。现场拓扑如下图1.1：网络拓扑上述拓扑与NVR使用GB接入三方平台的拓扑类似，只不过NVR此时充当了平台的角色。1、异常。
视频协议整理
程序员杂谈
02-26 3863
GB/T 28181协议：GB/T 28181协议是由公安部科技信息化局提出，由全国安全防范报警系统标准化技术委员会（SAC/TC100)归口，公安部一所等多家单位共同起草的一部国家标准。 ONVIF协议：摄像机中较常用的一种协议，它是是一种兼容协议。 由安讯士联合博世及索尼三方共同成立的一个国际开放型网络视频产品标准网络接口开发论坛，取名为ONVIF（Open Network Video I...
2023届嵌入式笔面经&一位双非本科生的秋招日记
pzslongyutianxia的博客
10-07 9048
该文章是个人在2022年秋季招聘期间总结的一些经验分享，希望这篇文章能够帮助大家成功渡劫秋招，找到自己满意的工作，拿到令人心动的Offer!
萤石云接口平台可接入专项方案.docx
12-14
"萤石云接口平台可接入专项方案" 萤石云接口平台可接入专项方案是基于萤石云平台的智能家居解决方案，旨在为用户提供全方位的家居安全和监控服务。该方案主要包括萤石云平台、高清摄像头、云存放服务、报警系统等多...
WeChat-miniApp:微信小程序接入平台设备视频预览，直播，回放（敬请期待）及其示例demo
05-11
萤石云开放平台小程序（以下简称：萤石云小程序）为您提供设备预览、回放及设备能力体验，您可以快速体验设备预览、设备回放功能。同时，小程序还开放了视频取流SDK。如果您没有萤石开放平台账号或海康/萤石设备，也...
萤石云接口平台可接入方案.docx
12-30
### 萤石云接口平台可接入方案解析 #### 一、方案背景及目标 随着智能家居技术的发展，人们对居住安全和个人隐私的关注日益增加。萤石云接口平台旨在满足这一需求，提供一系列基于互联网的安全生活解决方案。该...
开源：开源协议从入门到落地
asaasdhesgs的博客
11-16 330
开源：共享与协作的技术盛宴 在软件开发领域，开源是一股强大的力量。它不仅促进了技术的快速发展，还让全球开发者能够共同参与，创造出无数优秀的项目。 开源协议是开源
毕业设计基于springboot+android在线音乐个性化推荐APP的设计与实现源码+论文+PPT答辩+演示视频.zip
12-14
随着移动互联网的快速发展，人们对音乐的个性化需求日益增长。在线音乐个性化推荐APP应运而生，旨在为用户提供更加贴合个人喜好的音乐体验。该APP采用Java语言开发，结合Spring Boot框架和MySQL数据库，实现了高效的数据处理和稳定的系统运行。通过分析用户的听歌历史、收藏记录和评论行为，APP利用先进的算法为用户精准推荐歌曲、歌单和歌手。用户可以在APP中浏览推荐内容，搜索感兴趣的音乐，查看歌曲详情，并与其他用户互动，如点赞、评论和分享。APP还提供了歌单创建和管理功能，方便用户整理自己的音乐收藏。通过MySQL数据库的高效存储和管理，APP能够快速响应用户的请求，确保流畅的用户体验。在线音乐个性化推荐APP不仅满足了用户对音乐的个性化需求，还通过社交互动功能增强了用户之间的联系，为用户打造了一个全方位的音乐娱乐平台。 关键词：在线音乐、APP、Spring Boot；
如何准确查找某篇论文的被引用来源？
12-14
源码地址： https://pan.quark.cn/s/4d32ca50bddd Searpy Stage Python 2.7 Python 3.7 Build Status 批量搜索工具，可用于采集和溯源 支持py2和py3 Install Help 1 示例 w762 2 其他功能 利用favicon.icon图标hash来寻找使用相同图标的网站，可用于溯源真实IP和资产发现 截屏2020-09-15 09.44.36 模块调用 支持搜索引擎 [x] Shodan [x] Fofa [x] Zoomeye [ ] Censys [ ] Dnsdb [x] Google [x] Baidu [x] Bing [x] 360so [x] Goo [x] Yahoo [x] Quake [x] Hunter ToDo [ ] 添加子域名搜索 ChangeLog v2.3 fix some bugs add fofa_icon module v2.2 fix some bugs Donations XMR: BTC:
emb_tb_2.csv
最新发布
12-14
【AB测试】支付宝营销策略效果分析
基于全局路径的无人地面车辆的横向避让路径规划研究[蚂蚁算法求解]（Matlab代码实现）
12-14
基于全局路径的无人地面车辆的横向避让路径规划研究[蚂蚁算法求解]（Matlab代码实现）内容概要：本文围绕基于全局路径的无人地面车辆横向避让路径规划展开研究，提出采用蚂蚁算法（蚁群优化算法）进行路径求解，并通过Matlab代码实现仿真验证。研究聚焦于无人车在复杂环境中根据全局路径信息实现动态避障与横向调整的路径规划问题，利用蚂蚁算法的寻优能力寻找满足安全性、平滑性和行驶效率的最优避让路径。文中详细阐述了问题建模、算法设计、参数设置及仿真结果分析过程，展示了该方法在路径规划中的有效性与鲁棒性。; 适合人群：具备一定自动化、控制工程或计算机相关背景，熟悉Matlab编程，从事智能车辆、路径规划或优化算法研究的研究生、科研人员及工程技术人员。; 使用场景及目标：①解决无人地面车辆在已知全局路径下的局部动态避障问题；②学习并应用蚂蚁算法于实际路径规划任务中；③掌握Matlab环境下路径规划算法的建模与仿真方法； 阅读建议：建议读者结合提供的M
Delphi 13.1控件之chilkat-delphi-dyn.zip
12-14
Delphi 13.1控件之chilkat-delphi-dyn.zip
196ssm临大机械学院毕业设计管理系统_ssm临大机械学院毕业设计管理系统hsg4361B6论文HJS_X7Q3.docx
12-14
196ssm临大机械学院毕业设计管理系统_ssm临大机械学院毕业设计管理系统hsg4361B6论文HJS_X7Q3
pyqt接入萤石开放平台
10-12
要实现 PyQt 接入萤石开放平台，可以按以下步骤进行： ### 1. 注册与创建应用 在萤石开放平台注册账号，创建一个新的应用。创建成功后，会得到 `appKey` 和 `appSecret`，这两个信息在后续的开发中用于身份验证。 ### 2. 安装必要的库 使用 `pip` 安装所需的 Python 库，包括 `pyqt5` 用于创建 GUI 界面，`requests` 用于与萤石开放平台的 API 进行交互。 ```bash pip install pyqt5 requests ``` ### 3. 获取 accessToken accessToken 是调用萤石开放平台 API 的重要凭证，通过向开放平台的 `https://open.ys7.com/api/lapp/token/get` 接口发送请求获取。以下是示例代码： ```python import requests app_key = 'your_app_key' app_secret = 'your_app_secret' url = 'https://open.ys7.com/api/lapp/token/get' data = { 'appKey': app_key, 'appSecret': app_secret } response = requests.post(url, data=data) result = response.json() if result.get('code') == '200': access_token = result.get('data').get('accessToken') print(f"获取到的 accessToken: {access_token}") else: print(f"获取 accessToken 失败: {result.get('msg')}") ``` ### 4. 创建 PyQt 界面 使用 PyQt5 创建一个简单的 GUI 界面，用于显示从萤石开放平台获取的视频流或其他信息。以下是一个基本的 PyQt5 窗口示例： ```python import sys from PyQt5.QtWidgets import QApplication, QWidget app = QApplication(sys.argv) window = QWidget() window.setWindowTitle('PyQt 接入萤石开放平台') window.setGeometry(100, 100, 800, 600) window.show() sys.exit(app.exec_()) ``` ### 5. 调用萤石开放平台 API 获取设备信息 使用获取到的 `accessToken` 调用萤石开放平台的设备列表接口 `https://open.ys7.com/api/lapp/device/list`，获取已绑定的设备信息。示例代码如下： ```python url = 'https://open.ys7.com/api/lapp/device/list' headers = { 'Content-Type': 'application/x-www-form-urlencoded' } data = { 'accessToken': access_token } response = requests.post(url, headers=headers, data=data) result = response.json() if result.get('code') == '200': devices = result.get('data') print(f"获取到的设备列表: {devices}") else: print(f"获取设备列表失败: {result.get('msg')}") ``` ### 6. 显示视频流 若要在 PyQt 界面中显示设备的视频流，可以使用 `QMediaPlayer` 或其他视频播放库。需要先获取设备的视频地址，再进行播放。示例代码如下： ```python from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent from PyQt5.QtMultimediaWidgets import QVideoWidget from PyQt5.QtCore import QUrl # 创建 QMediaPlayer 和 QVideoWidget player = QMediaPlayer() video_widget = QVideoWidget() # 设置视频源 video_url = 'your_video_url' # 替换为实际的视频地址 media = QMediaContent(QUrl(video_url)) player.setMedia(media) player.setVideoOutput(video_widget) # 将 QVideoWidget 添加到 PyQt 窗口中 window.layout().addWidget(video_widget) # 播放视频 player.play() ``` ### 7. 错误处理与异常情况 在实际开发中，要对各种可能出现的错误情况进行处理，如网络请求失败、身份验证失败等。可以使用 `try-except` 语句捕获异常并进行相应的处理。 ### 8. 优化与扩展 根据具体需求，可以对界面进行美化，添加更多的交互功能，如设备控制、录像回放等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值