本文主要介绍使用 WVP+ZLMediaKit+MediaServerUI 实现通过 GB28181 进行海康、大华、宇视等品牌的 IPC、NVR 、DVR 接入，完成摄像头监控播放，控制，录制。
一、概念
NVR是（Network Video Recorder即网络硬盘录像机）缩写。NVR主要功能是通过网络接收IPC（网络摄像机）设备传输的数字视频码流， 并进行存储、管理。 简单说，通过Nvr，可以同时观看、浏览、回放、管理、存储多个网络摄像机。
dvr是(Digital Video Recorder即数字视频录像机)，采用硬盘录像，常被称为硬盘录像机，也称DVR。它是一套图像计算存储处理的计算机系统，具有对图像/语音和动态帧等进行长时间录像、录音、远程监视和控制的功能，DVR集合录像机、画面分割器、云台镜头控制、报警控制、网络传输等五种功能于一身，用一台设备就能取代模拟监控系统一大堆的设备，且在价格上也逐渐占有优势和人气。
DVR将模拟视频进行数字化编码压缩并储存在硬盘上，其“D”字母主要涉及的是编码及储存技术，与网络传输关系不大，因此DVR通常就近安装在模拟摄像机附近的机房内。而NVR从网络上获取经过编码压缩的视频流然后进行存储转发，其字母“N”涉及的网络传输，因此我们在NVR设备上一般看不到视频信号的直接连接，其输入及输出的都是以及编码并添加了网络协议的IP数据。
ipc是IP Camera缩写词，IP是网际协议，Camera是照相机、摄影机，IP Camera顾名思义就是网络摄像机，它是一种由传统摄像机与网络技术结合所产生的新一代摄像机。
网络摄像机又叫IP CAMERA（简称IPC）由网络编码模块和模拟摄像机组合而成。网络编码模块将模拟摄像机采集到的模拟视频信号编码压缩成数字信号，从而可以直接接入网络交换及路由设备。
二、准备工作
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
3.1 安装 Redis
WVP 项目中将设备信息等存放在 Redis 中，所以需要安装 Redis，安装教程请自行搜索。
3.2 配置运行 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.Driver
sip:
# 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: 123456
media:
# 流媒体服务的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
4.1 获取代码
#国内用户推荐从同步镜像网站gitee下载
git clone --depth 1 https://gitee.com/xiahcu/ZLMediaKit
cd ZLMediaKit
#千万不要忘记执行这句命令
git submodule update --init
4.2 构建项目
项目开发者贴心的提供了三个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
配置好了就可以运行项目了。
4.3 运行项目
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
