这是本文档旧的修订版！
WebUI 调用本地视频播放器
本页面详细介绍 WebUI 调用本地视频播放器的功能说明、使用方法及注意事项，为用户提供完整的操作指引。
1. 功能概述
WebUI 支持通过自定义协议（如 vlc:、potplayer:'' ）唤起用户设备上已安装的本地视频播放器（如 VLC、PotPlayer），直接播放下载任务中指定视频文件的HTTP链接。该功能可规避浏览器播放组件的格式限制，充分利用本地播放器的高级功能。
=== 2. 核心优势 ===
- 格式兼容性强：支持播放浏览器原生不支持的特殊格式视频（如 MKV、FLV 高清格式）。
- 功能更丰富：可调用本地播放器的高级解码、多音轨切换、字幕调节、倍速播放等专属功能。
- 性能提升：本地播放器可调用硬件加速功能，提升大码率视频的播放流畅度。
=== 3. 前置条件 ===
以下条件需全部满足，否则无法正常唤起本地播放器
- 本地设备已安装支持的视频播放器（官方推荐：VLC 媒体播放器、PotPlayer）。
- 播放器已完成自定义协议注册（如 `vlc:` 协议需关联 VLC 播放器，注册方法参考 [附录：协议注册方法](https://www.doubao.cn)）。
- 浏览器未拦截自定义协议调用（首次使用时，浏览器可能弹出提示，需选择“允许”或“始终允许”）。
- 视频资源地址格式合法（如 HTTP/HTTPS 链接需可访问，本地路径需为绝对路径）。
## 5. 操作步骤
### 5.1 基础调用流程
1. 登录 WebUI 平台，进入视频资源列表页面。
2. 找到目标视频资源，点击资源卡片或操作栏中的 “用本地播放器打开” 按钮（图标通常为 🎬+💻）。
3. 系统自动检测本地已注册的播放器，通过对应协议唤起播放器。
4. 本地播放器启动后，将自动加载并播放目标视频资源。
### 5.2 自定义播放器选择（进阶操作）
若本地安装多个支持的播放器，可手动指定调用的播放器：
1. 在 WebUI 右上角点击 个人头像 → 设置 → 播放设置。
2. 在“本地播放器关联”模块，选择默认调用的播放器（如“优先使用 VLC 播放器”）。
3. 保存设置后，后续调用将优先使用指定的播放器。
## 6. 常见问题（FAQ）
|问题现象|解决方案|
|—|—|
|点击“用本地播放器打开”后无反应|1. 检查播放器是否已安装并完成协议注册；2. 检查浏览器是否拦截了协议调用（在浏览器设置的“弹出窗口和重定向”中允许本网站）；3. 重启播放器后重试。|
|唤起播放器后无法加载视频|1. 验证视频资源地址是否可访问（复制地址在浏览器中打开测试）；2. 检查本地播放器是否支持该视频格式；3. 若为局域网资源，确认设备已连接同一网络。|
|无法选择自定义播放器|1. 确认已安装多个支持的播放器；2. 进入 WebUI 播放设置，刷新“已检测播放器”列表；3. 若播放器未被检测到，手动注册协议（参考附录）。|
## 7. 附录：协议注册方法
### 7.1 VLC 播放器协议注册
参考官方批处理脚本，自动完成 `vlc:` 协议注册，详情见 [VLC 官方文档](https://wiki.videolan.org/Documentation:Play_with_VLC/#Custom_Protocol)。
### 7.2 PotPlayer 播放器协议注册
1. 打开 PotPlayer，点击“选项 → 关联 → 高级关联”；2. 在“自定义协议”中输入 `potplayer:`，点击“关联”；3. 重启浏览器后生效。
## 8. 联系支持
若遇到上述方法无法解决的问题，可通过以下方式联系技术支持：
- 官方客服：400-XXX-XXXX（工作日 9:00-18:00）
- 技术论坛：[WebUI 播放器问题专区](https://forum.example.com/webui-player)
- 反馈邮箱：support@example.com（请附上问题截图及设备信息）
> （注：文档部分内容可能由 AI 生成）
