企业官网建设流程全解析

如何在NuvioTV接入Debrid服务：Real-Debrid、Premiumize、Torbox三大教程让磁力秒播

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

NuvioTV 是一款免费开源的媒体中心应用，专为手机、桌面与 Android TV 打造。它最大的亮点之一，就是内置了 Debrid 服务接入能力：连接 Real-Debrid、Premiumize、Torbox 任意一家，即可把磁力链接转换为高速直链，实现秒播。本文将带你一步步完成三大 Debrid 服务的配置，并讲解即时播放（Instant）与云媒体库两项进阶功能。

一、什么是 Debrid 服务？为什么 NuvioTV 需要它？

简单说，Debrid 服务（云去磁化服务）能把磁力链接、BT 种子"转存"到云端高速服务器，并生成一个稳定的 HTTP 直链。没有它，播放磁力资源要先做种、等下载，慢则数小时；有了它，点一下就能边下边播，速度几乎跑满你的带宽。

NuvioTV 在设置中提供了一个专门的"Connected Services（连接服务）"页面，统一管理三类 Debrid 账号，并且支持：

• 🚀即时解析（Instant Resolve）：插件返回磁力链接后，客户端自动交给 Debrid 转成直链再播放
• 📺云媒体库（Cloud Library）：直接浏览、播放你 Debrid 账号里已转存的文件
• ⚡流媒体筛选：按分辨率、HDR、杜比视界、编码等条件自动挑选最佳流

这些能力集中在 app/src/main/java/com/nuvio/tv/core/debrid/ 目录下，其中 DebridProvider.kt 定义了三大服务商及其能力差异。

二、进入 Debrid 设置页：三大服务统一入口

打开 NuvioTV 后进入设置 → Connected Services（连接服务）。对应界面源码为 DebridSettingsScreen.kt。

页面上你会看到：

所有设置会按当前用户配置文件（Profile）独立保存，配置存储逻辑见 DebridSettingsDataStore.kt。

💡 注意：这些集成目前标注为实验性功能（experimental），后续可能调整或移除。

三、教程1：连接 Real-Debrid（API Key 方式）

Real-Debrid 是老牌 Debrid 服务，NuvioTV 采用API Key方式认证：

1. 登录 Real-Debrid 官网，进入Settings → API页面
2. 点击生成一个 API Key 并复制
3. 回到 NuvioTV 的 Connected Services 页面，在 Real-Debrid 一行粘贴密钥
4. 密钥保存后，Real-Debrid 即成为可用的解析服务（resolver）

解析流程由 RealDebridDirectDebridResolver.kt 完成：它把磁力提交给 RD 后轮询转存状态，成功即返回可播放直链。

四、教程2：连接 Torbox（扫码设备码方式）

Torbox 支持完整能力：即时解析 + 云媒体库。NuvioTV 为它采用设备码（Device Code）扫码登录，无需在电视上输入密码：

1. 在 Connected Services 页面点击 Torbox 连接
2. 电视屏幕上弹出二维码 + 8 位授权码
3. 用手机打开 Torbox 官网，扫码或在网页输入该授权码，点击"Approve（批准）"
4. 电视端提示"Waiting for approval..."，批准后自动完成连接

设备码认证的通信逻辑封装在 DebridDeviceAuth.kt。整个过程大约 30 秒，是三大服务中最省事的连接方式。

五、教程3：连接 Premiumize（扫码设备码方式）

Premiumize 的接入步骤与 Torbox 几乎一致：

1. 点击 Connected Services 中的 Premiumize 连接
2. 扫描电视上的二维码（或手动输入授权码）
3. 在 Premiumize 网页端确认授权，电视端自动完成连接

它同样支持即时解析和云媒体库浏览，文件筛选逻辑见 PremiumizeDirectDownloadFileSelector.kt。

六、进阶：设置首选解析器与即时播放

如果你同时连接了多个 Debrid 服务，NuvioTV 允许指定首选解析服务（Preferred Resolver），播放时优先用它转链。总调度逻辑在 DirectDebridResolver.kt 中：

• 同一资源的解析结果会缓存，避免重复转存
• 并发解析有去重保护，多个界面同时请求也只提交一次
• 可在设置中调整即时播放准备数量（Instant playback preparation limit），控制并行转存条数

此外，还能对搜索结果设置筛选与排序：最小分辨率、HDR / 杜比视界过滤、编码过滤（HEVC/AV1 等）、音频声道偏好，以及自定义流名称模板。这些默认值定义在 DebridStreamFormatterDefaults.kt。

开启Cloud library后，侧边栏会出现各服务的云媒体库入口，直接浏览你账号内已转存的影片和剧集并播放。

七、常见问题 FAQ

Q1：连接后播放磁力还是转圈？A：说明该资源尚未在 Debrid 中缓存，需要转存。首次播放稍慢属正常，之后走缓存即秒播。

Q2：三家服务怎么选？A：追求"扫码即连 + 云媒体库"选Torbox或Premiumize；已有 API Key 习惯、只想要直链解析选Real-Debrid。

Q3：Debrid 设置存在哪里？A：按 Profile 本地保存（见 DebridSettingsDataStore.kt），多用户账号互不干扰。

八、总结

NuvioTV 用一套统一的 Connected Services 页面，把 Real-Debrid、Premiumize、Torbox 三大 Debrid 服务的接入压缩到了三步：打开设置页 → 扫码或填 Key → 享受秒播。再配合即时解析、流筛选和云媒体库，一部电视盒子就能变身随点随播的私人媒体中心。

📌 更多架构细节可查看官方仓库文档：docs/architecture/mdblist-library.md

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