193 lines
4.5 KiB
Markdown
193 lines
4.5 KiB
Markdown
# 🎬 视频选择器使用指南
|
||
|
||
## 🎯 新功能介绍
|
||
|
||
现在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. 选择视频并开始测试！
|
||
|
||
享受更便捷的视频测试体验！ 🚀 |