# 视频中台服务端

**Repository Path**: mql003511/video-center-server

## Basic Information

- **Project Name**: 视频中台服务端
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频中台服务端

这是一个 Java 8 + Spring Boot 2.7 的视频中台服务端，当前实现：

- 摄像头管理：新增、查询、修改、删除摄像头配置。
- RTSP 接入：保存摄像头 RTSP 地址，并通过 FFmpeg 拉流录制。
- 电脑摄像头接入：支持 Windows DirectShow 本机摄像头设备名录制。
- 本地保存：视频保存到当前工程 `videos/` 目录。
- 编码格式：输出为 MP4 容器，视频编码为 H.264（FFmpeg `libx264`）。
- 实时预览：通过 FFmpeg 输出 HLS，前端可播放 `/live/{cameraId}/index.m3u8`。
- 本地数据：摄像头和录制任务元数据保存到 `data/` 目录。

## 环境要求

- JDK：`E:\JDK8`
- Maven：`D:\apache-maven-3.6.3`
- Maven 本地仓库：`D:\MavenRep`
- FFmpeg：需要单独安装，并在 `application.yml` 的 `video.ffmpeg-path` 配置可执行文件路径。

## 构建与运行

```powershell
$env:JAVA_HOME='E:\JDK8'
$env:Path="E:\JDK8\bin;$env:Path"
& 'D:\apache-maven-3.6.3\bin\mvn.cmd' '-Dmaven.repo.local=D:\MavenRep' test
& 'D:\apache-maven-3.6.3\bin\mvn.cmd' '-Dmaven.repo.local=D:\MavenRep' package
& 'E:\JDK8\bin\java.exe' -jar target\rtsp-save-server-1.0.0.jar
```

开发环境默认输出日志到 `logs/video-center-dev.log`。生产环境可使用：

```powershell
& 'E:\JDK8\bin\java.exe' -jar target\rtsp-save-server-1.0.0.jar --spring.profiles.active=prod
```

## 接口示例

新增 RTSP 摄像头：

```http
POST /api/cameras
Content-Type: application/json

{
  "name": "北门摄像头",
  "type": "RTSP",
  "rtspUrl": "rtsp://user:password@192.168.1.10:554/stream1",
  "description": "北门入口"
}
```

新增电脑本机摄像头：

```http
POST /api/cameras
Content-Type: application/json

{
  "name": "笔记本摄像头",
  "type": "LOCAL_DEVICE",
  "localDeviceName": "Integrated Camera"
}
```

启动录制：

```http
POST /api/cameras/1/recordings
Content-Type: application/json

{
  "durationSeconds": 60,
  "outputFileName": "north-gate-test.mp4"
}
```

停止录制：

```http
POST /api/cameras/1/recordings/stop
```

启动实时预览：

```http
POST /api/cameras/1/live/start
```

前端播放地址：

```text
http://127.0.0.1:9110/live/1/index.m3u8
```

查询本机摄像头设备：

```http
GET /api/local-devices
```

查询录制记录：

```http
GET /api/recordings
GET /api/cameras/1/recordings
```