Shikong/gb28181-docking-platform-mocking

Fork 0

shikong 704bf42073 更新 README

2024-03-03 18:10:48 +08:00

4.8 KiB

Raw Permalink Blame History

gb28181-docking-platform-mocking

gb28181 协议对接平台 (设备模拟) gb28181-docking-platform-mocking

项目依赖

如果项目依赖无法拉取请尝试将 maven 配置中 mirror.id maven-default-http-blocker 部分改为

<mirror>
      <id>maven-default-http-blocker</id>
      <!--<mirrorOf>external:http:*</mirrorOf>-->
      <!--放行 http 协议下载 -->
      <mirrorOf>!*</mirrorOf>
      <name>Pseudo repository to mirror external repositories initially using HTTP.</name>
      <url>http://0.0.0.0/</url>
      <blocked>true</blocked>
    </mirror>

项目打包

打包为 jar

mvn clean package

打包后jar在 gb28181-mocking-orm/target/starter.jar

打包为 docker 镜像

一键脚本(纯docker环境打包 + 编译)

chmod +x ./package-docker.sh
./package-docker.sh

打包后的 docker镜像文件位于项目根目录 gb28181-docking-platform-mocking.image

测试运行

docker run --name gb28181-mocking --rm \
  --log-opt max-size=1g \
  --network host \
  -v `pwd`/record:/tmp/record \
  -v `pwd`/application.yml:/opt/gb28181-docking-platform-mocking/application.yml \
  skcks.cn/gb28181-docking-platform-mocking:0.1.0-SNAPSHOT

打包到本地私仓

mvn deploy -DaltDeploymentRepository=amleixun-mvn-reop::default::file:H:/Repository/skcks.cn/gb28181-docking-platform-mvn-repo

git push 推送即可

关于外置 ffmpeg 部分

项目仓库中自带一个 linux amd64 ffmpeg 用于docker打包

如果有其他平台需要可修改位于 gb28181-mocking-starter 的 Dockerfile 文件

linux

linux 各发行版本可使用对应官方源安装或者根据不同平台使用 https://www.johnvansickle.com/ffmpeg/ 提供的免编译版本例:

amd64: https://johnvansickle.com/ffmpeg/builds/ffmpeg-git-amd64-static.tar.xz

arm64: https://johnvansickle.com/ffmpeg/builds/ffmpeg-git-arm64-static.tar.xz

windows

可到 ffmpeg.org 官网查找

或到 github https://github.com/BtbN/FFmpeg-Builds/releases

下载对应版本

例:

win64: https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip

swagger 地址

/swagger-ui/index.html

虚拟设备注册流程

1. 模拟程序添加设备信息

调用 /device/add 添加设备接口

deviceCode*	string 设备编码
gbDeviceId*	string 国标编码
gbChannelId*	string 国标通道id
name*	string 设备名称
address	string 地址
enable	boolean 是否启用
liveStream	string 实时视频流地址

{
  "deviceCode": "[设备编码]",
  "gbDeviceId": "[设备国标编码]",
  "gbChannelId": "[设备国标编码/设备国标通道编码]",
  "name": "[设备名称]",
  "address": "[设备地址]",
  "enable": true,
  "liveStream": "[rtsp 实时流地址]"
}

例:

{
  "id": 1,
  "deviceCode": "XXXXXXXXXXXXXXXXXXXXX",
  "gbDeviceId": "44000100001110000010",
  "gbChannelId": "44000100001310000010",
  "name": "模拟设备",
  "address": "",
  "enable": true,
  "liveStream": "rtsp://admin:123456@10.10.10.120:554"
}

2. 当添加完所有设备后批量注册到 wvp

调用 /gb28181/register 设备注册接口

调用此接口则立即向wvp 批量注册所有启用的设备

关于实时视频地址

rtsp 地址格式为: rtsp://[账号]:[密码]@[ip]:[端口]/[码流地址]

关于历史视频

目前历史视频通过 /video 接口拉取并临时缓存

默认缓存路径为 /tmp/record

因 zlm 本身也有缓存所以也需要一并清理

目前线上通过 linux 自带 crontab 定时任务自动清理

目前每 30 分钟执行一次

0 */30 * * * /opt/gb28181/clean.sh

clean.sh

#!/bin/bash
# 清理历史视频缓存
find /tmp/record -mmin +90 -type f | xargs -d '\n' -r readlink -f | xargs -d '\n' -r rm -rf

# 清理 zlm 缓存
find /opt/gb28181/zlm/www/record/ -mmin +90 -type f | xargs -d '\n' -r readlink -f | xargs -d '\n' -r rm -rf
find /opt/gb28181/zlm/www/record/ -type d -empty -delete

常见问题

如果需要修改设备信息可调用 /device/modify/id 接口修改设备信息,

如果修改的是国标id、国标通道编码，修改后需要重新调用一次 设备注册 接口

如果修改的是设备名称、设备地址，修改后需要在 wvp 界面对应的国标设备刷新更新设备信息
如果实时视频无法播放，请在本地尝试使用 vlc 或其他播放器播放该实时视频

如果本地无法播放请检查设备端口是否开放

如果本地可播放请检查服务器与设备能否通信，或视频编码是否为 h264
如果历史视频点播/下载失败, 请尝试能否成功下载

如果能成功下载, 请使用 ffprobe 确认视频编码是否为 h264

4.8 KiB Raw Permalink Blame History Unescape Escape