# 🎬 视频选择器使用指南

## 🎯 新功能介绍

现在Web界面支持**选择本地视频**进行测试！不再需要在命令行指定视频文件，直接在Web界面选择即可。

## 🖥️ 界面功能

### 📋 视频选择区域
- **视频下拉列表** - 显示所有可用的本地视频文件
- **开始视频测试按钮** - 使用选中的视频开始测试
- **刷新视频列表按钮** - 重新扫描视频文件

### 🔍 支持的视频文件

系统会自动扫描以下目录中的视频文件：
- `data/videos/` - 主要测试视频目录
- `videos/` - 备用视频目录
- `.` - 当前目录

支持的视频格式：
- `.mp4` (推荐)
- `.avi`
- `.mov`
- `.mkv`
- `.wmv`
- `.flv`

## 🚀 使用步骤

### 1. 启动服务器
```bash
./start_service.sh
```

### 2. 访问Web界面
打开浏览器访问 `http://localhost:5000`

### 3. 选择视频
- 在"选择测试视频"下拉列表中选择一个视频文件
- 视频显示格式：`文件名 (文件大小)`

### 4. 开始测试
点击"开始视频测试"按钮

### 5. 观察结果
- 查看系统日志中的反馈信息
- 观察视频预览和检测结果
- 查看实时的控制数据

## 📁 添加自定义视频

### 方法1：复制到测试目录
```bash
# 将你的视频文件复制到测试目录
cp /path/to/your/video.mp4 data/videos/

# 在Web界面点击"刷新视频列表"
```

### 方法2：使用脚本生成
```bash
# 生成多种测试视频
python create_test_video.py --type both --duration 20

# 生成自定义视频
python create_test_video.py --type gesture --duration 30 --fps 60
```

## 🎨 下拉列表显示

视频列表会显示以下信息：
- **文件名** - 视频文件的名称
- **文件大小** - 文件大小（MB）
- **状态提示** - 如果没有视频文件，会显示提示信息

示例：
```
请选择视频文件
test_basic.mp4 (1.4MB)
test_gesture.mp4 (1.3MB)
my_hand_video.mp4 (2.1MB)
```

## 🔧 功能特点

### ✅ 自动扫描
- 页面加载时自动扫描视频文件
- 支持多个目录扫描
- 按文件名自动排序

### ✅ 实时反馈
- 显示视频加载状态
- 实时错误提示
- 操作成功确认

### ✅ 文件验证
- 检查视频文件是否存在
- 显示文件大小信息
- 支持多种视频格式

### ✅ 用户友好
- 清晰的操作指引
- 详细的错误提示
- 一键刷新功能

## 🛠️ 错误处理

### 常见错误和解决方案

#### 1. "未找到视频文件"
**原因**：没有视频文件在指定目录
**解决**：
```bash
# 生成测试视频
python create_test_video.py

# 或复制视频文件
cp your_video.mp4 data/videos/
```

#### 2. "请先选择一个视频文件"
**原因**：没有在下拉列表中选择视频
**解决**：在下拉列表中选择一个视频文件

#### 3. "视频文件不存在"
**原因**：选择的视频文件已被删除或移动
**解决**：点击"刷新视频列表"重新扫描

## 📊 系统日志

测试过程中会显示以下日志信息：

### 成功信息
- `✅ 找到 3 个视频文件`
- `✅ 本地测试已开始，使用视频: test_basic.mp4`
- `正在启动视频测试: data/videos/test_gesture.mp4`

### 错误信息
- `❌ 未找到测试视频文件`
- `❌ 请先选择一个视频文件`
- `❌ 视频文件不存在: xxx.mp4`

### 帮助信息
- `💡 运行 python create_test_video.py 生成测试视频`

## 🎯 高级使用

### 批量添加视频
```bash
# 创建多个测试视频
for i in {1..5}; do
    python create_test_video.py --type basic --duration $((i*5)) --output-dir data/videos
    mv data/videos/test_basic.mp4 data/videos/test_basic_${i}.mp4
done
```

### 视频格式转换
```bash
# 如果你的视频格式不支持，可以转换
ffmpeg -i input.mov -c:v libx264 -c:a aac data/videos/output.mp4
```

### 视频质量优化
```bash
# 压缩视频文件
ffmpeg -i input.mp4 -crf 23 -preset medium data/videos/compressed.mp4

# 调整分辨率
ffmpeg -i input.mp4 -vf scale=640:480 data/videos/resized.mp4
```

## 🔄 与命令行模式的区别

### Web界面模式（新）
- ✅ 图形化选择视频
- ✅ 实时预览文件列表
- ✅ 一键刷新功能
- ✅ 错误提示更友好

### 命令行模式（旧）
- 需要手动指定视频路径
- 需要重启服务器切换视频
- 错误信息在终端显示

## 🎉 现在就试试吧！

1. 确保有测试视频：`python create_test_video.py`
2. 启动服务器：`./start_service.sh`
3. 访问：`http://localhost:5000`
4. 选择视频并开始测试！

享受更便捷的视频测试体验！ 🚀