NuvioTV快速上手：从安装到首播只需3步，附加组件安装完全指南
【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV
NuvioTV 是一款免费开源的 Android TV 媒体播放器（Android TV 媒体播放器），它遵循"自带片源（BYOS）"理念：你只需安装附加组件提供内容源，NuvioTV 就会自动为影片配上海报、评分、字幕，并在手机、平板和电视之间同步你的播放进度 📺。无论你是新手还是进阶用户，只要完成"安装 → 装附加组件 → 首播"这 3 步，就能在电视上开始观影。
一、认识 NuvioTV：它能做什么？
NuvioTV 基于 Kotlin + Jetpack Compose + TV Material 3 + Media3 构建（见 README.md），核心能力包括：
- 🎬统一库：来自不同附加组件的内容统一展示为带海报和评分的媒体库
- 🔍搜索与发现：支持文字搜索、语音搜索和 Discover 发现页
- ⏯️强大播放器：字幕/音轨切换、源切换、跳片头、自动播放下一集、杜比视界支持
- ☁️多端同步：通过 Nuvio 账号二维码登录，同步账号、档案与播放进度（可跳过）
- 🔀双体验模式：首次启动可选择Essential（精简模式）或Advanced（高级模式），新手推荐精简模式，界面更安静（详见 docs/essential-mode.md）
二、第 1 步：安装 NuvioTV
NuvioTV 提供两种官方安装途径：
- Google Play 商店：直接在 Android TV 设备的应用商店中搜索安装，最省事
- APK 安装包：从发行版（Releases）页面下载 APK，拷贝到 U 盘或通过网络传到电视上安装，适合 Play 商店不可用的设备
如果你是开发者，也可以从源码构建（需要 Android Studio、JDK 和 Android SDK）：
git clone https://gitcode.com/gh_mirrors/nu/NuvioTV cd NuvioTV ./gradlew :app:assembleFullDebug💡 新手提示：安装完成后无需配置任何网络参数，直接进入首次引导流程即可。
三、第 2 步：安装第一个附加组件（核心步骤）
NuvioTV 本身不提供片源，内容由**附加组件（Add-on）**提供——它们遵循 Stremio 兼容协议（协议模型见 domain/model/Addon.kt）。没有安装任何附加组件之前，首页和搜索页会是空的，这是新手最常卡住的一步。
首次启动时，如果还没有安装附加组件，NuvioTV 会引导你进入专门的"附加组件设置"页（EssentialAddonSetupScreen.kt），提供两种安装方式：
方式 A：手机端扫码管理（推荐）⭐
这是电视上体验最好的路径。NuvioTV 内置了一个本地 Web 配置服务（AddonConfigServer.kt），在附加组件页面选择"Manage from phone"后，电视会显示一个二维码：
- 用手机浏览器扫描电视上的二维码
- 在手机网页中粘贴附加组件 URL（形如
协议://域名:端口/附加组件ID.json） - 电视端确认后，附加组件即安装成功，无需在遥控器上逐字敲 URL
方式 B：手动输入 URL
如果你手边没有手机，可以直接在附加组件页面选择"Enter URL"，用遥控器输入附加组件地址完成安装。管理入口位于 AddonManagerScreen.kt，已安装的组件会显示在这里，随时可以移除失效或多余的组件。
⚠️ 小贴士：附加组件失效时，直接到"Add-ons"页面将其移除即可恢复；模式切换（Essential ↔ Advanced）永远不会删除你的附加组件或播放记录。
四、第 3 步：找到内容并首播 🎉
附加组件装好后，首页（Home）会自动加载其目录内容。首播流程：
- 找片：在首页目录中浏览，或用 Search 页按片名搜索（支持语音搜索）
- 进入详情页：点击海报查看简介、评分、集数信息
- 选择播放源：详情页开始解析流（Stream），根据播放设置手动选择一个源或自动播放第一个可用源（默认手动选择，避免选错源）
- 播放：内置播放器（默认 ExoPlayer 引擎）自动起播，核心操作见 PlayerScreen.kt
播放中常用功能：
| 功能 | 说明 |
|---|---|
| 字幕 / 音轨切换 | 播放器侧栏快速切换语言 |
| 源切换（Sources） | 当前源卡顿时无缝换源 |
| 跳过片头 | 默认开启，可按需关闭 |
| 自动播放下一集 | 设置中一键开启 |
| 续播 | 进度自动保存，跨设备同步 |
五、新手常见设置速查
精简模式（Essential）只保留最常用的设置，全部集中在设置页的几个分区：
- App 模式：Essential / Advanced 切换，切到 Advanced 立即解锁完整设置栏（布局、插件、Trakt/TMDB 集成、解码器调优等，完整功能矩阵见 docs/essential-mode.md）
- 播放基础：播放器偏好（内置 / 外部 / 每次询问）、流选择方式、自动播放下一集
- 字幕与音频：首选字幕语言、字幕大小、首选音频语言
- 外观：应用语言、主题（支持中文等多语言界面，见 res/values-zh-rCN）
- 账号：二维码登录 / 退出，多档案（Profile）管理
六、常见问题 FAQ
Q1：为什么安装后首页是空的？没有安装任何附加组件。按"第 2 步"装一个附加组件后，首页目录会自动出现。
Q2：电视上输入附加组件 URL 太麻烦了？使用手机扫码方式，NuvioTV 会在局域网内启动 Web 配置服务，手机上粘贴即可，电视自动同步。
Q3：附加组件不工作了怎么办？到 Add-ons 页面移除该组件，或换一个地址重新安装；播放时也可以直接在播放器里切换其他可用源。
Q4：必须登录 Nuvio 账号吗？不必。账号登录（二维码扫码）是可选的，仅用于跨设备同步和档案；不登录也能完整使用本地功能。
完成以上 3 步，你的 NuvioTV 就已经可以正常使用了。想进一步探索布局定制、插件仓库、Trakt/MDBList 评分集成等进阶能力，随时在设置中切换到 Advanced 模式即可——所有能力都已就绪，只等你开启 🚀。
【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
