企业官网建设流程全解析

NuvioTV外接播放器实战：MX Player、mpv与芝度硬件支持的完整指南

【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV

NuvioTV 是一款免费的开源 Android TV 媒体应用，内置"外接播放器"功能：你可以一键把影片交给 MX Player、mpv（含 mpvNova）等第三方播放器播放，还能自动保存进度、续播、转发字幕，并为芝度（Zidoo）播放器提供专属的播放跟踪支持。本文用通俗的步骤，带你完整配置这套"外接播放器 + 硬件加速"方案。

为什么要用外接播放器？

NuvioTV 自带的内部播放器基于 Media3（ExoPlayer），兼容性和体验都不错。但有些设备或片源场景下，第三方播放器的解码能力更强——比如硬解 4K、HDR、特殊封装格式时更稳。NuvioTV 的设计思路是：把"找片源、管理影库、记进度"交给 NuvioTV，把"解码播放"交给你最熟悉的播放器，两边各干最擅长的事。

而且它不是简单地"打开就完事"，而是会持续跟踪：

• ✅进度回传：外部播放器退出时把播放位置带回来，NuvioTV 自动保存续播进度
• ✅自动标为已看：播放到 90% 以上（或播放器明确报告"播放完成"）自动标记已看
• ✅自动续播下一集：剧集播放结束后自动拉起下一集
• ✅字幕转发：把已下载的字幕直接传给外部播放器
• ✅Trakt 刷剧：外部播放同样触发 Trakt scrobble

一键设置：在 NuvioTV 中选择外接播放器

设置路径非常简单，全程无需代码：

1. 打开 NuvioTV，进入设置 → 播放设置
2. 找到"默认播放器"选项，这里有三档可选：
   • 内部播放器：用 NuvioTV 自带的播放器
   • 外部播放器：总是交给第三方播放器
   • 每次询问：播放时弹框让你选择
3. 选择"外部播放器"后，下方会出现两个专属开关：
   • 外部播放器转发字幕：把 NuvioTV 下载好的字幕传给外部播放器
   • 发送跳过片段：把片头/片尾跳过片段一并转发（目前 mpvNova 会读取使用）

这些设置项对应源码中的 PlaybackPlayerSettings.kt，数据则保存在 PlayerSettingsDataStore.kt 中，并且会跟随配置（Profile）一起跨设备同步。

MX Player 与 mpv：进度、续播和字幕如何打通

不同播放器返回的数据格式五花八门，NuvioTV 的 ExternalPlayerResultContract.kt 里写明了它在真机上逐个验证过的"契约"：

具体实现上，启动外部播放器时（见 ExternalPlayerLauncher.kt）：

• 🎬续播：把上次保存的播放位置同时以多种字段格式写入 Intent（position、startfrom、extra_position），确保不同播放器都能读到
• 🌐网络流请求头：Debrid 等片源需要的 HTTP 头会原样传给外部播放器
• 💬字幕：同时兼容 MX Player/mpv 的subs、Just Player 的subtitle_uri、VLC 的subtitles_location等约定，并自动授予字幕文件读取权限

而播放结束后的"善后工作"由 ExternalPlaybackTracker.kt 统一处理：保存进度、标记已看、触发自动续播、发送 Trakt 刷剧。它还启动了一个前台保活服务（ExternalPlaybackKeepAliveService.kt），防止播放期间系统杀掉 NuvioTV 导致进度丢失——即便进程真被杀了，恢复元数据也已落盘，回来照样能接上。

小提示：如果你用的是 mpvNova 分支，建议打开"发送跳过片段"开关，它可以自动跳过片头片尾；其他播放器会忽略这个数据，不受影响。

芝度（Zidoo）硬件支持：内置播放器也能跟踪进度

芝度是知名的安卓播放器品牌，它的内置播放器（VS10 引擎）有一个特殊之处：不会通过标准方式把播放结果返回给其他 App。NuvioTV 为它写了一个专属的 REST API 轮询器 ZidooPlayerMonitor.kt：

1. 自动识别设备：通过厂商/型号信息判断是否为芝度设备（包括 Z9X 8K 这类特殊型号）
2. 轮询播放状态：每 2 秒请求一次芝度内置的本地 API（端口 9529），读取当前播放位置和总时长
3. 自动续播：检测到播放开始后，自动把芝度播放器跳转到上次保存的位置
4. 优雅收尾：连续两次探测到"已停止"后，把最终位置交还给 NuvioTV 保存进度

这意味着在芝度设备上用内置播放器看 NuvioTV 的片源，进度、已看状态、Trakt 刷剧依然全部生效。如果你同时在芝度上装了第三方播放器（如 Vimu、Just Player），NuvioTV 会优先走标准的结果回传通道，REST 轮询只作为兜底。

常见问题

Q1：选择外部播放器后，系统弹出一堆播放器让我选？正常现象。NuvioTV 通过标准的"打开视频"方式调用外部播放器，首次使用由你指定默认 App。建议安装一个主力播放器（如 MX Player）并在选择框中选"始终"。

Q2：为什么 VLC 的进度百分比有时不准？VLC 对网络流只返回位置、不返回时长，NuvioTV 会用片库里的片长数据自动补齐（见 ExternalPlaybackTracker.kt 的时长回填逻辑），所以进度仍然能正常保存和续播。

Q3：自动续播下一集会被"卡"住吗？不会。整个外部播放链路（进度、续播、下一集解析）都持久化在磁盘上，即使 NuvioTV 进程被外部播放器连带杀掉，回来后依然能恢复会话并继续自动连播。

写在最后

NuvioTV 的外接播放器方案值得称道的地方在于：它没有假设"所有播放器都守规矩"，而是为 MX Player、mpv、mpvNova、VLC、Just Player、Vimu 逐一验证并适配了各自的返回格式，甚至为芝度硬件单独实现了 API 轮询方案。你只需要在设置里选好播放器，剩下的进度管理、字幕转发、自动续播全部自动完成。

想深入了解实现细节，可以从这几个入口读起：

• 启动外部播放器：ExternalPlayerLauncher.kt
• 结果解析与兼容契约：ExternalPlayerResultContract.kt
• 进度跟踪与自动续播：ExternalPlaybackTracker.kt
• 芝度设备轮询：ZidooPlayerMonitor.kt
• 播放设置界面：PlaybackPlayerSettings.kt

【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV