如何将 Twitter/X 收藏夹同步到 Apple TV 播放

用 XTTV 这个应用，通过 Twitter 授权登录后，一键同步你的 Bookmark 收藏视频，就能在 Apple TV 上用大屏幕看所有收藏的内容了。

为什么需要这个功能？

Twitter（现在叫 X）的 Bookmark 是个挺实用的功能，可以把想看的推文先存起来。但问题是，X 官方没有出过电视版应用，所以这些收藏的视频只能在手机上小屏幕看，体验确实不太好。

我自己就是重度 Twitter 用户，每天刷到有趣的视频就顺手收藏，但回头想在大屏幕上舒服地看时，发现根本没官方方案。这也是我做 XTTV 的初衷之一——把收藏的视频搬到电视上。

XTTV 是怎么工作的？

XTTV 本质上是一个播放器，不生产内容，只是帮你把在 X 上收藏的视频以更友好的方式在电视上播放出来。

登录方式

Apple TV 遥控器打字确实不太方便，所以我用了 OAuth 2.0 的设备授权流程：

电视上会显示一个授权链接或二维码
用手机或电脑浏览器打开这个链接
在浏览器里登录 Twitter 并授权
授权完成后，电视端自动刷新并加载内容

这样避免了在电视上输密码的糟糕体验。另外，应用只申请读取权限，不会发推文、不会点赞评论，最大限度保护账号安全。

同步逻辑

后端做了一些优化来提高同步效率：

第一次同步会拉取最近的收藏，只保留含视频的条目
后续同步只检查新增的内容，避免重复拉取
Token 会自动续期，不用重复登录
如果收藏的是引用了视频的文字推文，会自动追溯到原始视频

实际测试下来，用户收藏的推文里大概 30-40% 包含视频或引用视频。系统会自动过滤掉纯文字和图片推文，只留下能播放的视频。

电视端界面

同步完成后，电视上会显示一个视频网格：

有缩略图、作者信息、播放时长
用遥控器上下左右选择，按播放键就能看
支持断点续播，中断后可以从上次位置继续
分页加载，几百条收藏也能流畅浏览
随时可以点同步按钮获取最新收藏

具体怎么设置

第一步：安装并启动 XTTV

在 Apple TV（tvOS 15.0+）上装好应用，启动后会看到登录界面。

第二步：获取授权链接

应用会显示一个 Twitter OAuth 授权 URL，类似这样：

https://twitter.com/i/oauth2/authorize?...

推荐用手机扫码，或者手动在浏览器里打开这个链接。

第三步：在手机上完成授权

登录你的 Twitter/X 账号
确认应用只请求读取权限
点 "Authorize app" 授权
浏览器显示 "OK" 就成功了

第四步：回到 Apple TV 刷新状态

按遥控器上的 Play/Pause 键，或者点"刷新授权状态"，应用会自动检测登录完成并加载内容。

第五步：进入收藏夹同步

导航到收藏夹（Bookmarks）标签页
点同步按钮
等几秒钟（取决于你收藏了多少）
系统会自动过滤并展示所有含视频的收藏推文

同步完成后会提示有多少个可播放的书签项，或者显示"已经是最新状态"。

其他功能

多平台支持

XTTV 目前支持 Apple TV，Android TV 版本即将发布。两个版本将共用同一套后端服务，账号数据互通。界面支持中文、英文、日文、西班牙文切换。

List 同步

除了 Bookmark，还可以同步你关注的 Twitter List 时间线，或者用热门搜索关键词快速发现内容。

隐私和安全

Token 存在 tvOS 的 Keychain 里，比较安全
API 密钥不会暴露在客户端，通过后端中转
只申请必要的读取权限

常见问题

同步后有些收藏没显示，为什么？

XTTV 只显示包含视频的收藏推文。纯文字、只含图片、或者视频已被删除的推文会被过滤掉。这个过滤是正常的，用户收藏里大概 60-70% 是非视频内容。

需要付费吗？

基础搜索和浏览功能免费。Bookmark 同步和 List 同步是高级功能，需要订阅。主要是因为后端服务器和 API 调用有持续成本。

Token 过期了怎么办？

系统会在 Token 过期前自动续期。只有在以下情况才需要重新登录：你在 Twitter 安全设置里撤销了授权、长期没用导致 Refresh Token 失效、或者改密码触发了安全重置。

可以在多台电视上用同一个账号吗？

可以。只要用同一个 Twitter 账号登录，不同设备间的收藏内容是同步的。

Android TV 和 Apple TV 数据互通吗？

Android TV 版本即将发布，发布后将与 Apple TV 版本共用同一后端服务，体验基本一致。

视频播放质量怎么样？

应用会自动选择最高可用质量。Twitter 视频通常有 HLS 自适应流和 MP4 固定码率文件。Apple TV 4K 支持最高 1080p 播放（受 Twitter 原视频限制）。

总结

如果你每天在 Twitter 上收藏好几条视频，但只能在手机小屏幕上看，把这个功能同步到 Apple TV 确实能显著提升观看体验。一次授权后就能永久自动同步，电视遥控器操作也比手机投屏方便很多。

下载 XTTV

在 Apple TV 上打开 App Store，搜索 "XTTV" 即可下载安装。

在 App Store 下载 XTTV