通过二维码为你的 Android TV 添加云账户

用遥控器输入电子邮箱地址和密码既慢又让人沮丧——在屏幕键盘上一个字母一个字母地找，一次点一下。Cloudist Play 和 Cloudist Watch 现在彻底跳过了这一步：你的 Android TV 或 Google TV 会显示一个二维码，剩下的交给你的手机完成。扫一下，选一个账户，你的云存储几秒钟内就会出现在大屏幕上。

你需要准备什么

• 在 Android TV 或 Google TV 设备上安装 Cloudist（Play 或 Watch，要与你电视上使用的应用一致）
• 在 iPhone 或 Android 手机上安装 Cloudist——如果你只是想用摄像头扫码，第一步并不需要安装应用
• 两台设备连接同一个 Wi-Fi 网络
• 如果你使用的是免费套餐，请注意电视端仍然受账户数量上限约束，因此如果电视已达到账户数量上限，配对可能会失败

操作步骤

1. 在电视上，进入设置 → 账户，选择用手机添加。电视会在标题用手机添加下方显示一个二维码，并附有提示文字："用手机摄像头或 Cloudist Play 应用扫描此代码。两台设备必须连接同一个 Wi-Fi。"
2. 在手机上，打开系统相机对准代码，或者打开 Cloudist，进入设置 → 账户 → 发送到电视，然后使用应用内的扫描功能（扫描电视代码）。
3. 你的手机会显示现有云账户列表。选择一个发送，或者选择添加新账户，重新登录后发送该账户。
4. 账户到达后，电视会显示"已添加：{name}"，接着询问"要立即对 {name} 进行完整扫描吗？"，并提供稍后和开始完整扫描两个选项。
5. 从第一步重复操作，选择添加另一个账户，或者选择完成结束流程。

电视屏幕上的代码不是静态的——它会自动刷新（"{seconds} 秒后刷新代码"），所以如果你扫码花了太长时间，只需等待下一个代码出现即可。

哪些账户可以发送？

除了本地账户（根据定义，它只存在于添加它的那台设备上）之外，所有云账户类型都可以发送到电视。

对于 Google Drive、Box 和 Yandex Disk，将账户发送到电视会创建一次专门为电视进行的全新登录。也就是说，电视最终会拥有自己的访问权限，并独立刷新它，而不依赖于手机保持登录状态。对于其他所有服务商，电视会共享手机现有的登录状态。

如果你发送了一个电视上已经存在的账户，Cloudist 只会更新它的令牌，而不会添加重复项——这在电视上的某个账户需要刷新时很有用。

你的账户如何保持私密

配对功能的设计目标是始终留在你的家庭网络内部，而不是依赖信任别人的服务器来传输你的凭据。

• 电视只在私有网络地址（也就是你家路由器分配的那种地址）上监听配对连接，并拒绝任何不是来自你本地网络的请求。
• 两台设备使用 X25519 密钥交换来协商一个共享密钥，在这种方式下，任何一台设备都不会把自己的私钥发送出去。
• 这个共享密钥随后会通过 HKDF-SHA256 处理，转化为该会话实际使用的加密密钥。
• 手机和电视之间传输的所有内容都使用 AES-256-GCM 加密，该算法同时还能检测传输过程中是否有任何篡改。
• 每个配对会话持续 5 分钟，一旦成功使用一次即失效，并且连续 5 次失败后会被锁定。
• 当你用手机摄像头而不是应用内扫描功能扫描二维码时，会打开一个通用链接（Play 为 https://play.fromcloud.ist/pair#…，Watch 为 https://watch.fromcloud.ist/pair#…）。实际的配对密钥位于该链接中 # 之后的部分——也就是 URL 的 fragment 部分——浏览器永远不会把这部分发送给任何服务器，包括我们的服务器。如果手机没有完成这次交换，仅凭这个链接本身是无法连接到你的电视的。

手机上还没有安装应用？

如果你在安装 Cloudist 之前就用手机摄像头扫描了电视上的二维码，该链接会打开一个普通的落地页，而不会进行任何配对。该页面只会显示应用商店按钮，供你下载应用，然后从应用内真正开始配对流程。

疑难解答

• 扫码后没有任何反应，或电视一直没有发现你的手机：确认两台设备确实连接的是同一个 Wi-Fi 网络。访客网络，或手机上运行的 VPN，即使显示的 Wi-Fi 名称相同，也可能阻止同一网络下的设备互相访问。
• 还没扫完，电视上的代码就变了：代码会自动过期并刷新。扫描新的代码即可。
• "此电视已达到账户数量上限。"：你当前的套餐限制了一台电视能保存的账户数量。使用该界面上显示的升级选项，或先移除一个现有账户。
• "此应用版本不支持该账户类型。请更新应用。"：电视上运行的应用版本还不认识该服务商。在电视上通过 Play 商店更新 Cloudist，然后重试。

获取更新

两款应用的最新更新中都已加入通过二维码在电视上登录的功能。了解更多关于 Cloudist Play 和 Cloudist Watch 的信息，或在这里获取：

• Cloudist Play（音乐）：App Store · Google Play · 网页版
• Cloudist Watch（视频）：App Store · Google Play · 网页版

Cloudist Play 1.0.34 和 Cloudist Watch 1.0.28 将这项功能带到了 Android TV 和 Google TV——无需再用遥控器打字。