NuvioTV观影记录同步：Trakt、Simkl与Letterboxd(MDBList)接入完全教程

NuvioTV观影记录同步Trakt、Simkl与Letterboxd(MDBList)接入完全教程【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTVNuvioTV 是一款面向 Android TV 的开源媒体应用它的观影记录同步功能可以一键打通 Trakt、Simkl 与 MDBListLetterboxd 评分三大平台你看完的剧集自动上报观看进度、继续观看列表跨设备保留电影详情页还能展示 Letterboxd 等外部评分。本教程将带你用最简单的方式完成全部接入。为什么需要观影记录同步用 TV 盒子看片最头疼的就是记录散落在各处手机端刷过的、电视上看完的、收藏列表各记各的。NuvioTV 的同步模块core/sync/ 目录下的 WatchProgressSyncService.kt 与 WatchedItemsSyncService.kt负责把播放进度和已看状态写回云端服务实现 电视上看了一半手机上打开自动续播✅ 看完自动打勾scrobble不用再手动记 影视详情页聚合 Trakt、Letterboxd、IMDb 等多平台评分一眼做决定。找到同步设置的入口所有追剧平台的连接都集中在设置 → 追剧/追踪设置页面由 TrackingSettingsScreen.kt 实现。页面顶部就是三个连接卡片分别对应Trakt—— 全功能观影历史、进度、列表、个人清单Simkl—— 全功能支持动画党可同时管理多平台记录MDBList—— 连接账号同步观影历史并提供 Letterboxd 等外部评分显示。三个卡片下方还有四个关键选项Library Source库来源、Watch Progress进度来源、Continue Watching Window继续观看时间窗口、More Like This相似推荐来源后文会讲它们怎么配。Trakt 接入教程设备码三步完成Trakt 是使用最广泛的影视记录平台NuvioTV 采用**设备授权Device Auth**方式连接无需输入账号密码安全性高在追踪设置页点击 Trakt 卡片 → 点Login屏幕会显示一个短代码和一个二维码逻辑见 TraktViewModel.kt用手机或电脑打开 Trakt 官方的设备激活页面输入该代码并登录授权电视端自动轮询几秒后卡片状态变为Connected as 你的用户名。 代码有有效期界面会提示 Code expires in…过期后点重新获取即可。授权凭证由 TraktAuthDataStore.kt 加密保存Token 会自动刷新无需重复操作。连接后TraktProgressService.kt 会持续拉取进度与统计卡片上即可看到累计观影数据。Simkl 接入教程动画党的同步利器Simkl 主打多平台聚合电影、剧集、动画统一管理接入流程与 Trakt 同为设备授权点击 Simkl 卡片发起连接SimklSettingsViewModel.kt 会生成授权会话并展示代码在浏览器中确认授权状态切换为已连接随后 SimklSyncEngine.kt 负责增量同步历史与进度。追番用户可以额外开启动漫 ID 匹配选项界面中的 Anime ID 设置对应 SimklAnimeIdPreference.kt让番剧记录准确落到对应的 MyAnimeList 条目上。MDBList 接入教程解锁 Letterboxd 评分想在看片页看到Letterboxd、IMDb、Rotten Tomatoes、Metacritic 等评分这就是 MDBList 的用武之地。它的接入分两步第一步连接 MDBList 账号同步观影记录点击 MDBList 卡片MdbListTrackerViewModel.kt 发起设备授权电视端弹出二维码对话框MdbListAccountDialog.kt用手机扫码或在 MDBList 网页端输入屏幕上显示的代码授权成功后显示Connected as 你的用户名观影历史与播放进度开始双向同步。⚠️ 授权时请务必勾选允许写入观看历史否则界面会提示权限不足insufficient scope重新连接并授予写权限即可。第二步开启外部评分显示进入设置中的MDBList Ratings页面MDBListSettingsScreen.kt你可以按平台逐个开关开关效果Letterboxd详情页展示 Letterboxd 评分Trakt / IMDb / TMDB展示对应平台分数Rotten Tomatoes展示烂番茄影评人分Audience / Metacritic展示观众分 / Metacritic 分MyAnimeList展示 MAL 动画评分评分请求由 MDBListApiClient.kt 发起配置持久化在 MDBListSettingsDataStore.kt。默认使用你已连接的 MDBList 账号也可填入单独的 API Key 仅用于评分拉取。更多架构细节可参考官方文档 docs/architecture/mdblist-library.md。进阶配置让同步体验更进一步连接完成后别漏掉追踪设置页的四个选项它们决定记录归谁管Library Source库来源选择库条目存到 Trakt 还是 Nuvio 本地库。推荐常看 Trakt 的用户选 Trakt保持一个入口管理收藏Watch Progress进度来源决定继续观看和续播读 Trakt 进度还是 Nuvio 自己的进度。混用多设备时建议与主记录平台保持一致Continue Watching Window继续观看窗口限制继续观看列表收录的最近天数避免老片刷屏More Like This选择相似推荐的数据来源让详情页推荐更懂你。常见问题排查 现象原因与解决Trakt 提示缺少凭证发行版未内置 Trakt 密钥见 strings.xml 中trakt_missing_credentials使用完整构建版即可MDBList 代码过期设备码有有效期点击重新生成即可提示授权被撤销在 MDBList 账户设置中移除了本应用重新连接授权触发限流提示平台请求额度用尽稍等自动恢复无需干预进度不同步检查 Watch Progress 来源设置是否与主平台一致小结NuvioTV 的观影记录同步把Trakt 全功能记录、Simkl 多平台聚合、MDBList/Letterboxd 评分聚合收敛到了同一个设置页三种设备授权方式都是扫码/输码几秒钟搞定配合库来源与进度来源的细粒度开关你的观影历史从此在所有屏幕上自动保持一致。快去设置里把它们连起来吧【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考