【开箱即用】GB28181 Python 对接:取流、存流、云台控制一篇讲透
【开箱即用】GB28181 Python 对接:取流、存流、云台控制一篇讲透
项目速览:给海康蓝盾平台做取流和云台控制的轻量工具
GB28181平台Python实现源码 是一套纯 Python 写的 GB28181 对接工具(GB28181 是国内视频联网的国标协议,摄像头和平台靠它"对话"),主要面向海康蓝盾这类视频联网平台。它能帮你做三件事:把平台下的设备信息查出来、把摄像头的视频流拉下来存成本地文件、再顺手把球机云台转一转。适合想给安防项目加"批量取流 + 录像归档"能力、又不想引入重型框架的工程师,三分钟就能跑起来。
核心能力
| 能力 | 一句话白话说明 |
|---|---|
| Catalog 设备信息查询 | 拉设备清单和在线状态 |
| 视频流预览与保存 | 收 RTP 流存成 H.264 文件 |
| 球机 PTZ 控制 | 控制台输数字转云台 |
快速上手:从解压到出画面的 5 步
- 环境备好:装好 Python,再装一下
bitstring依赖(收流时要按比特位解析包) - 📦 拿到源码:执行
git clone https://gitcode.com/open-source-toolkit/a3029,然后解压仓库里的GB28181-python-master.zip,全部代码都在压缩包里 - ⚙️ 改配置:编辑
config.txt,填上ip=和port=两行;再把代码里写死的平台地址、20 位设备编号替换成你自己环境的值 - 跑主程序
UDP_sip_copy.py:看到"注册成功"说明 SIP 握手通了,之后它会自动查设备清单,给目标摄像头发 INVITE 请求拉流 - 想控云台就另开终端跑
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 许可证,学习和二次开发都随意。
登录后查看全文