用 PotPlayer 或 VLC 接管 Miru 的视频播放

为什么用外部播放器

Mirv 内置的视频播放器能覆盖大多数场景，但在以下情况下你可能想要用更专业的外部播放器：

• 支持更高倍速：PotPlayer、VLC 都能开到 3x、4x 甚至 8x 倍速；
• 更丰富的字幕功能：双字幕、ASS 特效字幕、字幕时间轴调整等；
• 更精细的画面调整：亮度、对比度、饱和度、锐化等；
• HLS / MP4 播放兼容性问题：少数视频源在 Mirv 内置播放器里播不出来，外部播放器可能能播；
• 你本来就习惯用 PotPlayer / VLC。

Mirv 怎么传视频给外部播放器

Mirv 内置的扩展在调用 watch() 方法后拿到的是一个视频 URL（{ type: "hls" | "mp4", url }）。当你点击"外部播放"按钮时，Mirv 会把这个 URL 传给系统注册的播放器。

开启步骤

1. 确保你的电脑上已经安装了 PotPlayer 或 VLC；
2. 打开 Mirv 设置，找到外部播放器相关选项；
3. 选择你想要调用的外部播放器（PotPlayer / VLC），可能需要指定安装路径；
4. 保存后，在视频播放界面或详情页会出现"用外部播放器打开 / Play with external"按钮；
5. 点击按钮，Mirv 会把当前条目的视频 URL 传给外部播放器打开。

HLS 和外部播放器

PotPlayer 和 VLC 都原生支持 HLS（.m3u8 格式），所以主流视频源（绝大多数用 HLS）直接就能打开。不需要额外装插件。

MP4 格式更简单，直接双击就能播。

注意事项

• 进度不会自动同步：Mirv 把 URL 传给外部播放器后就不管了，你在 PotPlayer 里看到哪、看了多久，Mirv 不知道，也不会写回 progress.json。想同步进度只能手动回到 Mirv 里查看；
• 只有视频类型能用：漫画和小说没有"外部阅读器"的概念，这个功能只对 bangumi 扩展有效；
• URL 时效性：部分视频源的 URL 有时效性（比如加了 token、几小时过期）。如果外部播放器打开时报"URL 已过期"，回到 Mirv 里重新点"外部播放"刷新一下 URL 即可。