【开箱即用】GB28181 Python 对接:取流、存流、云台控制一篇讲透

原创2026-11-14 16:29:311,829 阅读

【开箱即用】GB28181 Python 对接:取流、存流、云台控制一篇讲透

项目速览:给海康蓝盾平台做取流和云台控制的轻量工具

GB28181平台Python实现源码 是一套纯 Python 写的 GB28181 对接工具(GB28181 是国内视频联网的国标协议,摄像头和平台靠它"对话"),主要面向海康蓝盾这类视频联网平台。它能帮你做三件事:把平台下的设备信息查出来、把摄像头的视频流拉下来存成本地文件、再顺手把球机云台转一转。适合想给安防项目加"批量取流 + 录像归档"能力、又不想引入重型框架的工程师,三分钟就能跑起来。

核心能力

能力 一句话白话说明
Catalog 设备信息查询 拉设备清单和在线状态
视频流预览与保存 收 RTP 流存成 H.264 文件
球机 PTZ 控制 控制台输数字转云台

快速上手:从解压到出画面的 5 步

  1. 环境备好:装好 Python,再装一下 bitstring 依赖(收流时要按比特位解析包)
  2. 📦 拿到源码:执行 git clone https://gitcode.com/open-source-toolkit/a3029,然后解压仓库里的 GB28181-python-master.zip,全部代码都在压缩包里
  3. ⚙️ 改配置:编辑 config.txt,填上 ip= 和 port= 两行;再把代码里写死的平台地址、20 位设备编号替换成你自己环境的值
  4. 跑主程序 UDP_sip_copy.py:看到"注册成功"说明 SIP 握手通了,之后它会自动查设备清单,给目标摄像头发 INVITE 请求拉流
  5. 想控云台就另开终端跑 PTZ.py:按提示输入方向码(1~9 转方向、16 放大、32 缩小),设备回 ACK 即说明指令生效

关键配置速查:这几个地方必须动

配置项 作用说明 示例值
config.txt 的 ip= 本机 SIP 注册与收流的 IP 192.168.60.10
config.txt 的 port= 本机 SIP 信令端口 7778
设备编号(device_dict / sb_id) 取流和云台控制目标的 20 位国标编号 18062804121310234425
平台地址(PTZ.py 内写死) SIP 控制指令发往的 SIP 服务器 192.168.60.5:7100

⚠️ 避坑提示:新手最常卡住的 4 处

  • 注册一直转圈不成功 → 摄像头没正确注册到 SIP 服务器,或 config.txt 的 IP/端口填错 → 先核对设备侧的 SIP 域、服务器地址,再确认本机端口可达
  • 存下来的视频双击打不开 → h264.py 保存的是裸 H.264 码流 .dat 文件,不是 mp4 容器 → 换 VLC 这类支持裸流的播放器打开
  • 云台指令发出去没反应 → PTZ.py 里的平台 IP、端口、设备编号都是示例值,写死在代码里 → 全部改成实际参数再跑
  • 设备查出来了却不拉流 → 主程序只处理编号前缀为 12、13 或以 5 开头的设备 → 检查一下 20 位设备编码的开头几位

延伸阅读

源码全部装在 GB28181-python-master.zip 里,压缩包里还附带 GB28181 标准两份 PDF,方便对照实现细节:

社区与协议

发现 bug 或有改进想法,可以直接向项目提 Issue 或 Pull Request;项目采用 MIT 许可证,学习和二次开发都随意。

登录后查看全文
GB28181平台Python实现源码