diff --git a/README.md b/README.md index 1d7e0d5..3285233 100644 --- a/README.md +++ b/README.md @@ -72,3 +72,110 @@ arm64: https://johnvansickle.com/ffmpeg/builds/ffmpeg-git-arm64-static.tar.xz 例: win64: https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl.zip + +### swagger 地址 +`/swagger-ui/index.html` + +# 虚拟设备注册流程 + +## 1. 模拟程序添加 设备信息 + ++ 调用 `/device/add` 添加设备 接口 + + ```text + deviceCode* string 设备编码 + gbDeviceId* string 国标编码 + gbChannelId* string 国标通道id + name* string 设备名称 + address string 地址 + enable boolean 是否启用 + liveStream string 实时视频流地址 + ``` + + ```json + { + "deviceCode": "[设备编码]", + "gbDeviceId": "[设备国标编码]", + "gbChannelId": "[设备国标编码/设备国标通道编码]", + "name": "[设备名称]", + "address": "[设备地址]", + "enable": true, + "liveStream": "[rtsp 实时流地址]" + } + ``` + + **例:** + + ```json + { + "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 分钟执行一次 + +```bash +0 */30 * * * /opt/gb28181/clean.sh +``` + +clean.sh + +```bash +#!/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