TV 扫码失败与高画质不解锁 — 登录和画质两个常见问题
场景一：TV 扫码识别不到
BiliPai 的 TV 扫码登录需要两步：BiliPai 显示二维码 → 官方 B 站 App 扫码。其中任何一步出问题都可能失败。
BiliPai 显示二维码的问题
| 问题 | 解决 |
|---|---|
| 二维码是空白或全黑 | 重启 BiliPai，或切换网络后重新生成 |
| 二维码模糊 | BiliPai 里点刷新按钮换一个新码 |
| 屏幕暗导致扫码困难 | 提高 BiliPai 屏幕亮度 |
官方 App 扫一扫的问题
| 问题 | 解决 |
|---|---|
| 摄像头权限没给 | 手机设置 → 应用管理 → B 站 App → 权限 → 相机 → 允许 |
| 光线不足 | 换光线好的环境，或开手电筒辅助（注意不要直射屏幕导致反光） |
| 摄像头对焦不准 | 手动点击屏幕中央让摄像头对焦 |
| 屏幕反光 | 擦干净屏幕，调整角度避免反光 |
| 扫码框太小（官方 App 的扫一扫框比微信小） | 把 BiliPai 的二维码尽量放大全屏显示 |
| 反复识别失败 | 换一个登录方式——手机号 + 验证码更稳 |
网络问题
TV 扫码登录需要 BiliPai 和官方 App 都有稳定网络：
- BiliPai 生成二维码后会定期请求 B 站服务器检查是否被扫描
- 官方 App 扫描后需要把授权信息发送到 B 站服务器
- 两端任何一端网络不通都会导致登录超时
确认两端网络正常，然后再试。
极端情况：B 站 TV 扫码服务故障
极少数情况下 B 站的 TV 扫码服务本身有问题（比如 API 临时维护）。这种情况在官方 App 上也会失败，只能等 B 站修复。
场景二：登录了还是看不到高画质
你用大会员账号登录 BiliPai 后，打开一个应该有 4K 或 1080P60 画质的视频，但画质选择里还是只有 1080p 或更低。
先排除 B 站官方的原因
| 原因 | 检查 |
|---|---|
| 视频源本身没有高画质 | 在官方 App 或网页版打开同一个视频，看看官方能不能选高画质 |
| 大会员权限到期 | 确认你的大会员状态是否还有效 |
| 设备不支持高画质解码 | 部分老手机的播放器不支持 HEVC / H.265 解码，即使 BiliPai 拉到了高画质也放不出来 |
再看 BiliPai 的原因
| 原因 | 解决 |
|---|---|
| 登录 Cookie 没生效 | 退出登录重新登录一次（重新拉取会话） |
| API 返回的数据没缓存 | 清除 BiliPai 的缓存：设置 → 存储与数据 → 清除缓存（不影响笔记和播放历史） |
| B 站 API 临时异常 | 等几分钟再开视频，或换个视频试试 |
| 网络切换了（Wi-Fi ↔ 移动） | 重新打开视频页面让 BiliPai 重新请求 |
画质切换不即时生效
有时候在播放中途切了画质，画面不会立刻跳到新清晰度——BiliPai 会等当前缓冲播完再切。这是 DASH 协议的正常行为，不是 bug。
场景三：HDR / DOLBY VISION 不显示
这个问题比普通高画质更复杂：
- HDR10：需要视频源有 HDR 轨道 + 设备支持 HDR 解码。BiliPai 的 Media3 引擎在 Android 10+ 支持 HDR 播放
- DOLBY VISION：需要视频源有 DV 轨道 + 设备硬件支持（通常是高端 Android 旗舰或 iPad）。BiliPai 能否正确显示 DV 取决于 ExoPlayer 的兼容性
- 如果设备不支持 HDR / DV，BiliPai 会自动降到 SDR 播放，不会报错
画质问题排查清单
- 先在官方 App / 网页版验证同一个视频能不能选到目标画质
- 确认账号大会员权限有效
- 退出 BiliPai 重新登录
- 清除缓存后重启 App
- 确认设备芯片支持 HEVC / AV1 解码（大多数骁龙 7 系以上都支持）
- 更新 BiliPai 到最新版本
- 换网络（Wi-Fi ↔ 移动）再试
视频没有弹幕
额外提一个常见小问题——视频开了弹幕开关但画面上没看到弹幕：
- 视频本身没有弹幕（部分新发布的视频、长视频可能暂时没人发弹幕）
- 视频地区限制（B 站部分视频弹幕仅限中国大陆，海外 IP 看不到）
- 清掉弹幕缓存：设置 → 存储与数据 → 清除弹幕缓存
- BiliPai 版本过旧 → 更新到最新版