VLC 与 MPV 播放后端
如何选择
| 后端 | 适合场景 | 注意事项 |
|---|---|---|
| MPV | 默认选择、常见网络视频、YouTube/yt-dlp 集成 | YouTube 解析依赖可用的 yt-dlp；受限内容可能需要 Cookie |
| VLC | 已部署 VLC 运行库、兼容特定直播或流媒体 | Android 只列出 VLC arm64-v8a 组合 |
切换命令：
/videoplayer backend <vlc|mpv>
后端切换用于新的播放任务。切换前先停止或完成现有任务，并重新打开诊断确认加载状态。
服务端可配置平台组合
native.os 和 native.arch 为空时按服务端 JVM 自动检测。手工覆盖只应在自动检测错误或运行环境特殊时使用。
| 后端 | 操作系统 | 架构 |
|---|---|---|
| MPV | Windows | x86、x64、arm64 |
| MPV | macOS | x64、arm64 |
| MPV | Linux | x86、x64、arm32、arm64 |
| VLC | Windows | x86、x64、arm64 |
| VLC | macOS | x64、arm64 |
| VLC | Linux | x64、arm64 |
| VLC | Android | arm64-v8a |
原生运行库下载
- 客户端优先使用
/videoplayer boot向导。 - 服务端使用
native.backend、native.os、native.arch和native.download-proxy。 - 代理 URL 可能包含凭据；不要把带口令的配置上传到公开仓库或完整粘贴到日志。
- 自动下载失败时，先检查 DNS、TLS、代理和目标目录写权限，再考虑手工部署。
yt-dlp
MPV 的 YouTube 支持按顺序寻找：
native.mpv-ytdl-path指定的可执行文件。- VideoPlayer 管理的版本。
- 系统
PATH中的yt-dlp。 - 允许时自动安装的版本。
路径应指向可执行文件而不是目录。更新后重新运行诊断，确认进程可以启动。