如何同时播放多个视频？GridPlayer 完整使用指南：从安装到高级技巧 🎥

GridPlayer 是一款基于 VLC 的开源媒体播放器，专为同时播放多个视频设计。无论是监控多画面、对比视频素材还是多任务观影，它都能让你告别切换窗口的烦恼，轻松实现视频并排播放。支持 VLC 全格式兼容、播放列表保存、硬件加速等实用功能，完全免费且开源！

📋 为什么选择 GridPlayer？核心功能亮点

✅ 突破数量限制的视频网格

告别单一视频播放的局限！GridPlayer 允许你同时加载任意数量的视频，唯一限制仅为硬件性能。无论是 2x2 四格监控画面，还是 4x4 多素材对比，都能流畅驾驭。

✅ 全格式兼容与流媒体支持

• 本地文件：支持 VLC 兼容的所有格式（MP4、MKV、AVI 等）
• 网络流媒体：通过集成的 utils/url_resolve/ 模块，无缝解析 YouTube、Twitch 等平台链接（依赖 Streamlink 和 yt-dlp）
• 播放记忆：自动保存每个视频的播放位置、音量、循环模式和宽高比设置

✅ 轻量高效的性能优化

• 硬件加速：通过 vlc_player/ 模块实现 GPU 解码，降低 CPU 占用
• 智能资源管理：multiprocess/process_manager.py 优化多进程调度，避免卡顿

🚀 零基础安装指南：3 分钟上手

🔧 准备工作

• 系统要求：Windows 10+ / macOS 11+ / Linux (Ubuntu 20.04+)
• 依赖环境：Python 3.8+、VLC 媒体播放器
• 工具准备：Git（用于克隆代码）

🔗 一键安装步骤

1. 获取源码

git clone https://gitcode.com/gh_mirrors/gr/gridplayer
cd gridplayer

2. 安装依赖管理工具

# Linux/macOS
curl -sSL https://install.python-poetry.org | python3 -

# Windows (PowerShell)
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

3. 安装项目依赖

poetry install --no-dev

4. 启动应用

poetry run gridplayer

💡 提示：如果启动失败，检查 main/init_app.py 中的初始化配置，或查看 utils/log_config.py 生成的日志文件定位问题。

⚙️ 基础配置与界面介绍

🎛️ 首次启动设置

首次运行会打开设置向导，推荐配置：

• 视频网格：默认 2x2 布局（可在播放中通过快捷键 Ctrl+Up/Ctrl+Down 调整）
• 硬件加速：默认启用（路径：vlc_player/video_driver_base.py）
• 语言选择：支持多语言界面（配置文件：params/languages.py）

🖥️ 核心界面功能

• 视频区块：每个区块独立控制播放/暂停、音量和全屏
• 顶部工具栏：添加视频、保存播放列表、网格布局切换
• 右键菜单：单个视频的高级设置（循环模式、宽高比、解码方式）

🎯 实用技巧：解锁高级玩法

📁 管理播放列表

1. 添加视频：点击工具栏「+」或拖放文件到窗口
2. 保存列表：文件 > 保存播放列表（默认保存为 .gpl 格式）
3. 加载列表：文件 > 打开播放列表（自动恢复上次播放状态）

实现代码：models/playlist.py

⌨️ 效率快捷键

• Ctrl+N：新建视频区块
• Ctrl+W：关闭选中区块
• 空格：全局暂停/播放
• F11：全屏模式（支持单个区块或全局全屏）

🔍 故障排除：常见问题解决

🖥️ 黑屏或卡顿？

1. 尝试切换解码模式：右键视频 > 解码方式 > 软件解码（路径：widgets/video_frame_vlc_sw.py）
2. 减少同时播放的视频数量
3. 检查 VLC 插件完整性（pyinstaller/vlc_plugins_wl.txt）

🌐 流媒体无法播放？

确保已安装依赖：

pip install streamlink yt-dlp

原理：utils/url_resolve/resolver_yt_dlp.py 模块调用第三方工具解析流媒体地址。

🛠️ 自定义与扩展

🎨 界面美化

修改主题配色（需基础 Python 知识）：

1. 编辑 widgets/video_overlay.py 调整控制栏样式
2. 修改 params/static.py 中的颜色常量

🔌 功能扩展

GridPlayer 采用模块化设计，可通过 player/managers/ 添加自定义功能，例如：

• 视频滤镜
• 定时截图
• 音频同步调整

📚 资源与支持

官方文档

完整使用手册：docs/official.md（项目内文档路径）

源码结构

• 核心播放：player/manager.py
• 多进程管理：multiprocess/
• UI 组件：widgets/

---

GridPlayer 让多视频播放变得简单高效，无论是专业工作还是日常娱乐都能胜任。立即下载体验，解锁视频多任务处理新方式！如有问题，欢迎参与项目贡献或提交 Issue。