首次上传
This commit is contained in:
ERT
169
README.md
Normal file
169
README.md
Normal file
@@ -0,0 +1,169 @@
|
||||
<<<<<<< HEAD
|
||||
# traepro-videoserver
|
||||
|
||||
=======
|
||||
# Trae Video Server
|
||||
|
||||
一个基于Electron的专业视频采集和流媒体服务程序，支持实时视频预览和网络流媒体分发。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- 🎥 **设备管理**: 自动检测并列出所有可用的视频采集设备
|
||||
- 📺 **实时预览**: 在应用程序内显示选定设备的实时视频画面
|
||||
- 🌐 **流媒体服务**: 提供HTTP流媒体服务，支持网页端实时观看
|
||||
- 🎨 **现代UI**: 美观的用户界面，支持响应式设计
|
||||
- ⚡ **高性能**: 优化的视频处理和网络传输
|
||||
|
||||
## 系统要求
|
||||
|
||||
- Node.js 16.0 或更高版本
|
||||
- Windows 10/11, macOS 10.14+, 或 Linux
|
||||
- 至少一个可用的视频采集设备（摄像头）
|
||||
|
||||
## 安装和运行
|
||||
|
||||
### 1. 安装依赖
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
### 2. 启动应用程序
|
||||
|
||||
```bash
|
||||
# 生产模式
|
||||
npm start
|
||||
|
||||
# 开发模式（包含开发者工具）
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 3. 构建可执行文件
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 主要功能
|
||||
|
||||
1. **设备选择**
|
||||
- 启动应用后，程序会自动检测所有可用的视频设备
|
||||
- 在下拉菜单中选择要使用的摄像头
|
||||
- 点击"刷新设备"按钮可重新扫描设备
|
||||
|
||||
2. **开始预览**
|
||||
- 选择设备后，点击"开始预览"按钮
|
||||
- 应用程序下方会显示实时视频画面
|
||||
- 同时启动流媒体服务器
|
||||
|
||||
3. **网络流媒体**
|
||||
- 预览启动后，可通过 `http://localhost:3000/preview` 访问网页版预览
|
||||
- 其他设备可通过网络访问此地址观看实时视频
|
||||
- 支持多客户端同时连接
|
||||
|
||||
4. **停止预览**
|
||||
- 点击"停止预览"按钮结束视频采集
|
||||
- 自动释放设备资源和网络连接
|
||||
|
||||
### 网络访问
|
||||
|
||||
流媒体服务默认运行在端口3000上，提供以下接口：
|
||||
|
||||
- **网页预览**: `http://localhost:3000/preview`
|
||||
- **Socket.IO连接**: 用于实时视频帧传输
|
||||
|
||||
## 技术架构
|
||||
|
||||
### 核心技术栈
|
||||
|
||||
- **Electron**: 跨平台桌面应用框架
|
||||
- **Express**: Web服务器框架
|
||||
- **Socket.IO**: 实时双向通信
|
||||
- **WebRTC**: 视频采集和处理
|
||||
- **HTML5 Canvas**: 视频帧处理
|
||||
|
||||
### 项目结构
|
||||
|
||||
```
|
||||
trae-video-server/
|
||||
├── main.js # Electron主进程
|
||||
├── index.html # 主界面
|
||||
├── package.json # 项目配置
|
||||
├── assets/ # 资源文件
|
||||
│ └── icon.svg # 应用图标
|
||||
├── public/ # 静态资源
|
||||
│ └── preview.html # 网页预览界面
|
||||
└── README.md # 项目文档
|
||||
```
|
||||
|
||||
### 工作流程
|
||||
|
||||
1. **设备检测**: 使用 `navigator.mediaDevices.enumerateDevices()` 获取设备列表
|
||||
2. **视频采集**: 通过 `getUserMedia()` API 获取视频流
|
||||
3. **帧处理**: 使用Canvas将视频帧转换为图像数据
|
||||
4. **网络传输**: 通过Socket.IO将帧数据广播给所有连接的客户端
|
||||
5. **实时显示**: 客户端接收帧数据并实时更新显示
|
||||
|
||||
## 配置选项
|
||||
|
||||
### 视频参数
|
||||
|
||||
默认视频配置（可在代码中修改）：
|
||||
- 分辨率: 1280x720
|
||||
- 帧率: 30 FPS（网络传输）
|
||||
- 图像格式: JPEG
|
||||
- 压缩质量: 80%
|
||||
|
||||
### 网络配置
|
||||
|
||||
- 默认端口: 3000
|
||||
- CORS: 允许所有来源
|
||||
- Socket.IO: 支持跨域连接
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **设备检测失败**
|
||||
- 确保摄像头已正确连接
|
||||
- 检查设备权限设置
|
||||
- 重启应用程序
|
||||
|
||||
2. **预览无法启动**
|
||||
- 确保设备未被其他应用占用
|
||||
- 检查浏览器权限设置
|
||||
- 尝试选择不同的设备
|
||||
|
||||
3. **网络连接问题**
|
||||
- 检查防火墙设置
|
||||
- 确保端口3000未被占用
|
||||
- 验证网络连接状态
|
||||
|
||||
### 调试模式
|
||||
|
||||
使用开发模式启动应用以查看详细日志：
|
||||
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## 许可证
|
||||
|
||||
MIT License - 详见 LICENSE 文件
|
||||
|
||||
## 贡献
|
||||
|
||||
欢迎提交Issue和Pull Request来改进这个项目。
|
||||
|
||||
## 联系方式
|
||||
|
||||
如有问题或建议，请通过以下方式联系：
|
||||
- 创建GitHub Issue
|
||||
- 发送邮件至项目维护者
|
||||
|
||||
---
|
||||
|
||||
**Trae Video Server** - 专业的视频采集与流媒体解决方案
|
||||
>>>>>>> e7062f2 (首次上传)
|
||||
Reference in New Issue
Block a user