# VideoInsight-视频分析

**Repository Path**: happyfly88/video-analysis

## Basic Information

- **Project Name**: VideoInsight-视频分析
- **Description**: 视频解析工具，专注于视频内容分析，自动生成详尽的分析报告，适用于媒体处理、监控分析等场景。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-05-30
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video Analysis Tool

一个强大的视频分析工具，能够从视频中提取关键帧并使用深度学习模型进行图像识别分析。支持本地模型识别和腾讯云图像识别服务。

## 功能特点

- 视频关键帧提取：使用FFmpeg自动提取视频关键帧
- 双重识别模式：
  - 本地识别：使用DJL (Deep Java Library) 和预训练的ResNet-50模型
  - 云端识别：集成腾讯云图像识别服务（TIIA）
- 灵活的配置选项：支持通过YAML配置文件自定义各项参数
- 高性能：支持异步处理和并行识别
- 详细的分析报告：输出JSON格式的识别结果

## 技术栈

- Java 21
- FFmpeg：视频处理
- DJL (Deep Java Library)：本地深度学习推理
- 腾讯云 TIIA SDK：云端图像识别
- Maven：项目管理和构建
- Jackson：JSON处理
- SLF4J & Logback：日志管理
- SnakeYAML：配置文件解析

## 系统要求

- Java 21 或更高版本
- FFmpeg 安装并添加到系统环境变量
- Maven 3.6 或更高版本（仅构建时需要）
- 至少 4GB RAM（推荐 8GB 或更多）

## 安装说明

1. 克隆项目：
```bash
git clone [项目地址]
cd video-analysis
```

2. 使用Maven构建项目：
```bash
mvn clean package
```

构建完成后，将在 `target` 目录下生成可执行的 JAR 文件。

## 配置说明

在 `src/main/resources` 目录下创建 `app.yaml` 文件：

```yaml
ffmpeg:
  path: ffmpeg  # FFmpeg可执行文件路径
  frameIntervalSeconds: 2  # 关键帧提取间隔（秒）

recognition:
  type: tencent  # 识别器类型：local 或 tencent
  maxResults: 5  # 每张图片返回的最大识别结果数
  local:
    detectFaces: true
    analyzeColors: true
    detectEdges: true

tencentCloud:
  region: ap-guangzhou
  endpoint: tiia.tencentcloudapi.com
  credentials:
    secretIdEnv: TENCENT_SECRET_ID    # 环境变量名
    secretKeyEnv: TENCENT_SECRET_KEY  # 环境变量名
    # 或直接配置密钥（不推荐）
    # secretId: your-secret-id
    # secretKey: your-secret-key
  recognition:
    maxResults: 5

output:
  directory: output  # 输出目录
```

## 使用方法

1. 设置环境变量（如果使用腾讯云服务）：
```bash
export TENCENT_SECRET_ID=your-secret-id
export TENCENT_SECRET_KEY=your-secret-key
```

2. 运行程序：
```bash
java -jar target/video-analysis-1.0-SNAPSHOT-jar-with-dependencies.jar <视频文件路径>
```

程序将在配置的输出目录中生成以下内容：
- 提取的关键帧图像
- 识别结果的JSON文件
- 分析报告

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎提交问题和合并请求。对于重大更改，请先开issue讨论您想要更改的内容。

## 致谢

- [FFmpeg](https://ffmpeg.org/)
- [Deep Java Library](https://djl.ai/)
- [腾讯云 TIIA](https://cloud.tencent.com/product/tiia)