51hhh/checkhand

Fork 0

51hhh 7903ed308f 提交

2025-08-11 12:24:21 +08:00

4.5 KiB

Raw Permalink Blame History

🎬 视频选择器使用指南

🎯 新功能介绍

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

🖥️ 界面功能

📋 视频选择区域

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

🔍 支持的视频文件

系统会自动扫描以下目录中的视频文件：

data/videos/ - 主要测试视频目录
videos/ - 备用视频目录
. - 当前目录

支持的视频格式：

.mp4 (推荐)
.avi
.mov
.mkv
.wmv
.flv

🚀 使用步骤

1. 启动服务器

./start_service.sh

2. 访问Web界面

打开浏览器访问 http://localhost:5000

3. 选择视频

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

4. 开始测试

点击"开始视频测试"按钮

5. 观察结果

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

📁 添加自定义视频

方法1：复制到测试目录

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

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

方法2：使用脚本生成

# 生成多种测试视频
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. "未找到视频文件"

原因：没有视频文件在指定目录解决：

# 生成测试视频
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 生成测试视频

🎯 高级使用

批量添加视频

# 创建多个测试视频
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

视频格式转换

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

视频质量优化

# 压缩视频文件
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界面模式（新）

✅ 图形化选择视频
✅ 实时预览文件列表
✅ 一键刷新功能
✅ 错误提示更友好

命令行模式（旧）

需要手动指定视频路径
需要重启服务器切换视频
错误信息在终端显示

🎉 现在就试试吧！

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

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

4.5 KiB Raw Permalink Blame History Unescape Escape