NuvioTV多用户与跨设备同步：7个技巧用QR码登录管好全家电视-平芜编程栈

NuvioTV多用户与跨设备同步：7个技巧用QR码登录管好全家电视

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

NuvioTV 是一款免费的开源 Android TV 媒体应用，自带多用户个人资料（Profile）管理与跨设备云端同步能力：你在电视上用二维码扫码登录账号后，播放进度、图书馆、插件、设置等数据会自动同步到手机、桌面和家里的每一台电视。本文用 7 个实用技巧，帮你快速用 QR 码登录把全家的电视管好。

技巧1：QR码扫码登录，手机一键授权电视

电视遥控器输入长串密码很痛苦。NuvioTV 采用类似现代电视设备的QR 码登录：进入账号页面后，屏幕右侧自动生成二维码和一组 6 位验证码。打开手机浏览器打开提示中的验证地址，登录账号后确认授权，电视端会自动轮询状态并在批准后完成会话交换，全程无需在电视上敲键盘。

二维码由 QrCodeGenerator.kt 生成，带圆角样式，扫起来更清晰
登录界面的完整实现见 AuthQrSignInScreen.kt，左侧展示品牌与账号状态，右侧是登录操作区
二维码会过期，界面有倒计时提示；过期点"刷新"即可重新生成

技巧2：创建最多6个家庭个人资料

家庭成员各看各的，进度互不干扰。NuvioTV 最多支持6 个 Profile（见 ProfileManager.kt 中的MAX_PROFILES = 6）：

每个资料有独立名称、头像颜色与头像
个人资料的数据相互隔离：播放进度、插件代码、设置都按 profile 维度存储
删除非主资料时会彻底清理其本地数据，主资料不可删除，保证应用始终可用

技巧3：开启"记住上次资料"，开机直达专属界面

在资料管理里可以打开remember last profile开关：下次启动应用时直接进入你上次使用的那个资料，免去每次重新选择；关闭它则每次开机都会显示"谁要使用"选择页。对于"电视是全家共用"的场景，建议保持关闭，让每人每次主动选择自己的资料。

技巧4：退出确认防止误触切资料

多人共用电视最怕遥控器误触。NuvioTV 提供confirm exit（退出确认）选项：开启后，按返回键退出当前资料时会弹出确认框，避免不小心把界面交回给选择页或被家人误操作。这个小设置能让"共享电视"体验顺滑很多。

技巧5：了解自动同步到底同步了什么

登录成功后，StartupSyncService.kt 会在启动时并行拉取以下数据，之后还会周期性后台刷新：

同步项	说明
个人资料列表	新建的资料会同步到所有设备
插件与插件仓库	各资料独立的插件配置
附加组件（Addons）	你的媒体源配置
图书馆（Library）	收藏与媒体库条目
播放进度 / 已看条目	续播"继续观看"跨设备一致
主页目录与合集设置	首页栏目、合集
服务商凭据	Debrid 等第三方服务配置

这意味着你在一台电视上收藏的影片、看到一半的剧集，换到另一台电视或手机打开就能续播。

技巧6：手动刷新同步，新数据立刻到位

同步机制除了启动时的完整拉取，还有前台激活同步与每 15 分钟一次的周期性增量同步。如果你在另一台设备刚做了更改又急着想在这台电视看到，可以在账号页触发立即同步（requestSyncNow），它会强制重新拉取全部数据（带 30 秒防抖保护）。账号页登录成功后还会显示已同步的插件数、附加组件数、图书馆条目数与进度条数，一眼确认同步状态。

技巧7：多台电视同一账号，全家共享一套配置

账号会话由 AuthManager.kt 统一管理，支持自动刷新令牌、会话校验与诊断报告。全家多台电视登录同一个 NuvioTV 账号即可共享资料列表与云端数据，各设备之间通过实时数据面（addons、library、watch_progress 等 surface）相互更新。注意：不同成员建议各用各的资料，而不是共用一个资料，这样每个人的续播记录和收藏才真正独立。