外部 mpv 播放器
把播放交给系统里的 mpv.exe，并保留进度回传等能力；只支持 mpv，不支持 PotPlayer / VLC
小幻影视允许把播放任务交给系统里独立安装的 mpv 播放器，让你复用自己精心配置过的 mpv 整合包（脚本、字幕、滤镜、硬件解码方案等），同时仍然保留小幻影视提供的服务端能力——续播位置、播放进度上报、播放列表续播等都不会因此丢失。
只支持 mpv，不支持 PotPlayer / VLC / MPC-HC 等
这是当前架构的硬性约束，不是策略选择。
小幻影视通过 mpv 的 JSON IPC 协议（--input-ipc-server 命名管道）实时读取播放位置、暂停状态、文件切换事件，并把这些事件回推到 Emby / Jellyfin / Plex / 115 等连接器的进度上报通道。只有 mpv 提供这种结构化、可程序化对接的 IPC——PotPlayer、VLC、MPC-HC 等播放器没有等价能力，无法实现进度回传、播放列表跨集续播、外部字幕匹配等小幻影视所依赖的功能，因此不在支持名单内，未来也不会加入。
如果你只是想"打开播放器看一下"，操作系统的"打开方式"右键菜单已经能完成这件事；外部 mpv 集成的目的不是"换个播放器壳"，而是"借 mpv 的解码能力 + 小幻影视的服务集成"。
它做了什么
启用外部 mpv 后，每次发起播放时小幻影视会：
- 启动一个独立的
mpv.exe进程（带--idle --force-window=immediate，立即出窗口）。 - 通过命令行把 user-agent / HTTP headers / 起播位置传给 mpv；如果是剧集，则生成一份临时 m3u8 播放列表传给 mpv，从而支持自动播下一集。
- 与 mpv 建立 IPC 管道连接，每秒轮询一次播放位置，每 10 秒回推一次进度到对应连接器的服务端，让你切回小幻影视主界面或在其它客户端打开同一条目时能看到正确的进度。
- 进程退出 / 文件切换 / 用户关闭窗口时，触发一次最终的播放停止上报，并清理临时文件。
设置位置
设置 → 播放设置 → 外部 MPV 播放器。展开后包含：
| 项 | 含义 |
|---|---|
| 默认使用外部播放器 | 顶层开关。开启后所有 PDP / 文件视图的播放按钮默认调用外部 mpv；下拉菜单仍可手动切回内置播放器。 |
| MPV 路径 | 指定 mpv.exe 的绝对路径。留空时会按 mpv 名字在系统 PATH 中查找——如果你用的整合包没有把 mpv 注册到 PATH，请手动选一下文件。 |
| 自动传递系统代理 | 开启后，启动 mpv 时自动追加 --http-proxy=...，把当前系统代理透传给 mpv（用于网盘 / 公网媒体）。 |
| IPC 服务器名称 | 自定义命名管道名称。留空即可，应用会按 mpvsocket{自增序号} 自动生成；只有当你需要从外部脚本接管这条 IPC 时才需要手填。 |
| 播放列表最大条目数 | 生成 m3u8 播放列表时，最多放多少集 / 多少个文件，避免一次性塞入整季导致 mpv 启动变慢。 |
未找到 mpv 时的提示
如果保存的路径无效、或 PATH 中找不到 mpv，发起播放时会弹出"未找到 mpv 可执行文件，请在设置中指定路径"的提示。
在播放按钮上手动切换
即使关闭了「默认使用外部播放器」，你也可以在 PDP 的播放按钮右侧下拉菜单里临时选择「使用外部播放器 (MPV)」走外部 mpv 一次；反之，开启了默认外部时也可以临时切回内置播放器。
文件视图的右键菜单同样提供"使用另一个播放器播放"——按当前默认的相反方向播放当前条目。
推荐的 mpv 整合包
如果你还没有自己常用的 mpv 配置，可以直接把以下整合包解压到任意位置，然后把里面的 mpv.exe 路径填入小幻影视的「MPV 路径」即可。两者都长期维护、配置激进、兼容性较好：
- dyphire/mpv-config
- hooke007/mpv_PlayKit（原 mpv-lazy）
它们各自带了一套 mpv.conf、input.conf、脚本与 shader，挑哪一个完全看个人喜好。安装后建议在小幻影视里测试一次进度回传是否正常（播放几秒后退出，回到 PDP 看进度有没有更新）——这是验证 IPC 通道工作正常最直接的方法。
整合包里的快捷键 / 脚本由 mpv 自己处理
启动外部 mpv 后，小幻影视主窗口不再接管播放控制——音量、字幕、跳过片头等操作请使用整合包自带的快捷键或 OSC。小幻影视只负责"启动 mpv + 收进度 + 上报服务端"，不会代理 mpv 的输入。