diff --git a/.github/ISSUE_TEMPLATE/solve.md b/.github/ISSUE_TEMPLATE/solve.md
index 75a0eed76..473dbd19f 100644
--- a/.github/ISSUE_TEMPLATE/solve.md
+++ b/.github/ISSUE_TEMPLATE/solve.md
@@ -16,7 +16,7 @@ assignees: ''
- 5. 是否使用https
- 6. 方便的话提供下使用的设备品牌或平台
- 7. 你做过哪些尝试
- - 8. 代码更新时间
+ - 8. 代码更新时间(旧版本请更新最新版本代码测试)
**内容描述:**
diff --git a/README.md b/README.md
index 4f09aba7c..22551a054 100644
--- a/README.md
+++ b/README.md
@@ -39,7 +39,6 @@ https://gitee.com/pan648540858/wvp-GB28181-pro.git



-

# 功能特性
diff --git a/doc/README.md b/doc/README.md
index cdf3a0810..c5c4006db 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -3,11 +3,15 @@
> 开箱即用的28181协议视频平台
# 概述
-- WVP-PRO基于GB/T 28181-2016标准实现的流媒体平台,依托优秀的开源流媒体服务[ZLMediaKit](https://github.com/ZLMediaKit/ZLMediaKit),提供完善丰富的功能。
+
+- WVP-PRO基于GB/T
+ 28181-2016标准实现的流媒体平台,依托优秀的开源流媒体服务[ZLMediaKit](https://github.com/ZLMediaKit/ZLMediaKit)
+ ,提供完善丰富的功能。
- GB/T 28181-2016 中文标准名称是《公共安全视频监控联网系统信息传输、交换、控制技术要求》是监控领域的国家标准。大量应用于政府视频平台。
- 通过28181协议你可以将IPC摄像头接入平台,可以观看也可以使用28181/rtsp/rtmp/flv等协议将视频流分发到其他平台。
# 特性
+
- 实现标准的28181信令,兼容常见的品牌设备,比如海康、大华、宇视等品牌的IPC、NVR以及平台。
- 支持将国标设备级联到其他国标平台,也支持将不支持国标的设备的图像或者直播推送到其他国标平台
- 前端完善,自带完整前端页面,无需二次开发可直接部署使用。
@@ -15,92 +19,94 @@
- 支持多流媒体节点负载均衡。
# 付费社群
+
[](https://t.zsxq.com/0d8VAD3Dm)
> 收费是为了提供更好的服务,也是对作者更大的激励。加入星球的用户三天后可以私信我留下微信号,我会拉大家入群。加入三天内不满意可以直接退款,大家不需要有顾虑,来白嫖三天也不是不可以。
# 我们实现了哪些国标功能
+
**作为上级平台**
+
- [X] 注册
- [X] 注销
- [X] 实时视音频点播
- [X] 设备控制
- - [X] 云台控制
- - [X] 远程启动
- - [X] 录像控制
- - [X] 报警布防/撤防
- - [X] 报警复位
- - [X] 强制关键帧
- - [X] 拉框放大
- - [X] 拉框缩小
- - [X] 看守位控制
- - [X] 设备配置
+ - [X] 云台控制
+ - [X] 远程启动
+ - [X] 录像控制
+ - [X] 报警布防/撤防
+ - [X] 报警复位
+ - [X] 强制关键帧
+ - [X] 拉框放大
+ - [X] 拉框缩小
+ - [X] 看守位控制
+ - [X] 设备配置
- [X] 报警事件通知和分发
- [X] 设备目录订阅
- [X] 网络设备信息查询
- - [X] 设备目录查询
- - [X] 设备状态查询
- - [X] 设备配置查询
- - [X] 设备预置位查询
+ - [X] 设备目录查询
+ - [X] 设备状态查询
+ - [X] 设备配置查询
+ - [X] 设备预置位查询
- [X] 状态信息报送
- [X] 设备视音频文件检索
- [X] 历史视音频的回放
- - [X] 播放
- - [X] 暂停
- - [X] 进/退
- - [X] 停止
+ - [X] 播放
+ - [X] 暂停
+ - [X] 进/退
+ - [X] 停止
- [X] 视音频文件下载
- [X] 校时
- [X] 订阅和通知
- - [X] 事件订阅
- - [X] 移动设备位置订阅
- - [X] 报警订阅
- - [X] 目录订阅
+ - [X] 事件订阅
+ - [X] 移动设备位置订阅
+ - [X] 报警订阅
+ - [X] 目录订阅
- [X] 语音广播
- [X] 语音喊话
**作为下级平台**
+
- [X] 注册
- [X] 注销
- [X] 实时视音频点播
- [X] 设备控制
- - [X] 云台控制
- - [ ] 远程启动
- - [X] 录像控制
- - [X] 报警布防/撤防
- - [X] 报警复位
- - [X] 强制关键帧
- - [X] 拉框放大
- - [X] 拉框缩小
- - [X] 看守位控制
- - [ ] 设备配置
+ - [X] 云台控制
+ - [ ] 远程启动
+ - [X] 录像控制
+ - [X] 报警布防/撤防
+ - [X] 报警复位
+ - [X] 强制关键帧
+ - [X] 拉框放大
+ - [X] 拉框缩小
+ - [X] 看守位控制
+ - [ ] 设备配置
- [ ] 报警事件通知和分发
- [X] 设备目录订阅
- [X] 网络设备信息查询
- - [X] 设备目录查询
- - [X] 设备状态查询
- - [ ] 设备配置查询
- - [X] 设备预置位查询
+ - [X] 设备目录查询
+ - [X] 设备状态查询
+ - [ ] 设备配置查询
+ - [X] 设备预置位查询
- [X] 状态信息报送
- [X] 设备视音频文件检索
- [X] 历史视音频的回放
- - [X] 播放
- - [x] 暂停
- - [x] 进/退
- - [x] 停止
+ - [X] 播放
+ - [x] 暂停
+ - [x] 进/退
+ - [x] 停止
- [X] 视音频文件下载
- [ ] ~~校时~~
- [X] 订阅和通知
- - [X] 事件订阅
- - [X] 移动设备位置订阅
- - [ ] 报警订阅
- - [X] 目录订阅
+ - [X] 事件订阅
+ - [X] 移动设备位置订阅
+ - [ ] 报警订阅
+ - [X] 目录订阅
- [X] 语音广播
- [X] 语音喊话
-
-
-
# 社区
+
代码目前托管在GitHub和Gitee,Gitee目前作为加速仓库使用,不接受issue。
GitHub: [https://github.com/648540858/wvp-GB28181-pro](https://github.com/648540858/wvp-GB28181-pro)
Gitee: [https://gitee.com/pan648540858/wvp-GB28181-pro](https://gitee.com/pan648540858/wvp-GB28181-pro)
\ No newline at end of file
diff --git a/doc/_content/ability/_media/img_16.png b/doc/_content/ability/_media/img_16.png
index b09e8cd39..5a27be09b 100644
Binary files a/doc/_content/ability/_media/img_16.png and b/doc/_content/ability/_media/img_16.png differ
diff --git a/doc/_content/ability/_media/img_17.png b/doc/_content/ability/_media/img_17.png
index 02b303e36..483d522a3 100644
Binary files a/doc/_content/ability/_media/img_17.png and b/doc/_content/ability/_media/img_17.png differ
diff --git a/doc/_content/ability/_media/img_18.png b/doc/_content/ability/_media/img_18.png
index 5ca4faf9d..3b33b2189 100644
Binary files a/doc/_content/ability/_media/img_18.png and b/doc/_content/ability/_media/img_18.png differ
diff --git a/doc/_content/ability/auto_play.md b/doc/_content/ability/auto_play.md
index 5259e0b52..2ce30120f 100644
--- a/doc/_content/ability/auto_play.md
+++ b/doc/_content/ability/auto_play.md
@@ -1,2 +1,3 @@
+
# 自动点播
diff --git a/doc/_content/ability/cascade.md b/doc/_content/ability/cascade.md
index 7942bda4b..0766a7a93 100644
--- a/doc/_content/ability/cascade.md
+++ b/doc/_content/ability/cascade.md
@@ -1,34 +1,56 @@
+
# 国标级联的使用
+
国标28181不同平台之间支持两种连接方式,平级和上下级,WVP目前支持向上级级联。
+
## 1 接入平台
+
### 1.1 wvp-pro
+
#### 1.1.1 wvp-pro管理页面点击添加
- 
+
+
+
#### 1.1.2 填入wvp-pro上级平台信息
- 
- 
+
+
+
+
#### 1.1.3 编辑wvp-pro上级设备信息,开启订阅
- 
+
+
+
### 1.2 大华平台
+
### 1.3 海康平台
+
### 1.4 liveGBS
-#### 1.4.1. wvp-pro管理页面点击添加
- 
-#### 1.4.2. 填入liveGBS平台信息
- 
- 
-#### 1.4.3. 编辑liveGBS设备信息,开启目录订阅
- 
-#### 1.4.4. 编辑liveGBS设备信息,开启GPS订阅
- 
+
+#### 1.4.1. wvp-pro管理页面点击添加
+
+
+
+#### 1.4.2. 填入liveGBS平台信息
+
+
+
+
+#### 1.4.3. 编辑liveGBS设备信息,开启目录订阅
+
+
+
+#### 1.4.4. 编辑liveGBS设备信息,开启GPS订阅
+
+
## 2 添加目录与通道
+
1. 级联平台添加目录信息

2. 为目录添加通道

3. 设置默认流目录
-如果需要后续自动生成的流信息都在某一个节点下,可以在对应节点右键设置为默认
+ 如果需要后续自动生成的流信息都在某一个节点下,可以在对应节点右键设置为默认

diff --git a/doc/_content/ability/cascade2.md b/doc/_content/ability/cascade2.md
index 7bd6c7929..00f4fcb59 100644
--- a/doc/_content/ability/cascade2.md
+++ b/doc/_content/ability/cascade2.md
@@ -1,18 +1,71 @@
+
# 国标级联的使用
+
国标28181不同平台之间支持两种连接方式,平级和上下级,WVP目前支持向上级级联。
+
## 添加上级平台
+
在国标级联页面点击“添加”按钮,以推送到上级WVP为例子,参看[接入设备](./_content/ability/device.md)

-点击保存可以在上级的国标通道列表看到新增加的设备;
+
+1. 名称
+ 上级平台看到的下级平台名称;
+2. 本地IP
+ 本地连接上级使用的具体哪个网卡;
+3. SIP认证用户名
+ 可以设置为与"设备国标编号"一致;
+4. 注册周期
+ 间隔多久发起一次注册,单位秒;
+5. 心跳周期
+ 间隔多久发送一次心跳,一般上级平台三次收不到心跳就会认为下级离线了, 所以建议{心跳周期}x3 < 注册周期;
+6. SDP发流IP
+ 调用媒体节点发送视频流给上级时,使用的本地IP;
+7. 信令传输
+ 信令传输模式,支持udp和TCP,没有特殊需求,默认UDP即可;
+8. 目录分组
+ 上级发送"CATALOG"消息查询通道信息,每一条消息中携带几条通道信息,默认为1,增大该值,可以加快通道发送速度;
+9. 字符集
+ 发送给上级"MESSAGE"消息中的消息体使用的编码格式,国标28181-2016默认为GB2312;
+10. 行政区划
+ 如果勾选"其他选项/推送平台信息"选项,会给上级推送平台信息,这里就是平台的行政区划信息
+11. 平台厂商
+ 如果勾选"其他选项/推送平台信息"选项,会给上级推送平台信息,这里就是平台的平台厂商信息
+12. 平台型号
+ 如果勾选"其他选项/推送平台信息"选项,会给上级推送平台信息,这里就是平台的平台型号信息
+13. 平台安装地址
+ 如果勾选"其他选项/推送平台信息"选项,会给上级推送平台信息,这里就是平台的平台安装地址信息
+14. 其他选项
+ - RTCP保活
+ 在上级的流传输模式为UDP时,因为UDP的无状态特性,会无法知道上级是否在正常收流,启用RTCP保活时,就可以主动发送RTCP消息确认上级是否在正常收流,
+ 异常情况下,可以下级主动停止发流;
+ - 消息通道
+ 支持通过报警消息给上级级WVP推送消息,消息内容由redis消息发送给wvp,wvp编辑成报警消息发送给上级;
+ - 主动推送通道
+ WVP模拟一条目录订阅信息,然后在共享通道变化时,发送CATAOLOG事件给上级,通知具体的通道变化,
+ 目前支持的状态有: 状态改变事件 ON:上线,OFF:离线,VLOST:视频丢失,DEFECT:故障,ADD:增加,DEL:删除,UPDATE:更新;
+ - 推送平台信息
+ 勾选此项,上级收到的通道信息中会多出一个平台信息的通道.内容在平台的编辑中修改;
+ - 推送分组信息
+ 勾选此项,如果你共享的通道分配了具体的业务分组以及虚拟组织,那么上级收到的通道中会包括业务分组以及虚拟组织节点信息;
+ - 推送行政区划
+ 勾选此项,如果你共享的通道分配了具体的行政区划,那么上级收到的通道中会包括行政区划信息;
+
国标级联列表出现了级联的这个平台;同时状态显示为在线,如果状态为离线那么可能是你的服务信息配置有误或者网络不通。
订阅信息列有三个图标,表示上级开启订阅,从左到右依次是:报警订阅,目录订阅,移动位置订阅。
-## 推送通道
-点击你要推送的平台的“选择通道”按钮。
+
+## 通道共享
+
+点击你要推送的平台的“通道共享”按钮。

-- **页面结构**
- - 左侧为目录结构
- 选择未分配,则右侧显示待分配的通道,可以点击“添加按钮”,在弹窗中选择要放置的位置,保存后即可添加通道成功
- 选择其他的目录可以看到已经分配在这个目录下的通道,可以对其进行删除后重新在未分配中去分配。
- - 右侧为数据展示以及操作
- 国标通道栏内为来自其他国标设备/平台的通道;直播流通道为来自推流/拉流代理的通道。
\ No newline at end of file
+
+1. 添加状态选择"未共享"可以将具体的通道共享给上级;
+2. 添加状态选择"已共享"可以看到已经共享的通道,并且支持为这个通道在这个平台设备专门的名称和编号;
+3. 点击"按设备添加"可以将某个国标设备下的所有通道共享给上级;
+4. 点击"按设备移除"可以将某个国标设备下的所有通道取消共享给上级;
+5. 点击"全部添加"可以将所有通道共享给上级;
+6. 点击"全部移除"可以将所有通道共享给上级;
+
+## 推送通道
+
+WVP会将所有通道信息按照目录订阅消息通知形式,发送ADD事件给上级.
\ No newline at end of file
diff --git a/doc/_content/ability/channel.md b/doc/_content/ability/channel.md
new file mode 100644
index 000000000..adfe0ee76
--- /dev/null
+++ b/doc/_content/ability/channel.md
@@ -0,0 +1,22 @@
+# 通道管理
+
+通道管理为了对已经分配国标编号的通道进行统一的行政区划和业务分组管理,国标中对于组织结构有两种表示方式,一种是按照行政区划,一种是业务分组+虚拟组织的方式.
+行政区划结构固定,比如: 北京/市辖区/昌平区, 通道可以挂载道何一级行政区划下. 业务分组比较灵活, 可以按照自己的随意取名,
+但是通道只能放在业务分组下的虚拟组织里,不能放在业务分组下.
+
+## 行政区划
+
+左侧树结构为行政区划结构, 通过数据鼠标右键可以操作,包括: 刷新节点,新建节点,编辑节点,删除节点,添加设备(
+可以将某个国标设备下的通道全部添加道某一个节点下),移除设备(可以将某个国标设备下的通道全部从这个节点移除)
+右侧伪通道列表, 对于非国标接入的设备只有配置了国标编号后才可以在这里进行操作, 添加状态选择"未添加"可以进行添加操作,选择"
+已添加"进行移除操作
+
+
+## 业务分组
+
+左侧树结构为业务分组结构, 通过数据鼠标右键可以操作,包括: 刷新节点,新建节点,编辑节点,删除节点,添加设备(
+可以将某个国标设备下的通道全部添加道某一个节点下),移除设备(可以将某个国标设备下的通道全部从这个节点移除)
+业务分组下不能挂载设备,所以没有选择该节点的单选框.
+右侧伪通道列表, 对于非国标接入的设备只有配置了国标编号后才可以在这里进行操作, 添加状态选择"未添加"可以进行添加操作,选择"
+已添加"进行移除操作
+
\ No newline at end of file
diff --git a/doc/_content/ability/cloud_record.md b/doc/_content/ability/cloud_record.md
index 0aa55e1e5..716a614fe 100644
--- a/doc/_content/ability/cloud_record.md
+++ b/doc/_content/ability/cloud_record.md
@@ -1,8 +1,13 @@
+
# 云端录像
+
+
云端录像是对录制在zlm服务下的录像文件的管理,录像的文件路径默认在ZLM/www/record下。
-如果你需要24小时的录像,目前有一个这种方案,可以参考[7*24不间断录像](./_content/ability/continuous_recording.md)。
-1. 云段录像支持录像文件的查看,播放(可能因为编码的原因导致无法播放);
-2. 支持录像的下载;
-3. 支持录像的合并下载;
-功能没有太多特殊的地方就不一一介绍了,大家自行体验吧。
+
+- 国标设备是否录像: 可以再WVP的配置中user-settings.record-sip设置为true那么每次点播以及录像回放都会录像;
+- 推流设备是否录像: 可以再WVP的配置中user-settings.record-push-live设置为true;
+- 拉流代理的是否录像: 在添加和编辑拉流代理时可以指定, 每次点播都会进行录像
+- 录像文件存储路径配置: 可以修改media.record-path来修改录像路径,但是如果有旧的录像文件,请不要迁移,因为数据库记录了每一个录像的绝对路径,一旦修改会造成找到文件,无法定时移除以及播放
+- 录像保存时间: 可以修改media.record-day来修改录像保存时间,单位是天;
+
diff --git a/doc/_content/ability/continuous_broadcast.md b/doc/_content/ability/continuous_broadcast.md
index 7af3afeb0..06708e779 100644
--- a/doc/_content/ability/continuous_broadcast.md
+++ b/doc/_content/ability/continuous_broadcast.md
@@ -1,9 +1,13 @@
# 语音对讲
+
## 流程和原理
+
语音对讲在国标28181-2016中分为broadcast(广播)和talk(对讲)两种模式,broadcast模式是从服务端把音频传送到设备端,是单向的,
需要结合点播视频来实现双向对讲,talk模式支持双向,不过wvp只处理了和broadcast一样的把音频传递设备,这样两种模式可以使用一样的逻辑处理即可。
不同的设备对于两种模式的支持不同且通常差异很大,不同的设备对同一个设备的支持也有一些不同,所以语音对讲中的兼容和适配也是问题最多的。talk模式因为在国标28181-2022中已经移除,所以这里不再讨论它了。
+
### 1. broadcast模式流程
+
```plantuml
@startuml
"WVP-PRO" -> "设备": 语音广播通知
@@ -16,24 +20,33 @@
"ZLMediaKit" -> "设备": 向设备发送语音流
@enduml
```
+
与点播的流程不同的是,这里的invite消息是由设备发送给wvp的,wvp按照invite协商的方式给设备推送语音流,所有对讲的使用那种方式(UDP/TCP被动/TCP主动)传输语音流由设备决定
+
## 使用条件与限制
-因为invite消息是由设备发送给wvp的,这决定了发送语音流的方式,这也就决定了有的设备不能用于公网对讲,比如大部分的海康设备只支持udp方式收流(目前新版的海康设备已经在着手解决这个问题),那么wvp发流时只能按照sdp中指定的ip端口发流,所以如果wvp在公网,设备在内网中,那么wvp无法连接设备提供的IP,发流也就失败了。
+
+因为invite消息是由设备发送给wvp的,这决定了发送语音流的方式,这也就决定了有的设备不能用于公网对讲,比如大部分的海康设备只支持udp方式收流(
+目前新版的海康设备已经在着手解决这个问题),那么wvp发流时只能按照sdp中指定的ip端口发流,所以如果wvp在公网,设备在内网中,那么wvp无法连接设备提供的IP,发流也就失败了。
与海康不同的,大华以及很多执法记录仪厂商是支持tcp主动方式取流的,这样是可以实现公网对讲的。
-
## 使用ffmpeg快速测试
+
由于浏览器对于音频的采集需要网页支持https才可以,所以如果想要实现网页音频对讲,那么你必须给wvp和zlm配置证书以使用https。
测试阶段如果只是想测试功能可以用ffmpeg来模拟语音流,推送到wvp后可以实现把音频文件推送到摄像头。
测试命令格式如下:
+
```shell
ffmpeg -re -i {音频文件} -acodec pcm_alaw -ar 8000 -ac 1 -f rtsp 'rtsp://{zlm的IP}:{zlm的RTSP端口}/broadcast/{设备国标编号}_{通道国标编号}?sign={md5(pushKey)}'
```
+
例如
+
```shell
ffmpeg -re -i test.mp3 -acodec pcm_alaw -ar 8000 -ac 1 -f rtsp 'rtsp://192.168.1.3:22554/broadcast/34020000001320000001_34020000001320000001?sign=41db35390ddad33f83944f44b8b75ded'
```
+
测试流程如下:
+
```plantuml
@startuml
"FFMPEG" -> "ZLMediaKit": 推流到zlm
@@ -44,33 +57,48 @@ ffmpeg -re -i test.mp3 -acodec pcm_alaw -ar 8000 -ac 1 -f rtsp 'rtsp://192.168.1
"ZLMediaKit" -> "设备": 向设备推流
@enduml
```
+
如果听到设备播放你推送的音频,那么意味着调用成功,此过程推流即可需要调用任何接口
+
## 生产环境网页发起语音对讲
+
生产环境下使用语音对讲,如果是自己的客户端设备那么直接上面的ffmpeg测试方式,按照固定格式推流到zlm即可。
对于WEB程序,主要是局域网和公网的区别,两个原因:
+
1. 很多设备不支持公网对讲
2. 公网和局域网获取证书实现https支持的方式不同
+
### 公网使用
+
公网你可以直接使用证书厂商或者云服务器厂商提供的证书,这是很方便的。
+
### 局域网使用
+
局域网你需要为wvp和zlm生成自签名证书,这里我推荐一种生成自签名证书相对方便的方式,
此方式为linux下的一种方式。
下载证书生成工具:
[https://github.com/FiloSottile/mkcert/releases/tag/v1.4.4](https://github.com/FiloSottile/mkcert/releases/tag/v1.4.4)
安装此工具, 进入解压的工具目录,执行
+
```shell
./mkcert-v1.4.4-linux-amd64 -install
```
+
生成pem证书
+
```shell
./mkcert-v1.4.4-linux-amd64 局域网IP 局域网IP2 局域网IP3
```
+
你会得到两文件*-key.pem和*.pem, 此文件配置到wvp后既可实现证书的加载
生成zlm使用的证书
+
```shell
cat *.pem *-key.pem> ./zlm.pem
```
+
得到的文件就是可以给zlm使用的证书
zlm下使用证书有两种方式:
+
1. 替换zlm下的default.pem, 即删除此文件并把zlm.pem重命名为default.pem
2. 在启动zlm的使用添加 `-s zlm.pem`
\ No newline at end of file
diff --git a/doc/_content/ability/continuous_recording.md b/doc/_content/ability/continuous_recording.md
index 516830fde..78c1ae58c 100644
--- a/doc/_content/ability/continuous_recording.md
+++ b/doc/_content/ability/continuous_recording.md
@@ -1,14 +1,16 @@
+
# 7*24不间断录像
-目前如果要实现不间断录像如果只是关闭无人观看停止推流是不够的,设备可能经历断网,重启,都会导致录像的中断,目前给大家提供一种可用的临时方案。
+目前如果要实现不间断录像如果只是关闭无人观看停止推流是不够的,设备可能经历断网,重启,都会导致录像的中断,目前给大家提供一种可用的临时方案。
**原理:** wvp支持使用流地址自动点播,即你拿到一个流地址直接去播放,即使设备处于未点播状态,wvp会自动帮你点播;ZLM
的拉流代理成功后会无限重试,只要流一恢复就可以拉起来,基于这两个原理。
**方案如下:**
+
1. wvp的配置中user-settings->auto-apply-play设置为团true,开启自动点播;
2. 点击你要录像的通道,点击播放页面左下角的“更多地址”,点击rtsp,此时复制了rtsp地址到剪贴板;
3. 在拉流代理中添加一路流,地址填写你复制的地址,启用成功即可。
-**前提:**
+ **前提:**
1. wvp使用多端口收流,不然你无法得到一个固定的流地址,也就无法实现自动点播。
diff --git a/doc/_content/ability/device.md b/doc/_content/ability/device.md
index 134f7add0..cc604576f 100644
--- a/doc/_content/ability/device.md
+++ b/doc/_content/ability/device.md
@@ -1,33 +1,68 @@
+
# 接入设备
-设备接入主要是需要在设备上配置28181上级也就是WVP-PRO的信息,只有信息一致的情况才可以注册成功。设备注册成功后打开WVP->国标设备,可以看到新增加的设备;[设备使用](./_content/ability/device_use.md),
-主要有以下字段需要配置:
+
+## 国标28181设备
+
+设备接入主要是需要在设备上配置28181上级也就是WVP-PRO的信息,只有信息一致的情况才可以注册成功。设备注册成功后打开WVP->
+国标设备,可以看到新增加的设备;[设备使用](./_content/ability/device_use.md),
+主要有以下字段需要配置:
- sip->port
-28181服务监听的端口
+ 28181服务监听的端口
- sip->domain
-domain宜采用ID统一编码的前十位编码。
+ domain宜采用ID统一编码的前十位编码。
- sip->id
-28181服务ID
+ 28181服务ID
- sip->password
-28181服务密码
+ 28181服务密码
-- 配置信息在如下位置
+- 配置信息在如下位置

***
-## 大华摄像头
+
+### 1. 大华摄像头
+

-## 大华NVR
+
+### 2. 大华NVR
+

-## 艾科威视摄像头
+
+### 3. 艾科威视摄像头
+

-## 水星摄像头
+
+### 4. 水星摄像头
+

-## 海康摄像头
+
+### 5. 海康摄像头
+

+## 直播推流设备
+
+这里以obs推流为例,很多无人机也是一样的,设置下推流地址就可以接入了
+
+1. 从wvp获取推流地址, 选择节点管理菜单,查看要推流的节点;
+ 
+2. 拼接推流地址
+ 得到的rtsp地址就是: rtsp://{流IP}:{RTSP PORT}/{app}/{stream}
+ 得到的rtmp地址就是: rtsp://{流IP}:{RTMP PORT}/{app}/{stream}
+ 其中流IP是设备可以连接到zlm的IP,端口是对应协议的端口号, app和stream自己定义就可以.
+3. 增加推流鉴权信息
+ wvp默认开启推流鉴权,拼接好的地址是不能直接推送的,会被返回鉴权失败,参考[推流规则](_content/ability/push?id=推流规则)
+4. 推流成功后可以再推流列表中看到推流设备,可以播放
+ 此方式只支持设备实时流的播放,无其他功能, 推流信息在推流结束后会自动移除,在列表里就看不到了,如果需要推流信息需要为设备配置国标编号,这样才可以作为wvp的一个永久通道存在.
+
+## 接入非国标IPC设备或者其他流地址形式的设备
+
+这类设备的接入主要通过拉流代理的方式接入,原理就是zlm主动像播放器一样拉取这个流缓存在自己服务器供其他人播放.可以解决源设备并发访问能力差的问题.
+在拉流代理/添加代理后可以直接播放, 拉流代理也是同样只支持播放当前配置的流.
+
[设备使用](_content/ability/device_use.md)
diff --git a/doc/_content/ability/device_use.md b/doc/_content/ability/device_use.md
index c406b3bbb..6cb54dc10 100644
--- a/doc/_content/ability/device_use.md
+++ b/doc/_content/ability/device_use.md
@@ -1,21 +1,30 @@
-# 设备使用
-### 更新设备通道
- 点击列表末尾的“刷新”按钮,可以看到一个圆形进度条,等进度结束提示成功后即可更新完成,如果通道数量有变化你可以看点击左上角的即可看到通道数量的变化;如果通道数量仍未0,那么可能时对方尚未推送通道给你。
-### 查看设备通道
- 点击列表末尾的“通道”按钮,
-### 查看设备定位
- 点击列表末尾的“定位”按钮,即可跳转到地图页面看到设备的位置
-### 编辑设备在WVP中一些功能
+
+# 国标设备
+
+### 更新设备通道
+
+点击列表末尾的“刷新”按钮,可以看到一个圆形进度条,等进度结束提示成功后即可更新完成,如果通道数量有变化你可以看点击左上角的
+即可看到通道数量的变化;如果通道数量仍未0,那么可能时对方尚未推送通道给你。
+
+### 查看设备通道
+
+点击列表末尾的“通道”按钮,
+
+### 编辑设备
+
点击列表末尾的“编辑”按钮,即可在打开的弹窗中对设备功能进行修改
+
- 设备名称
如何未能从设备里读取到设备名称或者需要自己重命名,那么可以修改此选项。
+- 密码
+ 支持为设备配置独立的密码.
+- 收流IP
+ 如果你需要设备从指定的网络地址接入视频流,那么可以配置此IP,设备将会发流到这个IP,比如多网卡接入的服务器.或者存在网络映射的情况.
+- 流媒体ID
+ 固定设备使用的流媒体ID,默认根据负载自动分配.
- 字符集
修改读取设备数据时使用的字符集,默认为GB2312,但是GB2312收录的汉字不全,所以有时候回遇到乱码,可以修改为UTF-8来解决。
-- 地理坐标系
- 展示此设备定位信息时使用的设用什么坐标系来解析经纬度,一般不用修改,如果遇到定位不准,可以修改尝试修改此选项解决。
-- 目录结构
- 展示设备的通道信息时,使用设备作为树形结构的依据,国标28181定义了两种树形结构,详情查看[国标28181的树形结构](./_content/theory/channel_tree.md);
- 目录订阅
填写订阅周期即可对设备开启目录订阅,设备如果支持目录订阅那么设备在通道信息发生变化时就会通知WVP哪些通道发生了那些变化,包括通道增加/删除/更新/上线/下线/视频丢失/故障。0为取消订阅。
一般NVR和平台对接可以开启此选项,直接接摄像机开启此选项意义不大。
@@ -23,13 +32,31 @@
对设备开启移动位置订阅,设备如果支持目录订阅那么设备位置发生变化时会通知到WVP,一般执法记录仪可以开启此选项,对固定位置的设备意义不大。
- SSRC校验
为了解决部分设备出现的串流问题,可以打开此选项。ZLM会严格按照给定的ssrc处理视频流。部分设备流信息不标准,开启可能导致无法点播。
-### 删除设备
- 可以删除WVP中的设备信息,如果设备28181配置未更改,那么设备在下一次注册后仍然会注册上来。
-### 点播视频
- 进入通道列表后,点击列表末尾的“播放”按钮,稍等即可弹出播放页面
-### 设备录像
- 进入通道列表后,点击列表末尾的“设备录像”按钮,也可以在播放页面点击录像查询进入录像查看页面,选择要查看的日期即可对录像进行播放和下载。
-### 云台控制
- 可以对支持云台功能的设备进行上下左右的转动以及拉近拉远的操作。
-### 获取视频的播放器地址
- 视频点播成功后在实时视频页面,点击“更多地址”可以看到所有的播放地址,地址是否可以播放与你是否完整编译启用zlm功能有关,更与网络有关。
\ No newline at end of file
+- 作为消息通道
+ wvp支持通过报警消息给下级WVP互相推送消息,消息内容由redis消息发送给wvp,wvp编辑成报警消息发送给下级
+- 收到ACK后发流
+ 语音对讲策略: 不同的设备对于语音对讲的收流时机要求不一,勾选后会在收到设备发送的ack后再开始发流,不勾选则在回复200OK后开始发流,目前已知大华设备不勾选,海康需要勾选.
+
+### 删除设备
+
+可以删除WVP中的设备信息,如果设备28181配置未更改,那么设备在下一次注册后仍然会注册上来。
+
+### 点播视频
+
+进入通道列表后,点击列表末尾的“播放”按钮,稍等即可弹出播放页面
+
+### 设备录像
+
+进入通道列表后,点击列表末尾的“设备录像”按钮,也可以在播放页面点击录像查询进入录像查看页面,选择要查看的日期即可对录像进行播放和下载。
+
+### 云台控制
+
+可以对支持云台功能的设备进行上下左右的转动以及拉近拉远的操作。
+
+### 获取视频的播放器地址
+
+视频点播成功后在实时视频页面,点击“更多地址”可以看到所有的播放地址,地址是否可以播放与你是否完整编译启用zlm功能有关,更与网络有关。
+
+### 语音对讲
+
+[语音对讲](_content/ability/continuous_broadcast.md)
\ No newline at end of file
diff --git a/doc/_content/ability/gis.md b/doc/_content/ability/gis.md
index f77a428c0..5932df923 100644
--- a/doc/_content/ability/gis.md
+++ b/doc/_content/ability/gis.md
@@ -1,20 +1,26 @@
-# 电子地图
-WVP提供了简单的电子地图用于设备的定位以及移动设备的轨迹信息,电子地图基于开源的地图引擎openlayers开发。
-### 查看设备定位
-1. 可以在设备列表点击“定位”按钮,自动跳转到电子地图页面;
-2. 在电子地图页面在设备上右键点击“定位”获取设备/平台下的所有通道位置。
-3. 单击通道信息可以定位到具体的通道
+# 电子地图
+
+WVP提供了简单的电子地图用于设备的定位以及移动设备的轨迹信息,电子地图基于开源的地图引擎openlayers开发。
+
+### 查看设备定位
+
+1. 可以在设备列表点击“定位”按钮,自动跳转到电子地图页面;
+2. 在电子地图页面在设备上右键点击“定位”获取设备/平台下的所有通道位置。
+3. 单击通道信息可以定位到具体的通道
### 查询设备轨迹
+
查询轨迹需要提前配置save-position-history选项开启轨迹信息的保存,目前WVP此处未支持分库分表,对于大数据量的轨迹信息无法胜任,有需求请自行二次开发或者定制开发。
在电子地图页面在设备上右键点击“查询轨迹”获取设备轨迹信息。
PS: 目前的底图仅用用作演示和学习,商用情况请自行购买授权使用。
### 更换底图以及底图配置
+
目前WVP支持使用了更换底图,配置文件在web_src/static/js/config.js,请修改后重新编译前端文件。
+
```javascript
window.mapParam = {
// 开启/关闭地图功能
diff --git a/doc/_content/ability/node_manger.md b/doc/_content/ability/node_manger.md
index 1b4aef324..ec39a6b2e 100644
--- a/doc/_content/ability/node_manger.md
+++ b/doc/_content/ability/node_manger.md
@@ -1,9 +1,20 @@
+
# 节点管理
+
+
+
WVP支持单个WVP多个ZLM的方案来扩展WVP的视频并发能力,并发点播是因为带宽和性能的原因,单个ZLM节点能支持的路数有限,所以WVP增加了ZLM集群来扩展并发并且保证ZLM的高可用。
+
## 默认节点
+
WVP中为了保证功能的完整性,ZLM节点至少要有一个默认节点,这个节点不是在管理页面添加的,而是在WVP的配置文件中配置的,这个节点不可在页面删除。每次启动会自动从配置文件中读取配置写入数据库备用。
+
## 新增节点
-启动你要添加的zlm节点,然后点击“添加节点”按钮输入zlm的ip, http端口,SECRET。点击测试测试完成则开始对节点进行详细的设置,如果你的zlm是使用docker启动的,可能存在zlm使用的端口与宿主机端口不一致的情况,需要在这里一一配置。
+
+启动你要添加的zlm节点,然后点击“添加节点”按钮输入zlm的ip,
+http端口,SECRET。点击测试测试完成则开始对节点进行详细的设置,如果你的zlm是使用docker启动的,可能存在zlm使用的端口与宿主机端口不一致的情况,需要在这里一一配置。
+
## wvp使用多个节点的原理
+
wvp会把连接的节点统一记录在redis中,并记录zlm的负载情况,当新的请求到来时,会取出负载最低的那个zlm进行使用。以此保证节点负载均衡。
diff --git a/doc/_content/ability/online_doc.md b/doc/_content/ability/online_doc.md
index 55ecb2680..50d5070e9 100644
--- a/doc/_content/ability/online_doc.md
+++ b/doc/_content/ability/online_doc.md
@@ -1,2 +1,3 @@
+
# 在线文档
diff --git a/doc/_content/ability/proxy.md b/doc/_content/ability/proxy.md
index 74e632d81..7080442f4 100644
--- a/doc/_content/ability/proxy.md
+++ b/doc/_content/ability/proxy.md
@@ -1,12 +1,17 @@
+
# 拉流代理
+
不是所有的摄像机都支持国标或者推流的,但是这些设备可以得到一个视频播放地址,通常为rtsp协议,
以大华为例:
+
```text
rtsp://{user}:{passwd}@{ipc_ip}:{rtsp_port}/cam/realmonitor?channel=1&subtype=0
```
+
可以得到这样一个流地址,可以直接用vlc进行播放,此时我们可以通过拉流代理功能将这个设备推送给其他国标平台了。
流程如下:
+
```plantuml
@startuml
"摄像机" <- "ZLMediaKit": 1. 流去流信息到ZLM
@@ -15,10 +20,13 @@ rtsp://{user}:{passwd}@{ipc_ip}:{rtsp_port}/cam/realmonitor?channel=1&subtype=0
"WVP-PRO" -> "ZLMediaKit": 4. 通知推流到上级国标平台
@enduml
```
+
## 添加代理
+
拉流代理支持两种方式:
+
1. ZLM中直接代理流,支持RTSP/RTMP,不支持转码;
2. 借助ffmpeg完成拉转,可以通过修改ffmpeg拉转参数完成转码。
-点击页面的“添加代理”,安装提示操作即可,保存并启用成功后,可以在国标级联中[添加通道推送给上级平台](./_content/ability/cascade?id=_2-%e6%b7%bb%e5%8a%a0%e7%9b%ae%e5%bd%95%e4%b8%8e%e9%80%9a%e9%81%93)
+ 点击页面的“添加代理”,添加信息后保存即可,如果你需要共享推流信息到其他国标平台,那么你需要编辑/国标通道配置,配置国标编码.
-PS: ffmpeg默认模板不需修改,需要修改参数自行去ZLM配置文件中添加一个即可。
+`PS: ffmpeg默认模板不需修改,需要修改`参数自行去ZLM配置文件中添加一个即可。
diff --git a/doc/_content/ability/push.md b/doc/_content/ability/push.md
index ef501826e..cc568b3c8 100644
--- a/doc/_content/ability/push.md
+++ b/doc/_content/ability/push.md
@@ -1,8 +1,11 @@
+
# 推流列表
+
## 功能说明
WVP支持三种图像输入方式,直播,[拉流代理](_content/ability/proxy.md),[国标](_content/ability/device.md),直播设备接入流程如下
+
```plantuml
@startuml
"直播设备" -> "ZLMediaKit": 1. 发起推流
@@ -11,30 +14,41 @@ WVP支持三种图像输入方式,直播,[拉流代理](_content/ability/pro
"WVP-PRO" -> "ZLMediaKit": 4. 通知推流到上级国标平台
@enduml
```
-1. 默认情况下WVP收到推流信息后,列表中出现这条推流信息,此时你可以点击“加入国标”按钮为此路推流配置名称以及国标编号,只有有国标编号的推流才可以添加到级联平台,保存成功后可以在国标级联中[添加通道推送给上级平台](_content/ability/cascade?id=_2-%e6%b7%bb%e5%8a%a0%e7%9b%ae%e5%bd%95%e4%b8%8e%e9%80%9a%e9%81%93)
-2. WVP也支持推流前导入大量通道直接推送给上级,点击“下载模板”按钮,根据示例修改模板后,点击“通道导入”按钮导入通道数据,保存成功后可以在国标级联中[添加通道推送给上级平台](_content/ability/cascade?id=_2-%e6%b7%bb%e5%8a%a0%e7%9b%ae%e5%bd%95%e4%b8%8e%e9%80%9a%e9%81%93)
+
+1. 默认情况下WVP收到推流信息后,列表中出现这条推流信息,如果你需要共享推流信息到其他国标平台,那么你需要编辑/国标通道配置,配置国标编码.
+2. WVP也支持推流前导入大量通道直接推送给上级,点击“下载模板”按钮,根据示例修改模板后,点击“通道导入”按钮导入通道数据.
## 推拉流鉴权规则
+
为了保护服务器的WVP默认开启推流鉴权(目前不支持关闭此功能)
### 推流规则
+
推流时需要携带推流鉴权的签名sign,sign=md5(pushKey),pushKey来自用户表,每个用户会有一个不同的pushKey.
例如app=test,stream=live,pushKey=1000,ip=192.168.1.4, port=10554 那么推流地址为:
+
```
rtsp://192.168.1.4:10554/test/live?sign=a9b7ba70783b617e9998dc4dd82eb3c5
```
+
支持推流时自定义播放鉴权Id,参数名为callId,此时sign=md5(callId_pushKey)
例如app=test,stream=live,pushKey=1000,callId=12345678, ip=192.168.1.4, port=10554 那么推流地址为:
+
```
rtsp://192.168.1.4:10554/test/live?callId=12345678&sign=c8e6e01dde2d60c66dcea8d2498ffef1
```
+
### 播放规则
+
默认情况播放不需要鉴权,但是如果推流时携带了callId,那么播放时必须携带callId
例如app=test,stream=live,无callId, ip=192.168.1.4, port=10554 那么播放地址为:
+
```
rtsp://192.168.1.4:10554/test/live
```
+
例如app=test,stream=live,callId=12345678, ip=192.168.1.4, port=10554 那么播放地址为:
+
```
rtsp://192.168.1.4:10554/test/live?callId=12345678
```
diff --git a/doc/_content/ability/user.md b/doc/_content/ability/user.md
index 0c472386a..776fe6b64 100644
--- a/doc/_content/ability/user.md
+++ b/doc/_content/ability/user.md
@@ -1,2 +1,3 @@
+
# 用户管理
diff --git a/doc/_content/about_doc.md b/doc/_content/about_doc.md
index f727264e9..02e36137f 100644
--- a/doc/_content/about_doc.md
+++ b/doc/_content/about_doc.md
@@ -1,5 +1,7 @@
# 关于本文档
-本文档开源在gitee上,[https://gitee.com/pan648540858/wvp-pro-doc.git](https://gitee.com/pan648540858/wvp-pro-doc.git),如果文档出现任何错误或者不易理解的语句,请大家提ISSUE帮助我及时更正。欢迎大家提交PR一起维护这份文档,让更多的人可以使用到这个开源的视频平台。
+
+本文档开源在gitee上,[https://gitee.com/pan648540858/wvp-pro-doc.git](https://gitee.com/pan648540858/wvp-pro-doc.git)
+,如果文档出现任何错误或者不易理解的语句,请大家提ISSUE帮助我及时更正。欢迎大家提交PR一起维护这份文档,让更多的人可以使用到这个开源的视频平台。
diff --git a/doc/_content/broadcast.md b/doc/_content/broadcast.md
index 3a6b20d70..355e76172 100644
--- a/doc/_content/broadcast.md
+++ b/doc/_content/broadcast.md
@@ -1,6 +1,7 @@
# 原理图
## 使用ffmpeg测试语音对讲原理
+
```plantuml
@startuml
"FFMPEG" -> "ZLMediaKit": 推流到zlm
@@ -13,6 +14,7 @@
```
## 使用网页测试语音对讲原理
+
```plantuml
@startuml
"前端页面" -> "WVP-PRO": 请求推流地址
diff --git a/doc/_content/disclaimers.md b/doc/_content/disclaimers.md
index 94412ecdc..b0b2e64a5 100644
--- a/doc/_content/disclaimers.md
+++ b/doc/_content/disclaimers.md
@@ -1,2 +1,5 @@
# 免责声明
-WVP-PRO自有代码使用宽松的MIT协议,在保留版权信息的情况下可以自由应用于各自商用、非商业的项目。 但是本项目也零碎的使用了一些其他的开源代码,在商用的情况下请自行替代或剔除; 由于使用本项目而产生的商业纠纷或侵权行为一概与本项目及开发者无关,请自行承担法律风险。 在使用本项目代码时,也应该在授权协议中同时表明本项目依赖的第三方库的协议
\ No newline at end of file
+
+WVP-PRO自有代码使用宽松的MIT协议,在保留版权信息的情况下可以自由应用于各自商用、非商业的项目。
+但是本项目也零碎的使用了一些其他的开源代码,在商用的情况下请自行替代或剔除; 由于使用本项目而产生的商业纠纷或侵权行为一概与本项目及开发者无关,请自行承担法律风险。
+在使用本项目代码时,也应该在授权协议中同时表明本项目依赖的第三方库的协议
\ No newline at end of file
diff --git a/doc/_content/introduction/_media/img_1.png b/doc/_content/introduction/_media/img_1.png
index aad1859d0..b4a62afc1 100644
Binary files a/doc/_content/introduction/_media/img_1.png and b/doc/_content/introduction/_media/img_1.png differ
diff --git a/doc/_content/introduction/_media/img_2.png b/doc/_content/introduction/_media/img_2.png
index e78690000..a5961d6fc 100644
Binary files a/doc/_content/introduction/_media/img_2.png and b/doc/_content/introduction/_media/img_2.png differ
diff --git a/doc/_content/introduction/compile.md b/doc/_content/introduction/compile.md
index 15f2a9e68..b61d6453b 100644
--- a/doc/_content/introduction/compile.md
+++ b/doc/_content/introduction/compile.md
@@ -1,46 +1,63 @@
+
# 编译
+
WVP-PRO不只是实现了国标28181的协议,本身也是一个完整的视频平台。所以对于新手来说,你可能需要一些耐心来完成。遇到问题不要焦躁,你可以
+
1. 百度
2. 加入星球体提问;[知识星球](https://t.zsxq.com/0d8VAD3Dm)
3. 向作者发送邮件648540858@qq.com,寻求技术支持(有偿);
WVP-PRO使用Spring boot开发,maven管理依赖。对于熟悉spring开发的朋友是很容易进行编译部署以及运行的。
下面将提供一种通用方法方便大家运行项目。
+
## 1 服务介绍
-| 服务 | 作用 | 是否必须 |
-|----------------|------------------------------------------|-------------------------|
-| WVP-PRO | 实现国标28181的信令以及视频平台相关的功能 | 是 |
-| ZLMediaKit | 为WVP-PRO提供国标28181的媒体部分的实现,以及各种视频流格式的分发支持 | 是 |
+
+| 服务 | 作用 | 是否必须 |
+|------------|------------------------------------------|------|
+| WVP-PRO | 实现国标28181的信令以及视频平台相关的功能 | 是 |
+| ZLMediaKit | 为WVP-PRO提供国标28181的媒体部分的实现,以及各种视频流格式的分发支持 | 是 |
## 2 安装依赖
-| 依赖 | 版本 | 用途 | 开发环境需要 | 生产环境需要 |
-|--------|------------|-------------|--------|--------|
-| jdk | >=1.8 | 运行与编译java代码 | 是 | 是 |
-| maven | >=3.3 | 管理java代码依赖 | 否 | 否 |
-| git || 下载/更新/提交代码 | 否 | 否 |
-| nodejs || 编译于运行前端文件 | 否 | 否 |
-| npm || 管理前端文件依赖 | 否 | 否 |
+
+| 依赖 | 版本 | 用途 | 开发环境需要 | 生产环境需要 |
+|--------|-------|-------------|--------|--------|
+| jdk | >=1.8 | 运行与编译java代码 | 是 | 是 |
+| maven | >=3.3 | 管理java代码依赖 | 否 | 否 |
+| git | | 下载/更新/提交代码 | 否 | 否 |
+| nodejs | | 编译于运行前端文件 | 否 | 否 |
+| npm | | 管理前端文件依赖 | 否 | 否 |
如果你是一个新手,建议你使用linux或者macOS平台。windows不推荐。
ubuntu环境,以ubuntu 18为例:
+
``` bash
apt-get install -y openjdk-11-jre git maven nodejs npm
```
+
centos环境,以centos 8为例:
+
```bash
yum install -y java-1.8.0-openjdk.x86_64 git maven nodejs npm
```
+
window环境,以windows10为例:
+
```bash
这里不细说了,百度或者谷歌一搜一大把,基本都是下一步下一步,然后配置环境变量。
```
+
## 3 安装mysql以及redis
+
这里依然是参考网上教程,自行安装吧。
## 4 编译ZLMediaKit
-参考ZLMediaKit[WIKI](https://github.com/ZLMediaKit/ZLMediaKit/wiki),如果需要使用语音对讲功能,请参考[zlm启用webrtc编译指南](https://github.com/ZLMediaKit/ZLMediaKit/wiki/zlm%E5%90%AF%E7%94%A8webrtc%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97),开启zlm的webrtc功能。截取一下关键步骤:
+
+参考ZLMediaKit[WIKI](https://github.com/ZLMediaKit/ZLMediaKit/wiki)
+,如果需要使用语音对讲功能,请参考[zlm启用webrtc编译指南](https://github.com/ZLMediaKit/ZLMediaKit/wiki/zlm%E5%90%AF%E7%94%A8webrtc%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97)
+,开启zlm的webrtc功能。截取一下关键步骤:
+
```bash
# 国内用户推荐从同步镜像网站gitee下载
git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit
@@ -48,40 +65,52 @@ cd ZLMediaKit
# 千万不要忘记执行这句命令
git submodule update --init
```
+
## 5 编译WVP-PRO
+
### 5.1 可以通过git克隆,也可以在项目下载点击下载
+


从gitee克隆
+
```bash
git clone https://gitee.com/pan648540858/wvp-GB28181-pro.git
```
+
从github克隆
+
```bash
git clone https://github.com/648540858/wvp-GB28181-pro.git
```
### 5.2 编译前端页面
+
```shell script
cd wvp-GB28181-pro/web_src/
npm --registry=https://registry.npmmirror.com install
npm run build
```
+
编译如果报错, 一般都是网络问题, 导致的依赖包下载失败
编译完成后在src/main/resources下出现static目录
**编译完成一般是这个样子,中间没有报红的错误信息**

### 5.3 生成可执行jar
+
```bash
cd wvp-GB28181-pro
mvn package
```
+
### 5.4 生成war
+
```bash
cd wvp-GB28181-pro
mvn package -P war
```
+
编译如果报错, 一般都是网络问题, 导致的依赖包下载失败
编译完成后在target目录下出现wvp-pro-***.jar/wvp-pro-***.war。
接下来[配置服务](./_content/introduction/config.md)
diff --git a/doc/_content/introduction/config.md b/doc/_content/introduction/config.md
index 359aac9ef..ea4c7c786 100644
--- a/doc/_content/introduction/config.md
+++ b/doc/_content/introduction/config.md
@@ -1,5 +1,7 @@
+
# 配置
+
对于首次测试或者新手同学,我建议在局域网测试,并且关闭服务器与客户机的防火墙测试。建议部署在linux进行测试。
```plantuml
@@ -8,24 +10,38 @@
"WVP-PRO" <-- "ZLMediaKit": Web Hook 接口
@enduml
```
+
WVP-PRO通过调用ZLMediaKit的RESTful接口实现对ZLMediaKit行为的控制; ZLMediaKit通过Web Hook 接口把消息通知WVP-PRO。通过这种方式,实现了两者的互通。
对于最简单的配置,你不需要修改ZLMediaKit的任何默认配置。你只需要在WVP-PRO中配置的ZLMediaKit信息即可
+
## 1 WVP配置文件位置
+
基于spring boot的开发方式,配置文件的加载是很灵活的。默认在src/main/resources/application.yml,部分配置项是可选,你不需要全部配置在配置文件中,
-完全的配置说明可以参看all-application.yml。
+完全的配置说明可以参看"src/main/resources/配置详情.yml"。
+
### 1.1 默认加载配置文件方式
+
使用maven打包后的target里,已经存在了配置文件,默认加载配置文件为application.yml,查看内容发现其中spring.profiles.active配置的内容,将入配置的值为dev,那么具体加载的配置文件就是application-dev.yml,如果配置的值找不到对应的配置文件,修改值为dev。
+
```shell
cd wvp-GB28181-pro/target
java -jar wvp-pro-*.jar
```
+
## 2 配置WVP-PRO
+
wvp支持多种数据库,包括Mysql,Postgresql,金仓等,配置任选一种即可。
+
### 2.1 数据库配置
-#### 2.1.1 初始化数据库
+
+#### 2.1.1 初始化数据库
+
首先使用创建数据库,然后使用sql/初始化.sql初始化数据库,如果是从旧版升级上来的,使用升级sql更新。
-#### 2.1.2 Mysql数据库配置
+
+#### 2.1.2 Mysql数据库配置
+
数据库名称以wvp为例
+
```yaml
spring:
dynamic:
@@ -38,24 +54,30 @@ spring:
username: root
password: root123
```
-#### 2.1.3 Postgresql数据库配置
+
+#### 2.1.3 Postgresql数据库配置
+
数据库名称以wvp为例
+
```yaml
spring:
dynamic:
- primary: master
- datasource:
- type: com.zaxxer.hikari.HikariDataSource
- driver-class-name: org.postgresql.Driver
- url: jdbc:postgresql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true&allowPublicKeyRetrieval=true
- username: root
- password: 12345678
+ primary: master
+ datasource:
+ type: com.zaxxer.hikari.HikariDataSource
+ driver-class-name: org.postgresql.Driver
+ url: jdbc:postgresql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true&allowPublicKeyRetrieval=true
+ username: root
+ password: 12345678
pagehelper:
helper-dialect: postgresql
```
-#### 2.1.4 金仓数据库配置
+
+#### 2.1.4 金仓数据库配置
+
数据库名称以wvp为例
+
```yaml
spring:
dynamic:
@@ -70,31 +92,39 @@ spring:
pagehelper:
helper-dialect: postgresql
```
+
### 2.2 Redis数据库配置
+
配置wvp中的redis连接信息,建议wvp自己单独使用一个db。
+
### 2.3 配置服务启动端口(可直接使用默认配置)
+
```yaml
# [可选] WVP监听的HTTP端口, 网页和接口调用都是这个端口
server:
- port: 18080
+ port: 18080
```
+
### 2.4 配置28181相关信息(可直接使用默认配置)
+
```yaml
# 作为28181服务器的配置
sip:
- # [可选] 28181服务监听的端口
- port: 5060
- # 根据国标6.1.2中规定,domain宜采用ID统一编码的前十位编码。国标附录D中定义前8位为中心编码(由省级、市级、区级、基层编号组成,参照GB/T 2260-2007)
- # 后两位为行业编码,定义参照附录D.3
- # 3701020049标识山东济南历下区 信息行业接入
- # [可选]
- domain: 3402000000
- # [可选]
- id: 34020000002000000001
- # [可选] 默认设备认证密码,后续扩展使用设备单独密码, 移除密码将不进行校验
- password: 12345678
+ # [可选] 28181服务监听的端口
+ port: 5060
+ # 根据国标6.1.2中规定,domain宜采用ID统一编码的前十位编码。国标附录D中定义前8位为中心编码(由省级、市级、区级、基层编号组成,参照GB/T 2260-2007)
+ # 后两位为行业编码,定义参照附录D.3
+ # 3701020049标识山东济南历下区 信息行业接入
+ # [可选]
+ domain: 3402000000
+ # [可选]
+ id: 34020000002000000001
+ # [可选] 默认设备认证密码,后续扩展使用设备单独密码, 移除密码将不进行校验
+ password: 12345678
```
+
### 2.5 配置ZLMediaKit连接信息
+
```yaml
#zlm 默认服务器配置
media:
@@ -118,7 +148,9 @@ media:
# [可选] 国标级联在此范围内选择端口发送媒体流,
send-port-range: 40000,40300 # 端口范围
```
-### 2.4 个性化定制信息配置
+
+### 2.4 策略配置
+
```yaml
# [根据业务需求配置]
user-settings:
@@ -133,7 +165,8 @@ user-settings:
# 国标点播 按需拉流, true:有人观看拉流,无人观看释放, false:拉起后不自动释放
stream-on-demand: true
```
-更多完整的配置信息参考all-application.yml文件,需要那个配置项,复制到正在使用的配置文件中对应的文件即可。
+
+更多完整的配置信息参考"src/main/resources/配置详情.yml"文件,需要那个配置项,复制到正在使用的配置文件中对应的文件即可。
如果配置信息无误,你可以启动zlm,再启动wvp来测试了,启动成功的话,你可以在wvp的日志下看到zlm已连接的提示。
接下来[部署到服务器](./_content/introduction/deployment.md), 如果你只是本地运行直接在本地运行即可。
diff --git a/doc/_content/introduction/deployment.md b/doc/_content/introduction/deployment.md
index f11fe7f26..755c4297a 100644
--- a/doc/_content/introduction/deployment.md
+++ b/doc/_content/introduction/deployment.md
@@ -1,47 +1,63 @@
# 部署
+
**请仔细阅读以下内容**
+
1. WVP-PRO与ZLM支持分开部署;
2. 需要开放的端口
-| 服务 | 端口 | 类型 | 必选 |
-|-----|:-------------------------|-------------|-------|
-| wvp | server.port | tcp | 是 |
-| wvp | sip.port | udp and tcp | 是 |
-| zlm | http.port | tcp | 是 |
-| zlm | http.sslport | tcp | 否 |
-| zlm | rtmp.port | tcp | 否 |
-| zlm | rtmp.sslport | tcp | 否 |
-| zlm | rtsp.port | udp and tcp | 否 |
-| zlm | rtsp.sslport | udp and tcp | 否 |
-| zlm | rtp_proxy.port | udp and tcp | 单端口开放 |
-| zlm | rtp.port-range(在wvp中配置) | udp and tcp | 多端口开放 |
+ | 服务 | 端口 | 类型 | 必选 |
+ |-----|:-------------------------|-------------|-------|
+ | wvp | server.port | tcp | 是 |
+ | wvp | sip.port | udp and tcp | 是 |
+ | zlm | http.port | tcp | 是 |
+ | zlm | http.sslport | tcp | 否 |
+ | zlm | rtmp.port | tcp | 否 |
+ | zlm | rtmp.sslport | tcp | 否 |
+ | zlm | rtsp.port | udp and tcp | 否 |
+ | zlm | rtsp.sslport | udp and tcp | 否 |
+ | zlm | rtp_proxy.port | udp and tcp | 单端口开放 |
+ | zlm | rtp.port-range(在wvp中配置) | udp and tcp | 多端口开放 |
3. 测试环境部署建议所有服务部署在一台主机,关闭防火墙,减少因网络出现问题的可能;
4. 生产环境按需开放端口,但是建议修改默认端口,尤其是5060端口,易受到攻击;
5. zlm使用docker部署的情况,请使用host模式,或者端口映射一致,比如映射5060,应将外部端口也映射为5060端口;
6. zlm与wvp会保持高频率的通信,所以不要去将wvp与zlm分属在两个网络,比如wvp在内网,zlm却在公网的情况。
7. 启动服务,以linux为例
-**启动WVP-PRO**
+ **启动WVP-PRO**
+
```shell
nohup java -jar wvp-pro-*.jar &
```
+
**war包:**
下载Tomcat后将war包放入webapps中,启动Tomcat以解压war包,停止Tomcat后,删除ROOT目录以及war包,将解压后的war包目录重命名为ROOT,将配置文件中的Server.port配置为与Tomcat端口一致
然后启动Tomcat。
**启动ZLM**
+
```shell
nohup ./MediaServer -d -m 3 &
```
+
### 前后端分离部署
+
前后端部署目前在最新的版本已经支持,请使用3月15日之后的版本部署
前端编译后的文件在`src/main/resources/static`中,将此目录下的文件部署。
WVP默认开启全部接口支持跨域。部署前端文件到WEB容器,并将访问的地址设置为WVP的地址即可。
**配置前端服务器**
+
1. 在`src/main/resources/static/static/js/config.js`下配置服务器的地址,也就是wvp服务的地址
+
```javascript
window.baseUrl = "http://xxx.com:18080"
```
+
`这里的地址是需要客户电脑能访问到的,因为请求是客户端电脑发起,与代理不同`
[接入设备](./_content/ability/device.md)
+### 默认账号和密码
+
+部署完毕后,可以通过访问 ip加端口的方式访问 WVP ,WVP的默认登录账号和密码均为 admin。
+
+
+
diff --git a/doc/_content/qa/bug.md b/doc/_content/qa/bug.md
index 81267ffe2..55e4cafa0 100644
--- a/doc/_content/qa/bug.md
+++ b/doc/_content/qa/bug.md
@@ -1,12 +1,18 @@
+
# 反馈bug
+
代码是在不断的完善的,不断修改会修复旧的问题也有可能引入新的问题,所以遇到BUG是很正常的一件事。所以遇到问题不要烦燥,咱们就事论事就好了。
+
## 如何反馈
+
1. 在知识星球提问。
2. 更新代码,很可能你遇到问题别人已经更早的遇到了,或者是作者自己发现了,已经解决了,所以你可以更新代码再次进行测试;
3. 可以在github提ISSUE,我几乎每天都会去看issue,你的问题我会尽快给予答复;
+
> 有偿支持可以给我发邮件, 648540858@qq.com
## 社群
+
[](https://t.zsxq.com/0d8VAD3Dm)
> 收费是为了提供更好的服务,也是对作者更大的激励。加入星球的用户三天后可以私信我留下微信号,我会拉大家入群。加入三天内不满意可以直接退款,大家不需要有顾虑,来白嫖三天也不是不可以。
\ No newline at end of file
diff --git a/doc/_content/qa/development.md b/doc/_content/qa/development.md
index fec7b70cf..ec9df9e36 100644
--- a/doc/_content/qa/development.md
+++ b/doc/_content/qa/development.md
@@ -1,7 +1,11 @@
+
# 参与到开发中来
+
非常欢迎有兴趣的小伙伴一起来维护这个项目
+
## 与开发有关的信息
+
- 开发语言:后端java + 前端vue;
- jdk版本: 1.8;
- 作者自用开发ide: jetbrains intellij idea;
@@ -9,7 +13,9 @@
- 后端使用Spring boot框架开发;
- 项目大量使用了异步操作;
- 跟代码学流程需要参考28181文档,只看代码你会很懵的;
-- 必须学会[抓包](_content/skill/tcpdump.md),这是必须的
+- 必须学会[抓包](_content/skill/tcpdump.md),这是必须的
## 提交代码
-大家可以通过fork项目的方式提交自己的代码,然后提交PR,我来合并到主线。提交代码的过程中我们需要遵循“**阿里编码规约**”,现有代码也有很多代码没有做到,但是我们在朝这个方向努力。
\ No newline at end of file
+
+大家可以通过fork项目的方式提交自己的代码,然后提交PR,我来合并到主线。提交代码的过程中我们需要遵循“**阿里编码规约**
+”,现有代码也有很多代码没有做到,但是我们在朝这个方向努力。
\ No newline at end of file
diff --git a/doc/_content/qa/play_error.md b/doc/_content/qa/play_error.md
index c8e9c02bb..a474399da 100644
--- a/doc/_content/qa/play_error.md
+++ b/doc/_content/qa/play_error.md
@@ -1,6 +1,9 @@
+
# 点播错误
+
排查点播错误你首先要清楚[点播的基本流程](_content/theory/play.md),一般的流程如下:
+
```plantuml
@startuml
"WEB用户" -> "WVP-PRO": 1. 发起点播请求
@@ -15,11 +18,16 @@
"设备" --> "WVP-PRO": 10 200OK
@enduml
```
+
针对几种常见的错误,我们来分析一下,也方便大家对号入座解决常见的问题
+
## 点播收到错误码
+
这个错误一般表现为点击"播放"按钮后很快得到一个错误。
+
1. **400错误码**
-出现400错误玛时一般是这样的流程是这样的
+ 出现400错误玛时一般是这样的流程是这样的
+
```plantuml
@startuml
"WEB用户" -> "WVP-PRO": 1. 发起点播请求
@@ -27,30 +35,39 @@
"设备" --> "WVP-PRO": 3. 400错误
@enduml
```
-此时通常是设备认为WVP发送了错误的消息给它,它认为消息不全或者错误所以直接返回400错误,此时我们需要[抓包](_content/skill/tcpdump.md)来分析是否缺失了内容,也可以直接联系对方询问为什么返回了400。
-WVP不能保证兼容所有的设备,有些实现不规范的设备可能在对接时就会出现上述问题,你可以联系作者帮忙对接。
-2. **500错误码**
-500或者大于500小于600的错误码一般多是设备内部出了问题,解决方式有两个,第一种直接联系设备/平台客服寻求解决;第二种,如果你有确定可以对接这个设备的平台那么可以把对接这个平台的抓包和对接wvp的抓包同时发送给我,我来尝试解决。
+此时通常是设备认为WVP发送了错误的消息给它,它认为消息不全或者错误所以直接返回400错误,此时我们需要[抓包](_content/skill/tcpdump.md)
+来分析是否缺失了内容,也可以直接联系对方询问为什么返回了400。
+WVP不能保证兼容所有的设备,有些实现不规范的设备可能在对接时就会出现上述问题,你可以联系作者帮忙对接。
+
+2. **500错误码**
+ 500或者大于500小于600的错误码一般多是设备内部出了问题,解决方式有两个,第一种直接联系设备/平台客服寻求解决;第二种,如果你有确定可以对接这个设备的平台那么可以把对接这个平台的抓包和对接wvp的抓包同时发送给我,我来尝试解决。
## 点播超时
+
点播超时的情况大致分为两种:点播超时和收流超时
+
1. **点播超时**
-点播超时错误一般为信令的超时,比如长时间为收到对方的回复,可能出现在流程中 “3. 200OK(携带SDP消息体)”这个位置,即我们发送点播消息,但是设备没有回复,可能的原因:
+ 点播超时错误一般为信令的超时,比如长时间为收到对方的回复,可能出现在流程中 “3. 200OK(携带SDP消息体)
+ ”这个位置,即我们发送点播消息,但是设备没有回复,可能的原因:
+
> 1. 设备内部错误,未能回复消息
-> 2. 网络原因消息未到到达设备
+> 2. 网络原因消息未到到达设备
大部分时候是原因2,所以遇到这个错误我们首先要排查我们我的网路,如果你是公网部署,那么也可能时心跳周期太长,导致的路由NAT失效,WVP的消息无法通道原来的IP端口号发送给设备。
2. **收流超时**
-收流超时可能发生在流程中的5和6,可能的原因有:
-> 1. 设备发送了流但是发送到了错误的ip和端口上,而这个信息是在invite消息的sdp中指定的,就是流程2Invite(携带SDP消息体)中,而这个错误很可能来自你的配置错误,比如你设置了127.0.0.1导致设备网127.0.0.1上发流,或者是你WVP在公网,但是你给设备了一个内网ip,导致设备无法把流发送过来;
+ 收流超时可能发生在流程中的5和6,可能的原因有:
+
+> 1. 设备发送了流但是发送到了错误的ip和端口上,而这个信息是在invite消息的sdp中指定的,就是流程2Invite(携带SDP消息体)
+ 中,而这个错误很可能来自你的配置错误,比如你设置了127.0.0.1导致设备网127.0.0.1上发流,或者是你WVP在公网,但是你给设备了一个内网ip,导致设备无法把流发送过来;
> 2. 设备内部错误未发送流;
> 2. 设备发送了流,但是流无法识别,可能存在于流不规范和网络很差的情况下;
> 3. 设备发送了流,zlm也收到了,但是zlm无法通过hook通知到wvp,此时原因是你可以检查zlm的配置文件中的hook配置,看看是否无法从zlm连接到wvp;
> 4. 设备发送了流,但是开启SSRC校验,设备的流不够规范采用错误的ssrc,导致zlm选择丢弃;
-
-针对这些可能的错误原因我建议的排查顺序:
+
+针对这些可能的错误原因我建议的排查顺序:
+
- 关闭ssrc校验;
- 查看zlm配置的hook是否可以连接到zlm;
- 查看zlm日志是否有流注册;
diff --git a/doc/_content/qa/regiser_error.md b/doc/_content/qa/regiser_error.md
index d18459c54..7d4e96c17 100644
--- a/doc/_content/qa/regiser_error.md
+++ b/doc/_content/qa/regiser_error.md
@@ -1,8 +1,10 @@
-# 设备注册不上来的解决办法
-一般的原因有两个
-1. 信息填写错误,比如密码错误;
-2. 网络不通导致注册消息无法发送到WVP;
+# 设备注册不上来的解决办法
+
+一般的原因有两个
+
+1. 信息填写错误,比如密码错误;
+2. 网络不通导致注册消息无法发送到WVP;
遇到问题首先仔细校验填写信息,例如海康可能需要勾选鉴权才可以输入密码。网络问题请自行测试。
\ No newline at end of file
diff --git a/doc/_content/qa/start_error.md b/doc/_content/qa/start_error.md
index 1dd533f2c..3e5749dad 100644
--- a/doc/_content/qa/start_error.md
+++ b/doc/_content/qa/start_error.md
@@ -1,17 +1,19 @@
+
# 启动时报错
+
启动时的报错大部分时候是因为你的配置有问题,比如mysql没连接上,redis没连接上,18080/15060端口占用了,这些都会导致启动是报错,修改配置配置之后都可以解决;
下面我整理的一些常见的错误,大家可以先对号入座的简单排查下。
-> **常见错误**
+> **常见错误**

-**错误原因:** redis配置错误,可能原因: redis未启动/ip错误/端口错误/网络不通
+**错误原因:** redis配置错误,可能原因: redis未启动/ip错误/端口错误/网络不通
---

**错误原因:** redis配置错误,可能原因: 密码错误
---

-**错误原因:** mysql配置错误,可能原因: mysql未启动/ip错误/端口错误/网络不通
+**错误原因:** mysql配置错误,可能原因: mysql未启动/ip错误/端口错误/网络不通
---

**错误原因:** mysql配置错误,可能原因: 用户名/密码错误
diff --git a/doc/_content/skill/tcpdump.md b/doc/_content/skill/tcpdump.md
index 7dd270de8..fa0ee88a0 100644
--- a/doc/_content/skill/tcpdump.md
+++ b/doc/_content/skill/tcpdump.md
@@ -1,15 +1,25 @@
+
# 抓包
-如果说对于网络编程,有什么工具是必会的,我觉得抓包肯定是其中之一了。作为GB/T 28181调试过程中最重要的手段,我觉得如果你真对他有兴趣,或者系统遇到问题可以最快的得到解决,那么抓包你就一定要学会了。
+
+如果说对于网络编程,有什么工具是必会的,我觉得抓包肯定是其中之一了。作为GB/T
+28181调试过程中最重要的手段,我觉得如果你真对他有兴趣,或者系统遇到问题可以最快的得到解决,那么抓包你就一定要学会了。
## 抓包工具的选择
+
### 1. Wireshark
+
在具备图形界面的系统上,比如windows,linux发行版ubuntu,opensuse等,我一般直接使用Wireshark直接进行抓包,也方便进行内容的查看。
+
### 2. Tcpdump
+
在使用命令行的系统,比如linux服务器,我一般使用Tcpdump进行抓包,无需额外安装,系统一般自带,抓包的到的文件,可以使用Wireshark打开,在图形界面下方便查看内容。
## 工具安装
-Wireshark的安装很简单,根据提示一步步点击就好了,在linux需要解决权限的问题,如果和我一样使用图形界面的linux发行版的话,可以参看如下步骤; windows的小伙伴直接略过即可
+
+Wireshark的安装很简单,根据提示一步步点击就好了,在linux需要解决权限的问题,如果和我一样使用图形界面的linux发行版的话,可以参看如下步骤;
+windows的小伙伴直接略过即可
+
```shell
# 1. 添加wireshark用户组
sudo groupadd wireshark
@@ -20,43 +30,65 @@ sudo chmod 4755 /usr/bin/dumpcap
# 4. 将需要使用的用户名加入wireshark用户组
sudo gpasswd -a $USER wireshark
```
+
tcpdump一般linux都是自带,无需安装,可以这样验证;显示版本信息即是已安装
+
```shell
tcpdump --version
```
+
## 开始抓包
+
### 使用Wireshark
-在28181中我一般只关注sip包和rtp包,所以我一般是直接过滤sip和rtp,可以输入框输入 `sip or rtp`这样即可,如果设备来源比较多还可以加上ip和端口号的过滤`(sip or rtp )and ip.addr==192.168.1.3 and udp.port==5060`
+
+在28181中我一般只关注sip包和rtp包,所以我一般是直接过滤sip和rtp,可以输入框输入 `sip or rtp`这样即可,如果设备来源比较多还可以加上ip和端口号的过滤
+`(sip or rtp )and ip.addr==192.168.1.3 and udp.port==5060`
详细的过滤规则可以自行百度,我可以提供一些常用的给大家参考

**只过滤SIP:**
+
```shell
sip
```
+
**只获取rtp数据:**
+
```shell
rtp
```
+
**默认方式:**
+
```shell
sip or rtp
```
+
**过滤IP:**
+
```shell
sip and ip.addr==192.168.1.3
```
+
**过滤端口:**
+
```shell
sip and udp.port==5060
```
-输入命令开启抓包后,此时可以进行操作,比如点播,录像回访等,操作完成回到Wireshark点击红色的停止即可,需要保存文件可以点击`文件->导出特定分组`导出过滤后的数据,也可以直接`文件->另存为`保存未过滤的数据。
+
+输入命令开启抓包后,此时可以进行操作,比如点播,录像回访等,操作完成回到Wireshark点击红色的停止即可,需要保存文件可以点击
+`文件->导出特定分组`导出过滤后的数据,也可以直接`文件->另存为`保存未过滤的数据。
+
### 使用tcpdump
+
对于服务器抓包,为了得到足够完整的数据,我一般会要求直接抓取网卡数据而不过滤,如下:
抓取网卡首先需要获取网卡名,在linux我一般使用`ip addr`获取网卡信息,如下所示:

+
```shell
sudo tcpdump -i wlp3s0 -w demo.pcap
```
+

-命令行会停留在这个位置,此时可以进行操作,比如点播,录像回放等,操作完成回到命令行使用`Ctrl+C`结束命令行,在当前目录下得到demo.pcap,将这个文件下载到图形界面操作系统里,即可使用Wireshark查看了
+命令行会停留在这个位置,此时可以进行操作,比如点播,录像回放等,操作完成回到命令行使用`Ctrl+C`
+结束命令行,在当前目录下得到demo.pcap,将这个文件下载到图形界面操作系统里,即可使用Wireshark查看了
更多的操作可以参考: [https://www.cnblogs.com/jiujuan/p/9017495.html](https://www.cnblogs.com/jiujuan/p/9017495.html)
diff --git a/doc/_content/theory/broadcast_cascade.md b/doc/_content/theory/broadcast_cascade.md
index e59b8c251..1770b117d 100644
--- a/doc/_content/theory/broadcast_cascade.md
+++ b/doc/_content/theory/broadcast_cascade.md
@@ -1,6 +1,7 @@
# 点播流程
+
> 以下为WVP-PRO级联语音喊话流程。
```plantuml
@@ -31,8 +32,8 @@
@enduml
```
+## 注册流程描述如下:
-## 注册流程描述如下:
1. 用户从网页或调用接口发起点播请求;
2. WVP-PRO向摄像机发送Invite消息,消息头域中携带 Subject字段,表明点播的视频源ID、发送方媒体流序列号、ZLMediaKit接收流使用的IP、端口号、
接收端媒体流序列号等参数,SDP消息体中 s字段为“Play”代表实时点播,y字段描述SSRC值,f字段描述媒体参数。
diff --git a/doc/_content/theory/channel_tree.md b/doc/_content/theory/channel_tree.md
deleted file mode 100644
index c4c1b09ee..000000000
--- a/doc/_content/theory/channel_tree.md
+++ /dev/null
@@ -1,14 +0,0 @@
-
-
-# 通道的树形结构
-
-国标28181规定了两种组织设备树的方式
-1. **行政区划**
- 行政区划模式下主要是以行政区划作为目录节点例如:河北省->邯郸市->广平县
- 
-2. **业务分组**
- 业务分组主要自定义的目录树的一种组织形式,但是对定义的目录的国标编号有一定的要求。
- 第一级别需要是业务分组类型,即国标编码中的11、12、13是215,例如:65010200002150000001;
- 业务分组下是虚拟组织,即国标编码中的11、12、13是216,例如:65010200002160000002。
- 虚拟组织下不可是业务分组,虚拟组织下可以继续添加虚拟组织。
- 
diff --git a/doc/_content/theory/code.md b/doc/_content/theory/code.md
index d5a892e2a..2d9a9be87 100644
--- a/doc/_content/theory/code.md
+++ b/doc/_content/theory/code.md
@@ -1,25 +1,29 @@
# 统一编码规则
+
## D.1 编码规则 A
-> 编码规则 A 由中心编码(8位)、行业编码(2位)、类型编码(3位)和序号(7位)四个码段共20位十
->进制数字字符构成,即系统编码 =中心编码 + 行业编码 + 类型编码 + 序号。
-> 编码规则 A 的详细说明见表 D.1。其中,中心编码指用户或设备所归属的监控中心的编码,按照监控中心所在地的行政区划代码确定,
-> 当不是基层单位时空余位为0。行政区划代码采用 GB/T2260— 2007规定的行政区划代码表示。行业编码是指用户或设备所归属的行业,行业编码对照表见 D.3。
-> 类型编码指定了设备或用户的具体类型,其中的前端设备包含公安系统和非公安系统的前端设备,终端用 户包含公安系统和非公安系统的终端用户。
+
+> 编码规则 A 由中心编码(8位)、行业编码(2位)、类型编码(3位)和序号(7位)四个码段共20位十
+> 进制数字字符构成,即系统编码 =中心编码 + 行业编码 + 类型编码 + 序号。
+> 编码规则 A 的详细说明见表 D.1。其中,中心编码指用户或设备所归属的监控中心的编码,按照监控中心所在地的行政区划代码确定,
+> 当不是基层单位时空余位为0。行政区划代码采用 GB/T2260— 2007规定的行政区划代码表示。行业编码是指用户或设备所归属的行业,行业编码对照表见
+> D.3。
+> 类型编码指定了设备或用户的具体类型,其中的前端设备包含公安系统和非公安系统的前端设备,终端用
+> 户包含公安系统和非公安系统的终端用户。


-
-
+
## D.2 编码规则 B
-> 编码规则 B由中心编码(8位)、行业编码(2位)、序号(4位)和类型编码(2位)四个码段构成,即系
->统编码 =中心编码 + 行业编码 +序号+类型编码。编码规则 B的详细说明见表 D.2。
+
+> 编码规则 B由中心编码(8位)、行业编码(2位)、序号(4位)和类型编码(2位)四个码段构成,即系
+> 统编码 =中心编码 + 行业编码 +序号+类型编码。编码规则 B的详细说明见表 D.2。


-
## D.3 行业编码对照表
-> 行业编码对照表见表 D.3。
+
+> 行业编码对照表见表 D.3。


\ No newline at end of file
diff --git a/doc/_content/theory/play.md b/doc/_content/theory/play.md
index fbfdcc661..5fb75c0c7 100644
--- a/doc/_content/theory/play.md
+++ b/doc/_content/theory/play.md
@@ -1,6 +1,7 @@
# 点播流程
+
> 以下为WVP-PRO点播流程。点播成功前的任何一个环节出现问题都可能出现点播超时,这也是排查点播超时的依据。
```plantuml
@@ -18,11 +19,11 @@
@enduml
```
+## 注册流程描述如下:
-## 注册流程描述如下:
-1. 用户从网页或调用接口发起点播请求;
+1. 用户从网页或调用接口发起点播请求;
2. WVP-PRO向摄像机发送Invite消息,消息头域中携带 Subject字段,表明点播的视频源ID、发送方媒体流序列号、ZLMediaKit接收流使用的IP、端口号、
- 接收端媒体流序列号等参数,SDP消息体中 s字段为“Play”代表实时点播,y字段描述SSRC值,f字段描述媒体参数。
+ 接收端媒体流序列号等参数,SDP消息体中 s字段为“Play”代表实时点播,y字段描述SSRC值,f字段描述媒体参数。
3. 摄像机向WVP-PRO回复200OK,消息体中描述了媒体流发送者发送媒体流的IP、端口、媒体格式、SSRC字段等内容。
4. WVP-PRO向设备回复Ack, 会话建立成功。
5. 设备向ZLMediaKit发送实时流。
diff --git a/doc/_content/theory/register.md b/doc/_content/theory/register.md
index fad9589fe..2bc839a32 100644
--- a/doc/_content/theory/register.md
+++ b/doc/_content/theory/register.md
@@ -1,6 +1,7 @@
# 注册流程
+
WVP-PRO目前仅支持国标中描述的基本注册流程,也是最常用的,
> 基本注册即采用IETFRFC3261规定的基于数字摘要的挑战应答式安全技术进行注册.
@@ -13,9 +14,8 @@ WVP-PRO目前仅支持国标中描述的基本注册流程,也是最常用的
@enduml
```
-
-> 注册流程描述如下:
-> 1. 摄像机向WVP-PRO服务器发送 Register请求;
+> 注册流程描述如下:
+> 1. 摄像机向WVP-PRO服务器发送 Register请求;
> 2. WVP-PRO向摄像机发送响应401,并在响应的消息头 WWW_Authenticate字段中给出适合摄像机的认证体制和参数;
> 3. 摄像机重新向WVP-PRO发送 Register请求,在请求的 Authorization字段给出信任书, 包含认证信息;
> 4. WVP-PRO对请求进行验证,如果检查出 摄像机身份合法,向摄像机发送成功响应 200OK,如果身份不合法则发送拒绝服务应答。
diff --git a/doc/_coverpage.md b/doc/_coverpage.md
index eb3524f9a..4f7695885 100644
--- a/doc/_coverpage.md
+++ b/doc/_coverpage.md
@@ -5,8 +5,8 @@
> 开箱即用的28181协议视频平台。
-- 基于GB/T28181-2016标准信令实现,兼容GB/T28181-2011。
-- 自带完整前端页面,开箱即用。
+- 基于GB/T28181-2016标准信令实现,兼容GB/T28181-2011。
+- 自带完整前端页面,开箱即用。
- 完全开源,且使用MIT许可协议。可以在保留版权信息的基础上商用。
[GitHub](https://github.com/648540858/wvp-GB28181-pro)
diff --git a/doc/_media/2.png b/doc/_media/2.png
index dd982e1e5..28d74b2dc 100644
Binary files a/doc/_media/2.png and b/doc/_media/2.png differ
diff --git a/doc/_media/3-1.png b/doc/_media/3-1.png
index a52620f2f..0e62c36e4 100644
Binary files a/doc/_media/3-1.png and b/doc/_media/3-1.png differ
diff --git a/doc/_media/3-2.png b/doc/_media/3-2.png
index bef780eb2..c75cef908 100644
Binary files a/doc/_media/3-2.png and b/doc/_media/3-2.png differ
diff --git a/doc/_media/index.png b/doc/_media/index.png
index 15200e69b..46fe99bb2 100644
Binary files a/doc/_media/index.png and b/doc/_media/index.png differ
diff --git a/doc/_sidebar.md b/doc/_sidebar.md
index 09a675df0..d1f500c4b 100644
--- a/doc/_sidebar.md
+++ b/doc/_sidebar.md
@@ -1,34 +1,32 @@
* **编译与部署**
- * [编译](_content/introduction/compile.md)
- * [配置](_content/introduction/config.md)
- * [部署](_content/introduction/deployment.md)
+ * [编译](_content/introduction/compile.md)
+ * [配置](_content/introduction/config.md)
+ * [部署](_content/introduction/deployment.md)
* **功能与使用**
- * [接入设备](_content/ability/device.md)
- * [设备使用](_content/ability/device_use.md)
- * [国标级联](_content/ability/cascade2.md)
- * [推流列表](_content/ability/push.md)
- * [拉流代理](_content/ability/proxy.md)
- * [电子地图](_content/ability/gis.md)
- * [节点管理](_content/ability/node_manger.md)
- * [云端录像](_content/ability/cloud_record.md)
- * [不间断录像](_content/ability/continuous_recording.md)
- * [语音对讲](_content/ability/continuous_broadcast.md)
+ * [接入设备](_content/ability/device.md)
+ * [国标设备](_content/ability/device_use.md)
+ * [推流列表](_content/ability/push.md)
+ * [拉流代理](_content/ability/proxy.md)
+ * [云端录像](_content/ability/cloud_record.md)
+ * [节点管理](_content/ability/node_manger.md)
+ * [通道管理](_content/ability/channel.md)
+ * [国标级联](_content/ability/cascade2.md)
* **流程与原理**
- * [统一编码规则](_content/theory/code.md)
- * [树形结构](_content/theory/channel_tree.md)
- * [注册流程](_content/theory/register.md)
- * [点播流程](_content/theory/play.md)
- * [级联语音喊话流程](_content/theory/broadcast_cascade.md)
+ * [统一编码规则](_content/theory/code.md)
+ * [注册流程](_content/theory/register.md)
+ * [点播流程](_content/theory/play.md)
+ * [级联语音喊话流程](_content/theory/broadcast_cascade.md)
+ * [语音对讲](_content/ability/continuous_broadcast.md)
* **必备技巧**
- * [抓包](_content/skill/tcpdump.md)
+ * [抓包](_content/skill/tcpdump.md)
* **常见问答**
- - [如何反馈BUG](_content/qa/bug.md)
- - [如何参与开发](_content/qa/development.md)
- - [启动报错的解决办法](_content/qa/start_error.md)
- - [设备注册不上来的解决办法](_content/qa/regiser_error.md)
- - [点播超时/报错的解决办法](_content/qa/play_error.md)
+ - [如何反馈BUG](_content/qa/bug.md)
+ - [如何参与开发](_content/qa/development.md)
+ - [启动报错的解决办法](_content/qa/start_error.md)
+ - [设备注册不上来的解决办法](_content/qa/regiser_error.md)
+ - [点播超时/报错的解决办法](_content/qa/play_error.md)
* [**免责声明**](_content/disclaimers.md)
* [**关于本文档**](_content/about_doc.md)
diff --git a/doc/index.html b/doc/index.html
index 580603da4..a8c1d7dfd 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -1,59 +1,59 @@
-
- WVP-PRO文档
-
-
-
-
-
-
-
+
+ WVP-PRO文档
+
+
+
+
+
+
+
- 加载中
-
-
-
-
-
-
-
+
+
+
+
+
+
+
-
+
diff --git a/pom.xml b/pom.xml
index d730641ef..5d818fcda 100644
--- a/pom.xml
+++ b/pom.xml
@@ -11,7 +11,7 @@
com.genersoft
wvp-pro
- 2.7.2
+ 2.7.3
web video platform
国标28181视频平台
${project.packaging}
@@ -133,6 +133,14 @@
spring-boot-starter-jdbc
+
+
+ com.alibaba
+ druid-spring-boot-starter
+ 1.2.23
+
+
+
com.mysql
@@ -344,13 +352,13 @@
ftpserver-core
1.2.0
+
org.apache.ftpserver
ftplet-api
1.2.0
-
org.projectlombok
@@ -359,6 +367,13 @@
provided
+
+
+ org.projectlombok
+ lombok
+ 1.18.30
+ provided
+
org.springframework.boot
@@ -415,7 +430,7 @@
3.3.0
- **/all-application.yml
+ **/配置详情.yml
**/application.yml
**/application-*.yml
**/local.jks
diff --git a/src/main/java/com/genersoft/iot/vmp/VManageBootstrap.java b/src/main/java/com/genersoft/iot/vmp/VManageBootstrap.java
index 262910b0b..e838cc8eb 100644
--- a/src/main/java/com/genersoft/iot/vmp/VManageBootstrap.java
+++ b/src/main/java/com/genersoft/iot/vmp/VManageBootstrap.java
@@ -2,8 +2,7 @@ package com.genersoft.iot.vmp;
import com.genersoft.iot.vmp.utils.GitUtil;
import com.genersoft.iot.vmp.utils.SpringBeanFactory;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
@@ -26,19 +25,22 @@ import java.util.Collections;
@SpringBootApplication
@EnableScheduling
@EnableCaching
+@Slf4j
public class VManageBootstrap extends SpringBootServletInitializer {
- private final static Logger logger = LoggerFactory.getLogger(VManageBootstrap.class);
-
private static String[] args;
private static ConfigurableApplicationContext context;
public static void main(String[] args) {
VManageBootstrap.args = args;
VManageBootstrap.context = SpringApplication.run(VManageBootstrap.class, args);
- GitUtil gitUtil1 = SpringBeanFactory.getBean("gitUtil");
- logger.info("构建版本: {}", gitUtil1.getBuildVersion());
- logger.info("构建时间: {}", gitUtil1.getBuildDate());
- logger.info("GIT最后提交时间: {}", gitUtil1.getCommitTime());
+ GitUtil gitUtil = SpringBeanFactory.getBean("gitUtil");
+ if (gitUtil == null) {
+ log.info("获取版本信息失败");
+ }else {
+ log.info("构建版本: {}", gitUtil.getBuildVersion());
+ log.info("构建时间: {}", gitUtil.getBuildDate());
+ log.info("GIT最后提交时间: {}", gitUtil.getCommitTime());
+ }
}
// 项目重启
public static void restart() {
diff --git a/src/main/java/com/genersoft/iot/vmp/common/CivilCodePo.java b/src/main/java/com/genersoft/iot/vmp/common/CivilCodePo.java
index 452c12efe..38851977b 100644
--- a/src/main/java/com/genersoft/iot/vmp/common/CivilCodePo.java
+++ b/src/main/java/com/genersoft/iot/vmp/common/CivilCodePo.java
@@ -1,5 +1,7 @@
package com.genersoft.iot.vmp.common;
+import org.springframework.util.ObjectUtils;
+
public class CivilCodePo {
private String code;
@@ -12,7 +14,9 @@ public class CivilCodePo {
CivilCodePo civilCodePo = new CivilCodePo();
civilCodePo.setCode(infoArray[0]);
civilCodePo.setName(infoArray[1]);
- civilCodePo.setParentCode(infoArray[2]);
+ if (!ObjectUtils.isEmpty(infoArray[2])) {
+ civilCodePo.setParentCode(infoArray[2]);
+ }
return civilCodePo;
}
diff --git a/src/main/java/com/genersoft/iot/vmp/common/CommonGbChannel.java b/src/main/java/com/genersoft/iot/vmp/common/CommonGbChannel.java
deleted file mode 100644
index b289a14a2..000000000
--- a/src/main/java/com/genersoft/iot/vmp/common/CommonGbChannel.java
+++ /dev/null
@@ -1,191 +0,0 @@
-package com.genersoft.iot.vmp.common;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-
-public class CommonGbChannel {
-
- /**
- * 国标字段:归属
- */
- @Schema(description = "归属")
- private String owner;
-
- /**
- * 国标字段:行政区划
- */
- @Schema(description = "行政区划")
- private String civilCode;
-
- /**
- * 国标字段:安装地址
- */
- @Schema(description = "安装地址")
- private String address;
-
- /**
- * 国标字段:经度
- */
- @Schema(description = "经度")
- private Double longitude;
-
- /**
- * 国标字段:纬度
- */
- @Schema(description = "纬度")
- private Double latitude;
-
- /**
- * 国标字段:摄像机类型:
- * 1-球机;
- * 2-半球;
- * 3-固定枪机;
- * 4-遥控枪机
- */
- @Schema(description = "摄像机类型")
- private Integer ptzType;
-
- /**
- * 国标字段:摄像机位置类型扩展。
- * 1-省际检查站、
- * 2-党政机关、
- * 3-车站码头、
- * 4-中心广场、
- * 5-体育场馆、
- * 6-商业中心、
- * 7-宗教场所、
- * 8-校园周边、
- * 9-治安复杂区域、
- * 10-交通干线
- */
- @Schema(description = "摄像机位置类型扩展")
- private Integer positionType;
-
- /**
- * 国标字段:安装位置室外、室内属性
- * 1-室外、
- * 2-室内
- */
- @Schema(description = "安装位置室外、室内属性")
- private Integer roomType;
-
- /**
- * 国标字段:用途
- * 1-治安、
- * 2-交通、
- * 3-重点、
- */
- @Schema(description = "用途")
- private Integer useType;
-
- /**
- * 国标字段:补光属性
- * 1-无补光、
- * 2-红外补光、
- * 3-白光补光
- */
- @Schema(description = "补光属性")
- private Integer supplyLightType;
-
- /**
- * 摄像机监视方位属性。
- * 1-东、
- * 2-西、
- * 3-南、
- * 4-北、
- * 5-东南、
- * 6-东北、
- * 7-西南、
- * 8-西北
- *
- */
- @Schema(description = "方位")
- private Integer directionType;
-
- public String getOwner() {
- return owner;
- }
-
- public void setOwner(String owner) {
- this.owner = owner;
- }
-
- public String getCivilCode() {
- return civilCode;
- }
-
- public void setCivilCode(String civilCode) {
- this.civilCode = civilCode;
- }
-
- public String getAddress() {
- return address;
- }
-
- public void setAddress(String address) {
- this.address = address;
- }
-
- public Double getLongitude() {
- return longitude;
- }
-
- public void setLongitude(Double longitude) {
- this.longitude = longitude;
- }
-
- public Double getLatitude() {
- return latitude;
- }
-
- public void setLatitude(Double latitude) {
- this.latitude = latitude;
- }
-
- public Integer getPtzType() {
- return ptzType;
- }
-
- public void setPtzType(Integer ptzType) {
- this.ptzType = ptzType;
- }
-
- public Integer getPositionType() {
- return positionType;
- }
-
- public void setPositionType(Integer positionType) {
- this.positionType = positionType;
- }
-
- public Integer getRoomType() {
- return roomType;
- }
-
- public void setRoomType(Integer roomType) {
- this.roomType = roomType;
- }
-
- public Integer getUseType() {
- return useType;
- }
-
- public void setUseType(Integer useType) {
- this.useType = useType;
- }
-
- public Integer getSupplyLightType() {
- return supplyLightType;
- }
-
- public void setSupplyLightType(Integer supplyLightType) {
- this.supplyLightType = supplyLightType;
- }
-
- public Integer getDirectionType() {
- return directionType;
- }
-
- public void setDirectionType(Integer directionType) {
- this.directionType = directionType;
- }
-}
diff --git a/src/main/java/com/genersoft/iot/vmp/common/InviteInfo.java b/src/main/java/com/genersoft/iot/vmp/common/InviteInfo.java
index dbe9e090a..8c91dc82a 100644
--- a/src/main/java/com/genersoft/iot/vmp/common/InviteInfo.java
+++ b/src/main/java/com/genersoft/iot/vmp/common/InviteInfo.java
@@ -1,15 +1,17 @@
package com.genersoft.iot.vmp.common;
import com.genersoft.iot.vmp.service.bean.SSRCInfo;
+import lombok.Data;
/**
* 记录每次发送invite消息的状态
*/
+@Data
public class InviteInfo {
private String deviceId;
- private String channelId;
+ private Integer channelId;
private String stream;
@@ -28,7 +30,7 @@ public class InviteInfo {
private StreamInfo streamInfo;
- public static InviteInfo getInviteInfo(String deviceId, String channelId, String stream, SSRCInfo ssrcInfo,
+ public static InviteInfo getInviteInfo(String deviceId, Integer channelId, String stream, SSRCInfo ssrcInfo,
String receiveIp, Integer receivePort, String streamMode,
InviteSessionType type, InviteSessionStatus status) {
InviteInfo inviteInfo = new InviteInfo();
@@ -44,84 +46,4 @@ public class InviteInfo {
return inviteInfo;
}
- public String getDeviceId() {
- return deviceId;
- }
-
- public void setDeviceId(String deviceId) {
- this.deviceId = deviceId;
- }
-
- public String getChannelId() {
- return channelId;
- }
-
- public void setChannelId(String channelId) {
- this.channelId = channelId;
- }
-
- public InviteSessionType getType() {
- return type;
- }
-
- public void setType(InviteSessionType type) {
- this.type = type;
- }
-
- public InviteSessionStatus getStatus() {
- return status;
- }
-
- public void setStatus(InviteSessionStatus status) {
- this.status = status;
- }
-
- public StreamInfo getStreamInfo() {
- return streamInfo;
- }
-
- public void setStreamInfo(StreamInfo streamInfo) {
- this.streamInfo = streamInfo;
- }
-
- public String getStream() {
- return stream;
- }
-
- public void setStream(String stream) {
- this.stream = stream;
- }
-
- public SSRCInfo getSsrcInfo() {
- return ssrcInfo;
- }
-
- public void setSsrcInfo(SSRCInfo ssrcInfo) {
- this.ssrcInfo = ssrcInfo;
- }
-
- public String getReceiveIp() {
- return receiveIp;
- }
-
- public void setReceiveIp(String receiveIp) {
- this.receiveIp = receiveIp;
- }
-
- public Integer getReceivePort() {
- return receivePort;
- }
-
- public void setReceivePort(Integer receivePort) {
- this.receivePort = receivePort;
- }
-
- public String getStreamMode() {
- return streamMode;
- }
-
- public void setStreamMode(String streamMode) {
- this.streamMode = streamMode;
- }
-
}
diff --git a/src/main/java/com/genersoft/iot/vmp/common/StreamInfo.java b/src/main/java/com/genersoft/iot/vmp/common/StreamInfo.java
index 96a987c94..280c11ba0 100644
--- a/src/main/java/com/genersoft/iot/vmp/common/StreamInfo.java
+++ b/src/main/java/com/genersoft/iot/vmp/common/StreamInfo.java
@@ -1,12 +1,14 @@
package com.genersoft.iot.vmp.common;
import com.genersoft.iot.vmp.media.bean.MediaInfo;
+import com.genersoft.iot.vmp.media.bean.MediaServer;
import com.genersoft.iot.vmp.service.bean.DownloadFileInfo;
import io.swagger.v3.oas.annotations.media.Schema;
import java.io.Serializable;
import java.util.Objects;
+
@Schema(description = "流信息")
public class StreamInfo implements Serializable, Cloneable{
@@ -15,9 +17,9 @@ public class StreamInfo implements Serializable, Cloneable{
@Schema(description = "流ID")
private String stream;
@Schema(description = "设备编号")
- private String deviceID;
- @Schema(description = "通道编号")
- private String channelId;
+ private String deviceId;
+ @Schema(description = "通道ID")
+ private Integer channelId;
@Schema(description = "IP")
private String ip;
@@ -68,8 +70,8 @@ public class StreamInfo implements Serializable, Cloneable{
@Schema(description = "RTCS流地址")
private StreamURL rtcs;
- @Schema(description = "流媒体ID")
- private String mediaServerId;
+ @Schema(description = "流媒体节点")
+ private MediaServer mediaServer;
@Schema(description = "流编码信息")
private MediaInfo mediaInfo;
@Schema(description = "开始时间")
@@ -80,6 +82,8 @@ public class StreamInfo implements Serializable, Cloneable{
private double progress;
@Schema(description = "文件下载地址(录像下载使用)")
private DownloadFileInfo downLoadFilePath;
+ @Schema(description = "点播请求的callId")
+ private String callId;
@Schema(description = "是否暂停(录像回放使用)")
private boolean pause;
@@ -90,6 +94,9 @@ public class StreamInfo implements Serializable, Cloneable{
@Schema(description = "转码后的视频流")
private StreamInfo transcodeStream;
+ @Schema(description = "使用的WVP ID")
+ private String serverId;
+
public void setFlv(StreamURL flv) {
this.flv = flv;
}
@@ -352,19 +359,19 @@ public class StreamInfo implements Serializable, Cloneable{
this.app = app;
}
- public String getDeviceID() {
- return deviceID;
+ public String getDeviceId() {
+ return deviceId;
}
- public void setDeviceID(String deviceID) {
- this.deviceID = deviceID;
+ public void setDeviceId(String deviceId) {
+ this.deviceId = deviceId;
}
- public String getChannelId() {
+ public Integer getChannelId() {
return channelId;
}
- public void setChannelId(String channelId) {
+ public void setChannelId(Integer channelId) {
this.channelId = channelId;
}
@@ -480,12 +487,12 @@ public class StreamInfo implements Serializable, Cloneable{
return rtcs;
}
- public String getMediaServerId() {
- return mediaServerId;
+ public MediaServer getMediaServer() {
+ return mediaServer;
}
- public void setMediaServerId(String mediaServerId) {
- this.mediaServerId = mediaServerId;
+ public void setMediaServer(MediaServer mediaServer) {
+ this.mediaServer = mediaServer;
}
public MediaInfo getMediaInfo() {
@@ -646,4 +653,20 @@ public class StreamInfo implements Serializable, Cloneable{
public void setOriginType(int originType) {
this.originType = originType;
}
+
+ public String getServerId() {
+ return serverId;
+ }
+
+ public void setServerId(String serverId) {
+ this.serverId = serverId;
+ }
+
+ public String getCallId() {
+ return callId;
+ }
+
+ public void setCallId(String callId) {
+ this.callId = callId;
+ }
}
diff --git a/src/main/java/com/genersoft/iot/vmp/common/VideoManagerConstants.java b/src/main/java/com/genersoft/iot/vmp/common/VideoManagerConstants.java
index 8be6835fd..3d5597563 100644
--- a/src/main/java/com/genersoft/iot/vmp/common/VideoManagerConstants.java
+++ b/src/main/java/com/genersoft/iot/vmp/common/VideoManagerConstants.java
@@ -26,7 +26,7 @@ public class VideoManagerConstants {
public static final String KEEPLIVEKEY_PREFIX = "VMP_KEEPALIVE_";
// TODO 此处多了一个_,暂不修改
- public static final String INVITE_PREFIX = "VMP_INVITE";
+ public static final String INVITE_PREFIX = "VMP_INVITE_INFO";
public static final String PLAYER_PREFIX = "VMP_INVITE_PLAY_";
public static final String PLAY_BLACK_PREFIX = "VMP_INVITE_PLAYBACK_";
public static final String DOWNLOAD_PREFIX = "VMP_INVITE_DOWNLOAD_";
@@ -39,7 +39,10 @@ public class VideoManagerConstants {
public static final String PLATFORM_REGISTER_INFO_PREFIX = "VMP_PLATFORM_REGISTER_INFO_";
- public static final String PLATFORM_SEND_RTP_INFO_PREFIX = "VMP_PLATFORM_SEND_RTP_INFO_";
+ public static final String SEND_RTP_INFO = "VMP_SEND_RTP_INFO:";
+ public static final String SEND_RTP_INFO_CALLID = "VMP_SEND_RTP_INFO:CALL_ID";
+ public static final String SEND_RTP_INFO_STREAM = "VMP_SEND_RTP_INFO:STREAM";
+ public static final String SEND_RTP_INFO_CHANNEL = "VMP_SEND_RTP_INFO:CHANNEL";
public static final String EVENT_ONLINE_REGISTER = "1";
@@ -51,7 +54,9 @@ public class VideoManagerConstants {
public static final String MEDIA_SSRC_USED_PREFIX = "VMP_MEDIA_USED_SSRC_";
- public static final String MEDIA_TRANSACTION_USED_PREFIX = "VMP_MEDIA_TRANSACTION_";
+ public static final String SIP_INVITE_SESSION = "VMP_SIP_INVITE_SESSION:";
+ public static final String SIP_INVITE_SESSION_CALL_ID = SIP_INVITE_SESSION + "CALL_ID" + ":";
+ public static final String SIP_INVITE_SESSION_STREAM = SIP_INVITE_SESSION + "STREAM" + ":";
public static final String MEDIA_STREAM_AUTHORITY = "VMP_MEDIA_STREAM_AUTHORITY_";
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/ApiAccessFilter.java b/src/main/java/com/genersoft/iot/vmp/conf/ApiAccessFilter.java
index b449b1b7e..e55c8ecf2 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/ApiAccessFilter.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/ApiAccessFilter.java
@@ -5,9 +5,8 @@ import com.genersoft.iot.vmp.conf.security.SecurityUtils;
import com.genersoft.iot.vmp.service.ILogService;
import com.genersoft.iot.vmp.storager.dao.dto.LogDto;
import com.genersoft.iot.vmp.utils.DateUtil;
+import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
@@ -24,13 +23,11 @@ import java.io.IOException;
/**
* @author lin
*/
+@Slf4j
@WebFilter(filterName = "ApiAccessFilter", urlPatterns = "/api/*", asyncSupported=true)
@Component
public class ApiAccessFilter extends OncePerRequestFilter {
- private final static Logger logger = LoggerFactory.getLogger(ApiAccessFilter.class);
-
-
@Autowired
private UserSetting userSetting;
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/CivilCodeFileConf.java b/src/main/java/com/genersoft/iot/vmp/conf/CivilCodeFileConf.java
index 8449ebb10..878e01c5d 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/CivilCodeFileConf.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/CivilCodeFileConf.java
@@ -2,8 +2,7 @@ package com.genersoft.iot.vmp.conf;
import com.genersoft.iot.vmp.common.CivilCodePo;
import com.genersoft.iot.vmp.utils.CivilCodeUtil;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Configuration;
@@ -17,18 +16,15 @@ import java.io.File;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.file.Files;
-import java.util.ArrayList;
-import java.util.List;
/**
* 启动时读取行政区划表
*/
+@Slf4j
@Configuration
@Order(value=14)
public class CivilCodeFileConf implements CommandLineRunner {
- private final static Logger logger = LoggerFactory.getLogger(CivilCodeFileConf.class);
-
@Autowired
@Lazy
private UserSetting userSetting;
@@ -36,7 +32,7 @@ public class CivilCodeFileConf implements CommandLineRunner {
@Override
public void run(String... args) throws Exception {
if (ObjectUtils.isEmpty(userSetting.getCivilCodeFile())) {
- logger.warn("[行政区划] 文件未设置,可能造成目录刷新结果不完整");
+ log.warn("[行政区划] 文件未设置,可能造成目录刷新结果不完整");
return;
}
InputStream inputStream;
@@ -44,7 +40,7 @@ public class CivilCodeFileConf implements CommandLineRunner {
String filePath = userSetting.getCivilCodeFile().substring("classpath:".length());
ClassPathResource civilCodeFile = new ClassPathResource(filePath);
if (!civilCodeFile.exists()) {
- logger.warn("[行政区划] 文件<{}>不存在,可能造成目录刷新结果不完整", userSetting.getCivilCodeFile());
+ log.warn("[行政区划] 文件<{}>不存在,可能造成目录刷新结果不完整", userSetting.getCivilCodeFile());
return;
}
inputStream = civilCodeFile.getInputStream();
@@ -52,7 +48,7 @@ public class CivilCodeFileConf implements CommandLineRunner {
}else {
File civilCodeFile = new File(userSetting.getCivilCodeFile());
if (!civilCodeFile.exists()) {
- logger.warn("[行政区划] 文件<{}>不存在,可能造成目录刷新结果不完整", userSetting.getCivilCodeFile());
+ log.warn("[行政区划] 文件<{}>不存在,可能造成目录刷新结果不完整", userSetting.getCivilCodeFile());
return;
}
inputStream = Files.newInputStream(civilCodeFile.toPath());
@@ -61,7 +57,6 @@ public class CivilCodeFileConf implements CommandLineRunner {
BufferedReader inputStreamReader = new BufferedReader(new InputStreamReader(inputStream));
int index = -1;
String line;
- List civilCodePoList = new ArrayList<>();
while ((line = inputStreamReader.readLine()) != null) {
index ++;
if (index == 0) {
@@ -69,15 +64,14 @@ public class CivilCodeFileConf implements CommandLineRunner {
}
String[] infoArray = line.split(",");
CivilCodePo civilCodePo = CivilCodePo.getInstance(infoArray);
- civilCodePoList.add(civilCodePo);
+ CivilCodeUtil.INSTANCE.add(civilCodePo);
}
- CivilCodeUtil.INSTANCE.add(civilCodePoList);
inputStreamReader.close();
inputStream.close();
- if (civilCodePoList.isEmpty()) {
- logger.warn("[行政区划] 文件内容为空,可能造成目录刷新结果不完整");
+ if (CivilCodeUtil.INSTANCE.isEmpty()) {
+ log.warn("[行政区划] 文件内容为空,可能造成目录刷新结果不完整");
}else {
- logger.info("[行政区划] 加载成功,共加载数据{}条", civilCodePoList.size());
+ log.info("[行政区划] 加载成功,共加载数据{}条", CivilCodeUtil.INSTANCE.size());
}
}
}
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/CloudRecordTimer.java b/src/main/java/com/genersoft/iot/vmp/conf/CloudRecordTimer.java
index de87a9c62..652853bb0 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/CloudRecordTimer.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/CloudRecordTimer.java
@@ -5,8 +5,7 @@ import com.genersoft.iot.vmp.media.bean.MediaServer;
import com.genersoft.iot.vmp.media.service.IMediaServerService;
import com.genersoft.iot.vmp.service.bean.CloudRecordItem;
import com.genersoft.iot.vmp.storager.dao.CloudRecordServiceMapper;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@@ -19,11 +18,10 @@ import java.util.List;
/**
* 录像文件定时删除
*/
+@Slf4j
@Component
public class CloudRecordTimer {
- private final static Logger logger = LoggerFactory.getLogger(CloudRecordTimer.class);
-
@Autowired
private IMediaServerService mediaServerService;
@@ -36,7 +34,7 @@ public class CloudRecordTimer {
// @Scheduled(fixedRate = 10000) //每五秒执行一次,方便测试
@Scheduled(cron = "0 0 0 * * ?") //每天的0点执行
public void execute(){
- logger.info("[录像文件定时清理] 开始清理过期录像文件");
+ log.info("[录像文件定时清理] 开始清理过期录像文件");
// 获取配置了assist的流媒体节点
List mediaServerItemList = mediaServerService.getAllOnline();
if (mediaServerItemList.isEmpty()) {
@@ -64,12 +62,12 @@ public class CloudRecordTimer {
boolean deleteResult = mediaServerService.deleteRecordDirectory(mediaServerItem, cloudRecordItem.getApp(),
cloudRecordItem.getStream(), date, cloudRecordItem.getFileName());
if (deleteResult) {
- logger.warn("[录像文件定时清理] 删除磁盘文件成功: {}", cloudRecordItem.getFilePath());
+ log.warn("[录像文件定时清理] 删除磁盘文件成功: {}", cloudRecordItem.getFilePath());
}
}
result += cloudRecordServiceMapper.deleteList(cloudRecordItemList);
}
}
- logger.info("[录像文件定时清理] 共清理{}个过期录像文件", result);
+ log.info("[录像文件定时清理] 共清理{}个过期录像文件", result);
}
}
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/DynamicTask.java b/src/main/java/com/genersoft/iot/vmp/conf/DynamicTask.java
index de0e2df57..a56d4090b 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/DynamicTask.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/DynamicTask.java
@@ -1,8 +1,7 @@
package com.genersoft.iot.vmp.conf;
+import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.ObjectUtils;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.scheduling.concurrent.ThreadPoolTaskScheduler;
import org.springframework.stereotype.Component;
@@ -20,11 +19,10 @@ import java.util.concurrent.TimeUnit;
* 动态定时任务
* @author lin
*/
+@Slf4j
@Component
public class DynamicTask {
- private final Logger logger = LoggerFactory.getLogger(DynamicTask.class);
-
private ThreadPoolTaskScheduler threadPoolTaskScheduler;
private final Map> futureMap = new ConcurrentHashMap<>();
@@ -53,9 +51,9 @@ public class DynamicTask {
ScheduledFuture> future = futureMap.get(key);
if (future != null) {
if (future.isCancelled()) {
- logger.debug("任务【{}】已存在但是关闭状态!!!", key);
+ log.debug("任务【{}】已存在但是关闭状态!!!", key);
} else {
- logger.debug("任务【{}】已存在且已启动!!!", key);
+ log.debug("任务【{}】已存在且已启动!!!", key);
return;
}
}
@@ -65,9 +63,9 @@ public class DynamicTask {
if (future != null){
futureMap.put(key, future);
runnableMap.put(key, task);
- logger.debug("任务【{}】启动成功!!!", key);
+ log.debug("任务【{}】启动成功!!!", key);
}else {
- logger.debug("任务【{}】启动失败!!!", key);
+ log.debug("任务【{}】启动失败!!!", key);
}
}
@@ -90,9 +88,9 @@ public class DynamicTask {
ScheduledFuture future = futureMap.get(key);
if (future != null) {
if (future.isCancelled()) {
- logger.debug("任务【{}】已存在但是关闭状态!!!", key);
+ log.debug("任务【{}】已存在但是关闭状态!!!", key);
} else {
- logger.debug("任务【{}】已存在且已启动!!!", key);
+ log.debug("任务【{}】已存在且已启动!!!", key);
return;
}
}
@@ -101,9 +99,9 @@ public class DynamicTask {
if (future != null){
futureMap.put(key, future);
runnableMap.put(key, task);
- logger.debug("任务【{}】启动成功!!!", key);
+ log.debug("任务【{}】启动成功!!!", key);
}else {
- logger.debug("任务【{}】启动失败!!!", key);
+ log.debug("任务【{}】启动失败!!!", key);
}
}
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/GlobalExceptionHandler.java b/src/main/java/com/genersoft/iot/vmp/conf/GlobalExceptionHandler.java
index 0333e0dc3..5e29ff42f 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/GlobalExceptionHandler.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/GlobalExceptionHandler.java
@@ -3,8 +3,7 @@ package com.genersoft.iot.vmp.conf;
import com.genersoft.iot.vmp.conf.exception.ControllerException;
import com.genersoft.iot.vmp.vmanager.bean.ErrorCode;
import com.genersoft.iot.vmp.vmanager.bean.WVPResult;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.security.authentication.BadCredentialsException;
@@ -16,11 +15,10 @@ import org.springframework.web.bind.annotation.RestControllerAdvice;
/**
* 全局异常处理
*/
+@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {
- private final static Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
-
/**
* 默认异常处理
* @param e 异常
@@ -29,7 +27,7 @@ public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public WVPResult exceptionHandler(Exception e) {
- logger.error("[全局异常]: ", e);
+ log.error("[全局异常]: ", e);
return WVPResult.fail(ErrorCode.ERROR500.getCode(), e.getMessage());
}
@@ -54,6 +52,16 @@ public class GlobalExceptionHandler {
public WVPResult exceptionHandler(HttpRequestMethodNotSupportedException e) {
return WVPResult.fail(ErrorCode.ERROR400);
}
+ /**
+ * 断言异常处理
+ * @param e 异常
+ * @return 统一返回结果
+ */
+ @ExceptionHandler(IllegalArgumentException.class)
+ @ResponseStatus(HttpStatus.OK)
+ public WVPResult exceptionHandler(IllegalArgumentException e) {
+ return WVPResult.fail(ErrorCode.ERROR100.getCode(), e.getMessage());
+ }
/**
@@ -62,7 +70,7 @@ public class GlobalExceptionHandler {
* @return 统一返回结果
*/
@ExceptionHandler(ControllerException.class)
- @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
+ @ResponseStatus(HttpStatus.OK)
public ResponseEntity> exceptionHandler(ControllerException e) {
return new ResponseEntity<>(WVPResult.fail(e.getCode(), e.getMsg()), HttpStatus.OK);
}
diff --git a/src/main/java/com/genersoft/iot/vmp/conf/GlobalResponseAdvice.java b/src/main/java/com/genersoft/iot/vmp/conf/GlobalResponseAdvice.java
index 33fdd23df..af12ecabd 100644
--- a/src/main/java/com/genersoft/iot/vmp/conf/GlobalResponseAdvice.java
+++ b/src/main/java/com/genersoft/iot/vmp/conf/GlobalResponseAdvice.java
@@ -1,12 +1,9 @@
package com.genersoft.iot.vmp.conf;
import com.alibaba.fastjson2.JSON;
-import com.alibaba.fastjson2.support.spring.http.converter.FastJsonHttpMessageConverter;
import com.genersoft.iot.vmp.vmanager.bean.ErrorCode;
import com.genersoft.iot.vmp.vmanager.bean.WVPResult;
import org.jetbrains.annotations.NotNull;
-import org.springframework.boot.autoconfigure.http.HttpMessageConverters;
-import org.springframework.context.annotation.Bean;
import org.springframework.core.MethodParameter;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
@@ -15,6 +12,8 @@ import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;
+import java.util.LinkedHashMap;
+
/**
* 全局统一返回结果
* @author lin
@@ -52,6 +51,13 @@ public class GlobalResponseAdvice implements ResponseBodyAdvice