# av_quality_platform

**Repository Path**: ydzq/av_quality_platform

## Basic Information

- **Project Name**: av_quality_platform
- **Description**: 流媒体质量测试平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 音视频质量测试平台 (AV Quality Test Platform)

## 项目结构

```
av_quality_platform/
├── README.md
├── requirements.txt
├── config.yaml                    # 全局配置文件
├── main.py                        # 主入口（CLI + 菜单）
│
├── core/
│   ├── __init__.py
│   ├── capture.py                 # 本地摄像头采集模块
│   ├── push.py                    # 推流模块（RTMP/RTSP/SRT → 云端）
│   ├── pull.py                    # 拉流模块（云端 → 本地）
│   ├── render.py                  # 本地视频渲染与展示
│   └── sync_detector.py           # 多路视频时间同步检测
│
├── quality/
│   ├── __init__.py
│   ├── evaluator.py               # 质量评估引擎（PSNR/SSIM/VMAF）
│   ├── metrics.py                 # 指标计算与统计
│   └── reporter.py                # 实时报告与日志输出
│
├── cloud/
│   ├── __init__.py
│   ├── client.py                  # 云端服务API客户端（对接你的架构文档）
│   ├── stream_manager.py          # 云端流管理（创建/查询/删除）
│   └── models.py                  # 云端数据模型
│
├── rtsp/
│   ├── __init__.py
│   ├── multi_pull.py              # 多路RTSP拉流
│   ├── webrtc_adapter.py          # WebRTC适配层
│   └── stream_monitor.py          # 多路流监控器
│
├── ui/
│   ├── __init__.py
│   ├── dashboard.py               # 实时仪表盘（OpenCV窗口）
│   └── stats_overlay.py           # 画质参数叠加层
│
└── utils/
    ├── __init__.py
    ├── config_loader.py           # YAML配置加载
    ├── logger.py                  # 日志工具
    └── ffmpeg_utils.py            # FFmpeg命令构建工具
```

## 功能模块

| 模块 | 功能 |
|------|------|
| capture | 采集本地摄像头视频 |
| push | 推送视频流到云端服务 |
| pull | 从云端拉取视频流 |
| quality | PSNR / SSIM / VMAF 实时评估 |
| rtsp | 多路RTSP拉流 + WebRTC兼容 |
| sync_detector | 多路视频时间同步偏差检测 |
| cloud | 云端服务API对接层 |
| ui | 实时仪表盘 + 画质参数叠加 |

## 快速启动

```bash
pip install -r requirements.txt

# 模式1：本地采集 → 推流 → 拉流 → 质量评估
python main.py --mode local-loop

# 模式2：多路RTSP拉流监控
python main.py --mode multi-rtsp --streams 4

# 模式3：全功能交互式
python main.py --mode full
```