本文主要介绍使用 WVP
+ZLMediaKit
+MediaServerUI
实现通过 GB28181
进行海康、大华、宇视等品牌的 IPC
、NVR
、DVR
接入,完成摄像头监控播放,控制,录制。
准备工作
1.服务运行环境,Linux / OS X / Windows 均可,但推荐 Linux
2.海康云台摄像头一个
3.运行 sip
服务 WVP
https://github.com/swwheihei/wvp-GB28181
4.运行流媒体服务 ZLMediaKit
https://github.com/xiongziliang/ZLMediaKit
5.运行前端展示项目 MediaServerUI
https://gitee.com/kkkkk5G/MediaServerUI/tree/gb28181/
以上三个项目其实都有文档可供查看,因为踩了一些坑,所以写了本文,文章可能会写得比较细一点,建议结合它们的文档一起看。
运行 WVP
安装 Redis
WVP 项目中将设备信息等存放在 Redis 中,所以需要安装 Redis,安装教程请自行搜索。
配置运行 SIP
首先修改 WVP 项目配置文件:
spring: application: name: iot-vmp-vmanager # 影子数据存储方式,支持redis、jdbc database: redis # 通信方式,支持kafka、http communicate: http redis: # Redis服务器IP host: 127.0.0.1 #端口号 port: 6379 datebase: 0 #访问密码,若你的redis服务器没有设置密码,就不需要用密码去连接 password: 123123 #超时时间 timeout: 10000 datasource: name: eiot url: jdbc:mysql://host.docker.internal:3306/eiot?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true username: root password: 123456 type: com.alibaba.druid.pool.DruidDataSource driver-class-name: com.mysql.jdbc.Driversip: # SIP 所在服务IP,就是本机IP ip: 192.168.1.102 port: 5060 # 根据国标6.1.2中规定,domain宜采用ID统一编码的前十位编码。国标附录D中定义前8位为中心编码(由省级、市级、区级、基层编号组成,参照GB/T 2260-2007) # 后两位为行业编码,定义参照附录D.3 # 3701020049标识山东济南历下区 信息行业接入 domain: 3701020049 id: 37010200492000000002 # 默认设备认证密码,后续扩展使用设备单独密码 password: 123456media: # 流媒体服务的IP,内网测试可填内网IP,公网填公网服务器IP并放开端口 ip: 177.11.11.111 port: 10000
然后登录海康摄像头管理页面,修改配置:
平台接入选择 28181
;传输协议可自选,公网建议选择TCP;协议版本选择 GB/T28181-2016
(目前WVP只支持这个协议,2011后面会适配)
SIP服务器ID
和 SIP服务器域
,密码
要和 WVP
项目中配置的一致。
SIP服务器地址
填写 WVP
项目的地址,内网填写内网IP地址,云服务器填写公网IP,端口写配置文件中配置的端口。
因为摄像头平台接入配置好后,摄像头会请求 SIP 服务,所以这个一定要配置好。
配置完成后就可以运行项目了!如果 SIP 服务启动成功后,会看到这个日志 "Sip Server 启动成功":
如果摄像头连接到 SIP
服务,项目会有这样的日志,显示 200 OK(公网服务器记得放开sip端口):
建立好连接后,就可以控制查询摄像头了。
GET /api/devices
查询所有设备的信息
[ { "deviceId":"37010200492000000001", "name":"IP DOME", "manufacturer":"Hikvision", "model":"DS-2DC4223IW-D/GLT", "firmware":"V5.6.15", "transport":"TCP", "host":{ "ip":"192.168.1.101", "port":1609, "address":"192.168.1.101:1609" }, "online":1, "channelMap":{ "34020000001320000001":{ "channelId":"34020000001320000001", "name":"IPdome", "manufacture":"Hikvision", "model":"IP Camera", "owner":"Owner", "civilCode":"37010123123", "block":null, "address":"Address", "parental":0, "parentId":null, "safetyWay":0, "registerWay":1, "certNum":null, "certifiable":0, "errCode":0, "endTime":null, "secrecy":"0", "ipAddress":null, "port":0, "password":null, "status":1, "longitude":0, "latitude":0 } } }]
POST /api/ptz/{deviceId}/{channelId}
云台控制指定设备通道
http://127.0.0.1:8080/api/ptz/34020000001320000001/34020000001320000001?leftRight=1&upDown=0&inOut=0&moveSpeed=50&zoomSpeed=1
zoomSpeed 的数字不能太大,不然运行不了,无效。
WVP 项目所有接口:https://github.com/swwheihei/wvp-GB28181/wiki/API-%E6%8E%A5%E5%8F%A3
运行流媒体服务 ZLMediaKit
获取代码
#国内用户推荐从同步镜像网站gitee下载 git clone --depth 1 https://gitee.com/xiahcu/ZLMediaKitcd ZLMediaKit#千万不要忘记执行这句命令git submodule update --init
构建项目
项目开发者贴心的提供了三个shell脚本在项目根目录:
build_docker_images.sh 构建为docker镜像
build_for_linux.sh linux下构建项目
build_for_mac.sh mac下构建项目
打开以后可以看到是使用CMake来编译的,我们可以直接选择运行shell脚本,Windows的话就看文档)跟着一步步来吧?。
构建好后打开 release/xx/Debug
目录,可以看到有 config.ini
是项目的配置文件:https://github.com/xiongziliang/ZLMediaKit/blob/master/conf/config.ini
其中需要特别注意的有两个地方:
一是 [http] 的 port,因为 ZLMediaKit 项目也有很多 API 接口,都需要通过这个接口来访问,包括生成的播放的URL,都是这个端口,如遇到端口被你的其它服务占用,可自行配置。
二是 [rtp_proxy] 的 port,是我们上面 SIP 项目配置的 media.port
配置好了就可以运行项目了。
运行项目
Linux 下启动:
cd ZLMediaKit/release/linux/Debug#通过-h可以了解启动参数./MediaServer -h#以守护进程模式启动./MediaServer -d &
使用守护进程模式启动后,可以通过 ps -axj
来查看进程
运行成功后会打印出如下日志:
我们可以做下推流测试,非必须操作,不需要可直接跳到下一节“项目推流”,具体操作可以查看文档:https://github.com/xiongziliang/ZLMediaKit/wiki/ZLMediaKit%E6%8E%A8%E6%B5%81%E6%B5%8B%E8%AF%95
下载一个视频文件 big_buck_bunny.mp4
放在当前目录上,使用rtp方式推流试试,在文件所在目录输入命令(没安装ffmpeg的话需要先安装下):
ffmpeg -re -i "big_buck_bunny.mp4" -vcodec h264 -acodec aac -f rtp_mpegts rtp://127.0.0.1:10000
运行后,查看 ZLMediaKit 项目会有类似这样的日志:
使用可以播放流的播放器(如:PotPlayer,IINA)打开 http://服务器IP/rtp/xxxxx.flv
就能播放了。
如 http://服务器IP/rtp/061484E1.flv
项目推流
SIP
服务和流媒体服务以及就绪了,我们就可以推流了。
拿到 /api/devices
查到的 deviceId 和 channelId,然后调用 SIP
服务的播放接口
GET /api/play/37010200492000000001/34020000001320000001
预览指定设备通道的音视频
成功调用后会返回ssrc:
{"ssrc":"0102008033"}
ssrc 转换为16进制后为 061484E1
我们查看流媒体服务的日志,就能看到如下:
注:公网服务器如果没有收到推流日志,记得开放端口并检查 wvp
项目的 media
配置是否正确。
那我们怎么拿到播放地址呢?其实文档已经有了:https://github.com/xiongziliang/ZLMediaKit/wiki/%E6%92%AD%E6%94%BEurl%E8%A7%84%E5%88%99
如果我的公网IP是177.11.11.111,转换过来就是:
rtsp://177.11.11.111:554/rtp/061484E1?token=abcdefg&field=value
rtmp://177.11.11.111/rtp/061484E1
http://177.11.11.111/rtp/061484E1.flv
http://177.11.11.111/rtp/061484E1/hls.m3u8
此外 ZLMediaKit 还提供了录制,截图,动态添加拉流代理等功能,很棒,大家感兴趣可以看API文档。
运行MediaServerUI
拉下项目代码:https://gitee.com/kkkkk5G/MediaServerUI/tree/gb28181/
项目启动后,SIP
服务调用 play 接口,流媒体服务受到消息,在项目的“视频广场”中就能看到我们的视频了。
这个项目需要注意的也是配置,本项目是和流媒体服务关联的,调用的接口也是流媒体 ZLMediaKit 的 API。
打开项目根目录下的 global.js
:
const serverip="172.16.63.208"const host = 'http://' + serverip + '/index/api';const secret = '035c73f7-bb6b-4889-a715-d9eb2d1925cc';const baseMediaUrl='ws://' + serverip + '/';function genApiUrl(method){ return host+method+"?secret="+secret;}export default{ serverip, host, secret, genApiUrl, baseMediaUrl}
serverip是流媒体服务的IP,如果 ZLMediaKit 的配置文件中 [http] 配置项的端口改成了其它的,也记得在这里加上端口号(不同服务器请配置放开端口哦)。
secret
需要和流媒体服务配置的一样。
baseMediaUrl
是你拉流的url,你可以改成其它的,如 rtsp,rtmp,http。
整个视频请求的流程图
其中流媒体模块指 ZLMediaServer
,接口模块与信令模块指 WVP
,视频设备指 IPC、NVR
后记
最后感谢大佬们这么棒的开源项目,谢谢!