# VLC-Automation-System **Repository Path**: Pray_C/vlc-automation-system ## Basic Information - **Project Name**: VLC-Automation-System - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-18 - **Last Updated**: 2026-09-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # VLC自动播放系统 (VLC Automation System) 一个功能完整的VLC媒体播放器自动化系统,具有Web界面、定时播放和WebDAV支持功能。 A comprehensive automation system for VLC media player with web interface, scheduling capabilities, and WebDAV support. [![Python](https://img.shields.io/badge/Python-3.7+-blue.svg)](https://www.python.org/) [![VLC](https://img.shields.io/badge/VLC-3.0+-orange.svg)](https://www.videolan.org/vlc/) [![Flask](https://img.shields.io/badge/Flask-2.3+-green.svg)](https://flask.palletsprojects.com/) [![License](https://img.shields.io/badge/License-Open%20Source-brightgreen.svg)](#license) ## 🌟 主要特性 (Key Features) ### 🎵 媒体播放控制 - **VLC集成**: 完整的VLC媒体播放器控制,支持所有VLC支持的音频和视频格式 - **播放列表管理**: 创建、编辑和管理多个播放列表,支持本地和远程文件 - **音量控制**: 独立的音量设置和实时音量调节 - **播放模式**: 支持随机播放、重复播放、单曲循环等多种播放模式 - **实时控制**: 播放、暂停、停止、上一首、下一首、进度跳转 - **媒体信息**: 实时显示当前播放媒体的详细信息 ### ⏰ 自动化调度 - **定时播放**: 基于时间的自动播放调度,支持精确到分钟的时间控制 - **周期性任务**: 支持每日、工作日、周末、自定义星期等不同周期设置 - **多时段管理**: 可设置多个不同时间段的播放任务,互不冲突 - **智能切换**: 自动在不同播放列表间切换,支持淡入淡出效果 - **调度历史**: 详细记录和查看播放历史,便于分析和调试 - **手动控制**: 支持手动启动、停止特定调度任务 ### 🌐 Web界面 - **现代化UI**: 响应式设计,支持桌面和移动设备,界面简洁美观 - **实时状态**: 实时显示播放状态、系统信息和连接状态 - **多语言支持**: 完整的中文和英文界面切换 - **用户认证**: 安全的登录系统,保护系统配置 - **移动优化**: 专门优化的移动端界面,触控友好 - **主题支持**: 支持明暗主题切换 ### 📁 文件管理 - **本地文件**: 支持本地媒体文件播放,自动识别媒体格式 - **双WebDAV支持**: 支持同时连接两个不同的WebDAV服务器 - **文件浏览器**: 内置文件浏览器,支持本地和远程文件浏览 - **媒体识别**: 自动识别音频和视频文件格式,过滤非媒体文件 - **流媒体播放**: 直接从WebDAV服务器流式播放,无需下载 - **中文支持**: 完美支持中文文件名和路径 ### 🔧 系统管理 - **配置管理**: 灵活的JSON配置文件系统,支持热重载 - **日志记录**: 详细的系统日志和错误追踪,便于问题诊断 - **状态监控**: 实时系统状态监控,包括VLC状态、WebDAV连接状态等 - **自动启动**: 支持系统启动时自动运行调度器 - **错误恢复**: 智能错误检测和自动恢复机制 ## 🏗️ 系统架构 (System Architecture) ``` vlc自动播放系统/ ├── main.py # 主程序入口,命令行界面 ├── requirements.txt # Python依赖包列表 ├── start_vlc_automation.bat # Windows启动脚本 ├── start_vlc_automation.ps1 # PowerShell启动脚本 ├── SETUP.md # 详细安装配置指南 ├── config/ # 配置文件目录 │ ├── __init__.py # 配置模块初始化 │ ├── settings.py # 配置管理核心模块 │ ├── config.json # 系统和WebDAV配置 │ ├── playlists.json # 播放列表配置 │ └── schedules.json # 调度任务配置 ├── core/ # 核心功能模块 │ ├── __init__.py # 核心模块初始化 │ ├── vlc_controller.py # VLC媒体播放器控制器 │ ├── scheduler.py # 自动化调度引擎 │ └── webdav_client.py # WebDAV客户端 ├── web/ # Web应用模块 │ ├── __init__.py # Web模块初始化 │ ├── app.py # Flask应用主文件 │ ├── templates/ # HTML模板文件 │ │ ├── index.html # 桌面端主界面 │ │ ├── mobile.html # 移动端界面 │ │ └── login.html # 登录页面 │ └── static/ # 静态资源文件 │ ├── css/ # 样式文件 │ │ ├── style.css # 桌面端样式 │ │ └── mobile.css # 移动端样式 │ ├── js/ # JavaScript文件 │ │ ├── app.js # 桌面端脚本 │ │ └── mobile.js # 移动端脚本 │ └── translations/ # 多语言文件 │ ├── en.json # 英文翻译 │ └── zh.json # 中文翻译 ├── tests/ # 测试文件目录 │ ├── __init__.py # 测试模块初始化 │ └── test_config.py # 配置测试 ├── data/ # 运行时数据目录 └── vlc_automation.log # 系统日志文件 ``` ## 🚀 快速开始 (Quick Start) ### 1. 环境准备 (Prerequisites) ```bash # 检查Python版本 (需要3.7+) python --version # 检查VLC是否已安装 vlc --version # 或在应用程序中查找VLC ``` ### 2. 安装依赖 (Install Dependencies) ```bash # 方法1: 使用内置安装命令 (推荐) python main.py install # 方法2: 手动安装 pip install -r requirements.txt ``` ### 3. 创建示例配置 (Create Sample Configuration) ```bash # 生成示例配置文件 python main.py sample-config ``` ### 4. 启动系统 (Start System) ```bash # 基本启动 python main.py start # 自定义端口启动 python main.py start --port 8080 # 允许网络访问 python main.py start --host 0.0.0.0 # 调试模式启动 python main.py start --debug ``` ### 5. 访问Web界面 (Access Web Interface) - **本地访问**: http://localhost:5000 - **网络访问**: http://your-computer-ip:5000 - **默认登录**: 用户名 `admin`, 密码 `qwe123` ## 📋 详细功能说明 (Detailed Features) ### VLC控制器 (VLC Controller) `core/vlc_controller.py` - 核心VLC控制模块 **功能特性:** - **多媒体支持**: 支持MP3、WAV、FLAC、AAC、OGG、MP4、AVI、MKV等所有VLC支持格式 - **播放列表**: 支持动态播放列表管理,支持随机播放和重复播放 - **音频控制**: 精确音量调节(0-100)、静音控制 - **播放控制**: 播放、暂停、停止、上一首、下一首、进度跳转 - **网络流**: 支持HTTP、HTTPS、FTP等网络流媒体播放 - **状态监控**: 实时播放状态监控和事件回调 - **错误处理**: 完善的错误检测、报告和自动恢复机制 - **单曲循环**: 支持单曲重复播放模式 **主要方法:** ```python # 播放控制 vlc_controller.play() # 开始播放 vlc_controller.pause() # 暂停播放 vlc_controller.stop() # 停止播放 vlc_controller.next_track() # 下一首 vlc_controller.previous_track() # 上一首 # 音量控制 vlc_controller.set_volume(70) # 设置音量 vlc_controller.get_volume() # 获取当前音量 # 播放列表管理 vlc_controller.load_playlist(file_paths, shuffle=False) vlc_controller.set_repeat_mode(True) # 设置重复模式 # 状态获取 vlc_controller.get_state() # 获取播放状态 vlc_controller.get_current_media_info() # 获取当前媒体信息 ``` ### 调度系统 (Scheduler) `core/scheduler.py` - 自动化调度引擎 **功能特性:** - **精确调度**: 基于Python schedule库的精确时间调度 - **灵活配置**: 支持复杂的时间规则设置(每日、工作日、特定日期) - **多任务管理**: 支持多个并发调度任务,自动处理冲突 - **状态管理**: 调度器启动、停止、暂停、恢复等完整生命周期管理 - **历史记录**: 详细的执行历史和统计信息,支持查询和分析 - **手动控制**: 支持手动触发特定调度任务 - **智能切换**: 自动处理播放列表切换,避免播放中断 **调度配置示例:** ```python # 工作日早晨音乐 schedule_entry = ScheduleEntry( name="Morning Music", start_time="07:00", end_time="08:00", playlist_name="English Songs", days_of_week=[0, 1, 2, 3, 4], # 周一到周五 enabled=True, volume=60 ) # 周末放松音乐 weekend_schedule = ScheduleEntry( name="Weekend Relax", start_time="09:00", end_time="11:00", playlist_name="Relaxing Music", days_of_week=[5, 6], # 周六和周日 enabled=True, volume=50 ) ``` ### WebDAV客户端 (WebDAV Client) `core/webdav_client.py` - 远程文件访问模块 **功能特性:** - **双服务器支持**: 同时支持两个不同的WebDAV服务器连接 - **文件浏览**: 递归目录浏览、文件搜索和过滤 - **智能缓存**: 目录列表缓存机制,提高访问速度 - **断线重连**: 自动检测连接状态和智能重连机制 - **中文支持**: 完美支持中文文件名和路径的URL编码/解码 - **流媒体**: 直接生成流媒体URL,无需本地下载 - **错误处理**: 详细的错误信息和连接状态报告 **WebDAV配置示例:** ```json { "webdav": { "url": "https://your-webdav-server.com/webdav", "username": "your-username", "password": "your-password", "enabled": true }, "webdav2": { "url": "https://second-webdav-server.com/dav", "username": "username2", "password": "password2", "enabled": true } } ``` ### Web应用 (Web Application) `web/app.py` - Flask Web应用 **功能特性:** - **RESTful API**: 完整的REST API接口,支持所有系统功能 - **实时更新**: 基于AJAX的实时状态更新 - **响应式设计**: 自适应桌面和移动设备 - **用户认证**: 基于Session的安全认证系统 - **多语言**: 完整的国际化支持(中文/英文) - **设备检测**: 自动检测设备类型,提供优化界面 - **文件上传**: 支持播放列表文件上传和导入 **API端点示例:** ```bash # VLC控制 POST /api/vlc/play # 开始播放 POST /api/vlc/pause # 暂停播放 POST /api/vlc/volume # 设置音量 GET /api/status # 获取系统状态 # 播放列表管理 GET /api/playlists # 获取所有播放列表 POST /api/playlists # 创建新播放列表 PUT /api/playlists/ # 更新播放列表 DELETE /api/playlists/ # 删除播放列表 # 调度管理 GET /api/schedules # 获取所有调度 POST /api/schedules # 创建新调度 POST /api/scheduler/start # 启动调度器 # 文件浏览 GET /api/files/local # 浏览本地文件 GET /api/files/webdav # 浏览WebDAV文件 GET /api/files/webdav2 # 浏览WebDAV2文件 ``` ## 🔧 配置说明 (Configuration) ### 系统配置 (config/config.json) ```json { "system": { "vlc_path": "", # VLC安装路径(可选,自动检测) "web_port": 5000, # Web服务端口 "auto_start": true, # 启动时自动开始调度 "log_level": "INFO", # 日志级别: DEBUG/INFO/WARNING/ERROR "data_dir": "data" # 数据存储目录 }, "webdav": { "url": "https://your-webdav-server.com/webdav", "username": "your-username", "password": "your-password", "enabled": true # 是否启用WebDAV }, "webdav2": { "url": "https://second-server.com/dav", "username": "username2", "password": "password2", "enabled": true # 是否启用第二个WebDAV服务器 } } ``` ### 播放列表配置 (config/playlists.json) ```json { "Morning English": { "name": "Morning English", "items": [ { "name": "English Song 1", "path": "/music/english/song1.mp3", "is_webdav": true, "webdav_server": 1, # 使用第一个WebDAV服务器 "enabled": true }, { "name": "Local Song", "path": "C:/Music/local_song.mp3", "is_webdav": false, "enabled": true }, { "name": "WebDAV2 Song", "path": "/audio/song2.mp3", "is_webdav": true, "webdav_server": 2, # 使用第二个WebDAV服务器 "enabled": true } ], "shuffle": false, # 是否随机播放 "repeat": true, # 是否重复播放 "volume": 70 # 默认音量 } } ``` ### 调度配置 (config/schedules.json) ```json [ { "name": "Morning Routine", "start_time": "07:00", # 开始时间 (HH:MM格式) "end_time": "08:00", # 结束时间 (HH:MM格式) "playlist_name": "Morning English", "days_of_week": [0, 1, 2, 3, 4], # 星期几 (0=周一, 6=周日) "enabled": true, # 是否启用此调度 "volume": 60 # 覆盖播放列表的音量设置 }, { "name": "Evening Stories", "start_time": "19:00", "end_time": "20:00", "playlist_name": "Bedtime Stories", "days_of_week": [0, 1, 2, 3, 4, 5, 6], # 每天 "enabled": true, "volume": 40 # 晚上音量较小 } ] ``` ## 💻 使用指南 (Usage Guide) ### Web界面操作 (Web Interface) #### 1. 登录系统 - 访问 http://localhost:5000 - 输入用户名: `admin` - 输入密码: `qwe123` - 点击登录 #### 2. 主界面功能 **播放控制面板:** - ▶️ 播放/暂停按钮 - ⏹️ 停止按钮 - ⏮️ 上一首 / ⏭️ 下一首 - 🔊 音量滑块 (0-100) - 🔁 重复模式切换 - 📊 播放进度条 **系统状态显示:** - VLC播放状态 - 当前播放媒体信息 - 调度器运行状态 - WebDAV连接状态 #### 3. 播放列表管理 **创建播放列表:** 1. 点击"播放列表"标签 2. 点击"添加播放列表" 3. 输入播放列表名称 4. 添加媒体项目: - 本地文件: 输入完整文件路径 - WebDAV文件: 勾选WebDAV选项,选择服务器,输入服务器路径 5. 设置播放选项(随机、重复、音量) 6. 保存播放列表 **编辑播放列表:** - 点击播放列表名称进行编辑 - 可以添加、删除、重新排序媒体项目 - 可以启用/禁用特定项目 - 支持批量操作 #### 4. 调度任务管理 **创建调度任务:** 1. 点击"调度"标签 2. 点击"添加调度" 3. 填写调度信息: - 任务名称 - 开始时间 (24小时格式) - 结束时间 - 选择播放列表 - 选择运行日期 (周一到周日) - 设置音量 (可选) 4. 启用调度并保存 **管理调度任务:** - 启动/停止调度器 - 暂停/恢复调度器 - 手动触发特定调度 - 查看调度历史 #### 5. 文件浏览器 **本地文件浏览:** - 浏览本地文件系统 - 自动识别媒体文件 - 双击文件直接播放 - 选择文件添加到播放列表 **WebDAV文件浏览:** - 浏览WebDAV服务器文件 - 支持中文文件名 - 递归目录浏览 - 文件搜索功能 #### 6. 系统设置 **WebDAV配置:** - 设置WebDAV服务器URL - 配置用户名和密码 - 测试连接状态 - 启用/禁用WebDAV **系统设置:** - VLC路径配置 - Web端口设置 - 自动启动选项 - 日志级别设置 ### 命令行操作 (Command Line Interface) #### 基本命令 ```bash # 查看帮助 python main.py --help # 查看系统状态 python main.py status # 安装依赖 python main.py install # 创建示例配置 python main.py sample-config ``` #### 启动选项 ```bash # 基本启动 python main.py start # 指定端口 python main.py start --port 8080 # 指定主机地址 (允许网络访问) python main.py start --host 0.0.0.0 # 同时指定主机和端口 python main.py start --host 0.0.0.0 --port 8080 # 调试模式 python main.py start --debug # 设置日志级别 python main.py start --log-level DEBUG # 指定配置目录 python main.py start --config-dir /path/to/config # 指定数据目录 python main.py start --data-dir /path/to/data ``` #### Windows批处理脚本 ```batch # 使用提供的批处理文件 start_vlc_automation.bat # 或使用PowerShell脚本 start_vlc_automation.ps1 ``` ### 移动端使用 (Mobile Usage) #### 自动检测 - 系统自动检测移动设备 - 自动跳转到移动优化界面 - 触控友好的界面设计 #### 手动访问 - 桌面版: http://your-ip:5000/desktop - 移动版: http://your-ip:5000/mobile #### 移动端功能 - 简化的播放控制 - 大按钮设计 - 滑动手势支持 - 快速播放列表切换 ## 🛠️ 高级配置 (Advanced Configuration) ### 自定义VLC参数 在 `core/vlc_controller.py` 中修改VLC启动参数: ```python vlc_args = [ '--intf', 'dummy', # 无界面模式 '--no-video-title-show', # 不显示视频标题 '--quiet', # 减少控制台输出 '--no-osd', # 无屏幕显示 '--volume', '70', # 默认音量 '--audio-filter', 'normvol', # 音量标准化 ] ``` ### 网络访问配置 **防火墙设置:** - Windows: 允许Python通过防火墙 - macOS: 系统偏好设置 > 安全性与隐私 > 防火墙 - Linux: 配置iptables或ufw **路由器设置:** - 端口转发: 将外部端口转发到内部5000端口 - DMZ设置: 将运行系统的设备设为DMZ主机 ### 开机自启动 **Windows:** 1. 创建批处理文件 2. 添加到启动文件夹: `Win+R` → `shell:startup` 3. 或使用任务计划程序 **macOS:** 1. 系统偏好设置 > 用户与群组 > 登录项 2. 添加启动脚本 **Linux:** 1. 创建systemd服务 2. 或添加到 `/etc/rc.local` ### 性能优化 **内存优化:** - 调整VLC缓存大小 - 限制WebDAV缓存数量 - 定期清理日志文件 **网络优化:** - 使用有线网络连接 - 优化WebDAV服务器配置 - 启用HTTP/2支持 ## 🔍 故障排除 (Troubleshooting) ### 常见问题 #### VLC相关问题 **"VLC not found" 错误:** ```bash # 检查VLC是否安装 vlc --version # Windows: 添加VLC到PATH环境变量 # 或在config.json中指定vlc_path # macOS: 确保VLC在/Applications/目录 ls /Applications/VLC.app ``` **播放失败:** - 检查文件格式是否支持 - 验证文件路径是否正确 - 查看VLC日志获取详细错误信息 #### WebDAV连接问题 **连接失败:** ```bash # 测试WebDAV连接 curl -u username:password https://your-webdav-server.com/webdav/ # 检查URL格式 # 正确: https://server.com/webdav/ # 错误: https://server.com/webdav (缺少尾部斜杠) ``` **中文文件名问题:** - 确保WebDAV服务器支持UTF-8编码 - 检查服务器配置是否正确处理URL编码 #### 网络访问问题 **端口被占用:** ```bash # 检查端口占用 (Windows) netstat -ano | findstr :5000 # 检查端口占用 (macOS/Linux) lsof -i :5000 # 使用其他端口 python main.py start --port 8080 ``` **无法从其他设备访问:** - 检查防火墙设置 - 确保使用 `--host 0.0.0.0` 启动 - 验证网络连接 #### 调度问题 **调度不执行:** - 检查调度器是否启动 - 验证时间格式是否正确 (HH:MM) - 确认days_of_week设置正确 (0=周一) - 查看调度历史和日志 **时间不准确:** - 检查系统时间是否正确 - 考虑时区设置影响 ### 日志分析 **日志文件位置:** - 主日志: `vlc_automation.log` - VLC日志: 通过VLC控制器输出 **日志级别:** - DEBUG: 详细调试信息 - INFO: 一般信息 - WARNING: 警告信息 - ERROR: 错误信息 **查看实时日志:** ```bash # Windows type vlc_automation.log # macOS/Linux tail -f vlc_automation.log ``` ## 🧪 开发指南 (Development Guide) ### 项目结构说明 ```python # 核心模块依赖关系 main.py ├── config.settings.ConfigManager # 配置管理 ├── web.app.VLCWebApp # Web应用 │ ├── core.vlc_controller.VLCController │ ├── core.webdav_client.WebDAVClient │ └── core.scheduler.AutomationScheduler └── 日志系统 ``` ### 扩展功能 #### 添加新的VLC控制功能 ```python # 在 core/vlc_controller.py 中添加 def set_playback_speed(self, speed: float): """设置播放速度 (0.5-2.0)""" if self.player: self.player.set_rate(speed) return True return False def get_audio_tracks(self): """获取音频轨道列表""" if self.player: return self.player.audio_get_track_description() return [] ``` #### 添加新的API端点 ```python # 在 web/app.py 中添加 @self.app.route('/api/vlc/speed', methods=['POST']) def set_playback_speed(): data = request.get_json() speed = data.get('speed', 1.0) success = self.vlc_controller.set_playback_speed(speed) return jsonify({'success': success, 'speed': speed}) ``` #### 添加新的配置选项 ```python # 在 config/settings.py 中添加 @dataclass class SystemConfig: vlc_path: str = "" web_port: int = 5000 auto_start: bool = True log_level: str = "INFO" data_dir: str = "data" # 新增配置项 max_volume: int = 100 default_speed: float = 1.0 enable_notifications: bool = True ``` ### 测试 #### 运行测试 ```bash # 运行所有测试 python -m pytest tests/ # 运行特定测试 python -m pytest tests/test_config.py # 运行测试并显示覆盖率 python -m pytest --cov=core tests/ ``` #### 手动测试 ```bash # 启动调试模式 python main.py start --debug --log-level DEBUG # 测试API端点 curl -X GET http://localhost:5000/api/status curl -X POST http://localhost:5000/api/vlc/play ``` ### 贡献指南 #### 代码规范 - 使用Python 3.7+语法 - 遵循PEP 8代码风格 - 添加类型注解 - 编写文档字符串 - 添加适当的错误处理 #### 提交规范 ```bash # 功能添加 git commit -m "feat: 添加播放速度控制功能" # 错误修复 git commit -m "fix: 修复WebDAV中文文件名问题" # 文档更新 git commit -m "docs: 更新API文档" ``` ## 📚 API文档 (API Documentation) ### 认证 所有API请求需要先登录获取Session认证。 ### 系统状态 ```http GET /api/status ``` **响应:** ```json { "vlc": { "state": "playing", "volume": 70, "media_info": {...}, "current_playlist": "Morning Music", "repeat": false }, "scheduler": { "state": "running", "active_schedules": 3, "current_session": {...} }, "webdav": { "connected": true, "url": "https://server.com/webdav" }, "system": { "running": true, "timestamp": "2024-01-01T12:00:00" } } ``` ### VLC控制 ```http POST /api/vlc/play POST /api/vlc/pause POST /api/vlc/stop POST /api/vlc/next POST /api/vlc/previous POST /api/vlc/volume Content-Type: application/json { "volume": 70 } POST /api/vlc/seek Content-Type: application/json { "percentage": 50.0 } ``` ### 播放列表管理 ```http GET /api/playlists POST /api/playlists PUT /api/playlists/{name} DELETE /api/playlists/{name} POST /api/playlists/{name}/play ``` ### 调度管理 ```http GET /api/schedules POST /api/schedules PUT /api/schedules/{name} DELETE /api/schedules/{name} POST /api/scheduler/start POST /api/scheduler/stop POST /api/scheduler/pause POST /api/scheduler/resume ``` ## 🎯 使用场景 (Use Cases) ### 儿童教育 **场景描述:** 为儿童创建定时播放的教育内容 **配置示例:** ```json { "playlists": { "英语启蒙": { "items": [ {"name": "ABC Song", "path": "/education/abc.mp3"}, {"name": "Numbers Song", "path": "/education/numbers.mp3"} ] }, "中文故事": { "items": [ {"name": "小红帽", "path": "/stories/xiaohongmao.mp3"}, {"name": "三只小猪", "path": "/stories/sanzhi.mp3"} ] } }, "schedules": [ { "name": "早晨英语时间", "start_time": "07:30", "end_time": "08:00", "playlist_name": "英语启蒙", "days_of_week": [0,1,2,3,4], "volume": 60 }, { "name": "睡前故事时间", "start_time": "20:00", "end_time": "20:30", "playlist_name": "中文故事", "days_of_week": [0,1,2,3,4,5,6], "volume": 40 } ] } ``` ### 商业场所 **场景描述:** 商店、餐厅的背景音乐自动播放 **特点:** - 不同时段播放不同风格音乐 - 音量随时段自动调节 - 支持远程管理和控制 ### 家庭娱乐 **场景描述:** 家庭聚会、运动时间的音乐播放 **特点:** - 周末特殊播放列表 - 节假日主题音乐 - 家庭成员远程控制 ### 办公环境 **场景描述:** 办公室背景音乐和专注音乐 **特点:** - 工作时间轻音乐 - 休息时间流行音乐 - 会议时间自动静音 ## 📖 常见问题 (FAQ) ### Q: 支持哪些音频和视频格式? A: 支持所有VLC媒体播放器支持的格式,包括但不限于: - 音频: MP3, WAV, FLAC, AAC, OGG, WMA, M4A - 视频: MP4, AVI, MKV, MOV, WMV, FLV, WebM ### Q: 可以同时连接多个WebDAV服务器吗? A: 是的,系统支持同时连接两个不同的WebDAV服务器,可以在播放列表中混合使用两个服务器的文件。 ### Q: 如何设置开机自动启动? A: 可以通过以下方式设置: - Windows: 将启动脚本添加到启动文件夹或任务计划程序 - macOS: 在系统偏好设置的登录项中添加 - Linux: 创建systemd服务或添加到启动脚本 ### Q: 支持远程控制吗? A: 是的,通过Web界面可以从任何设备远程控制,只需要在同一网络内访问系统的IP地址和端口。 ### Q: 如何备份配置? A: 备份整个 `config/` 目录即可,包含所有播放列表、调度和系统配置。 ### Q: 可以设置音量渐变吗? A: 当前版本不支持音量渐变,但可以通过扩展VLC控制器来实现此功能。 ### Q: 支持播放网络电台吗? A: 是的,可以在播放列表中添加网络电台的URL地址,VLC会自动处理网络流媒体。 ## 📄 许可证 (License) 本项目采用开源许可证,允许自由使用、修改和分发。 ### 使用条款 - ✅ 商业使用 - ✅ 修改代码 - ✅ 分发软件 - ✅ 私人使用 - ❌ 责任免除 - ❌ 保证免除 ### 第三方依赖 本项目使用了以下开源库: - Flask: BSD-3-Clause License - python-vlc: LGPL-2.1 License - webdavclient3: MIT License - schedule: MIT License ## 🤝 支持与贡献 (Support & Contributing) ### 获取帮助 1. **查看文档**: 首先查看本README和SETUP.md 2. **检查日志**: 查看 `vlc_automation.log` 获取错误信息 3. **常见问题**: 参考上方FAQ部分 4. **社区支持**: 在项目Issues中提问 ### 贡献代码 欢迎提交Pull Request来改进项目: 1. Fork项目仓库 2. 创建功能分支: `git checkout -b feature/new-feature` 3. 提交更改: `git commit -m 'Add new feature'` 4. 推送分支: `git push origin feature/new-feature` 5. 创建Pull Request ### 报告问题 发现Bug或有功能建议时,请: 1. 检查是否已有相似问题 2. 提供详细的问题描述 3. 包含系统环境信息 4. 附上相关日志文件 ### 项目维护 本项目持续维护和更新,欢迎: - 功能建议和改进意见 - Bug报告和修复 - 文档完善和翻译 - 测试用例补充 --- **感谢使用VLC自动播放系统!** 🎵 如果这个项目对您有帮助,请考虑给项目点个⭐️星标支持!