开源安卓电视B站客户端Blbl：大屏观影与遥控器交互实战指南

聊一款最近一直在折腾的开源项目：Blbl，一个面向安卓电视端的哔哩哔哩第三方客户端。如果你家里有电视盒子或者大屏安卓电视，又受不了官方TV版的各种限制和广告，那这个项目值得你花几分钟了解。目前项目已经更新到 v0.1.18，版本号虽然还比较早期，但作为日常看番刷视频的替代品，完成度已经相当能打了。这篇文章我不打算写成一板一眼的评测，而是把我从下载安装、扫码登录到实际使用中踩过的坑、琢磨出来的技巧，都摊开来讲一讲，给同样想在大屏上好好刷 B 站的你一个参考。

1. 项目概述与定位

1.1 为什么需要一款第三方B站TV客户端

先说说背景。B 站官方电视版这些年一直有点“拧巴”：首页推荐还算能用，但弹幕开关藏得深，清晰度选择经常被绑到会员体系里，部分番剧在大屏端压根搜不到，更别提不少老盒子装新版客户端还会卡成 PPT。很多人在电视上刷 B 站的办法就这么几个：手机投屏、浏览器开网页版、或者想办法装旧版 APK。投屏的问题是操作来回切，消息一来就断；网页版在电视遥控器下基本没法用，焦点对不准，滚动全靠猜；旧版 APK 又存在接口失效、视频播放不了的问题。

Blbl 这种第三方客户端的价值就在于，它把 B 站原本在移动端的接口能力搬到了电视上，用遥控器就能完成大部分操作，同时绕开了官方 TV 版里一些令人抓狂的产品决策。它不是“破解版”，而是基于 B 站开放能力重新做了一套适合电视场景的交互，所有数据仍然来自你自己的账号和 B 站服务器，所以不需要什么特殊网络环境，家里能正常访问 B 站就行。

1.2 Blbl的核心优势

从我实际的体验来看，Blbl 最戳我的几个点分别是：

• 纯粹的电视界面：整体布局按照电视 10 英尺 UI 设计，左侧导航、内容卡片、焦点放大动效，不会出现手机 App 拉伸后那种“一指禅”图标。
• 遥控器友好：左右上下键就能完成几乎全部操作，确认、返回、菜单键都有明确功能，没有恼人的鼠标指针。
• 弹幕兼容：弹幕显示、透明度、字号调节都能做，和手机端同步弹幕池，看直播的时候弹幕体验也还行。
• 播放器能力完整：支持切换清晰度、倍速播放、记忆播放进度，部分视频还能选集，日常追番够了。
• 开源可查：代码、Issue、Release 都在 GitHub 上挂着，项目进化方向公开，不用担心背后搞小动作。

当然，它也有明显的“早期项目”味道，比如设置项不够丰富，部分视频因为 B 站风控会出现解析失败，但这恰恰是开源项目正常的生长状态——有问题反而可以提 Issue，或者看作者在更新日志里逐条修。

1.3 版本迭代看项目活跃度

v0.1.18 这个版本号说明项目还处于 0.1 阶段，按语义化版本的理解，就是功能在快速迭代，API 可能不稳定，但主线功能已经能跑通。我看到更新日志里陆续修了不少播放器崩溃、弹幕偏移、登录态过期的问题，说明作者是真有在电视上实际使用，不是写完就丢上去不管。对一个 2026 年还在活跃更新的开源项目来说，这种节奏本身就能给用户吃一颗定心丸。

2. 安装部署：从下载到上电视的几种姿势

2.1 下载与版本识别

获取 Blbl 的最直接渠道是 GitHub Releases 页面，目前最新版是 v0.1.18。下载时要注意 APK 文件的命名，一般会包含架构信息，比如arm64-v8a或者armeabi-v7a。这里有一个非常容易踩的坑：如果你手里是比较老的电视盒子，尤其是几年前的 RK3228、全志 H3 方案的盒子，CPU 架构可能是 32 位的，这时候强行装 arm64 包虽然能装上，但运行时可能会出现“解析包错误”或者直接闪退。建议先查一下自己电视盒子的芯片型号，再选对应 APK。

还有一个细节：不要把 GitHub Releases 页面里带debug字样的包当成正式包。早期版本作者可能同时传了 debug 和 release 两种，debug 包主要是给开发者抓日志用的，普通用户应该优先下载不带 debug 的版本，否则遇到崩溃时弹窗会是一些底层堆栈信息，观感很差。下载完成后别急着装，先在手机或者电脑上对比一下文件体积和 Release 说明里的哈希值（如果作者给出了的话），虽然麻烦一点，但至少能确认下载过程没被劫持。

2.2 U盘安装（最常见）

电视安装第三方应用的常规办法，还是 U 盘大法。具体步骤非常固定：

1. 将 APK 文件复制到 U 盘根目录，建议重命名为简单的英文名比如blbl.apk，避免电视自带文件管理器对中文文件名显示乱码。
2. U 盘插入电视的 USB 接口，等电视弹出检测通知。
3. 打开电视自带的“文件管理器”或“媒体中心”，找到 U 盘里的 APK。
4. 点击安装，这时候电视通常会弹“禁止安装未知来源应用”的确认框，需要在设置里允许来自 U 盘的安装权限。

这里提醒一句：不同品牌的电视设置路径差很多，索尼的通常在“应用安全”里，小米电视在“账号与安全”里，当贝盒子则在“通用设置”里。如果你找不到，最快的办法是直接装一个当贝市场之类的中转应用，再从当贝市场里打开本地安装功能。但从安全角度讲，能不装额外商店就不装，给电视留一个干净环境对长期体验很重要。

2.3 ADB远程安装（进阶）

如果你手头没有 U 盘，或者电视上的文件管理器压根不识别 APK，ADB 远程安装是更稳妥的方案。所谓 ADB，就是安卓调试桥，电脑上装好 platform-tools 之后，通过局域网就能把 APK 推送到电视。

先打开电视的开发者选项，一般操作是：设置 -> 关于 -> 连续点击版本号 7 次，然后回到设置里找到“开发者选项”，打开“USB 调试”或者“网络调试”。不同品牌对 ADB 端口的设定略有不同，常见是 5555，也有些盒子改成了自定义端口。电脑和电视连同一个 Wi-Fi，在电脑终端执行：

adb connect 192.168.1.100:5555 adb install -r blbl.apk

如果connect命令卡住，检查一下电视的 IP 是否填对，以及路由器是否开了 AP 隔离。ADB 连接成功后，install命令跑完会出现Success字样。这种方法比 U 盘更快，而且便于后续抓日志排查问题，如果你打算长期折腾开源电视软件，建议把 ADB 环境配好，省下很多弯腰插拔 U 盘的功夫。

2.4 安装后需要注意的权限

Blbl 首次启动时一般会申请“存储权限”，主要是为了缓存视频片段和保存播放记录。另外，如果你需要投屏或者截屏，可能还会弹“显示在其他应用上层”之类的权限。按电视端 App 的一般习惯，存储权限直接允许即可，其他敏感权限如果不需要可以拒绝。

有一点得特别说明：不要在安装后立刻把电视的“未知来源应用”权限关掉，因为开源应用更新频率高，隔几周就要手动装新版，如果权限关了，下次安装会被系统拦截，又得去设置里重新开一遍，非常折腾。当然，等版本稳定到 1.0 之后也许会有自动更新机制，但在那之前，手动安装还是主旋律。

3. 上手体验与核心功能拆解

3.1 登录：扫码绑定还是短信验证

打开 Blbl 之后，首先遇到的就是登录。第三方客户端登录 B 站账号，通常有两条路：扫码登录和手机验证码登录。Blbl 目前做得比较顺的是扫码登录：电视屏幕上会出现一个二维码，手机打开 B 站 App，用“扫一扫”功能扫码确认即可。整个过程不到十秒，登录态就会同步到电视端。

这里我要给个建议：尽量用扫码，别用短信验证码。原因倒不是说短信不安全，而是电视端的输入框实在不适合输手机号，遥控器挪来挪去够痛苦。另外，登录成功之后，如果想退出账号或者切换账号，别在电视设置里乱翻，一般长按遥控器“确定”键呼出侧边菜单，里面就有账号信息，退出后再次扫码即可。

还有个比较常见的现象：登录后如果几天没开电视，再打开可能发现登录态已经失效，提示重新扫码。这种情况不是 Blbl 的锅，B 站对 token 的有效期管理比较严格，第三方客户端拿到的登录凭证有效期通常比官方短，遇到失效扫一下码就行了，不用反复输密码，至少我没遇到需要重开 App 的崩溃。

3.2 遥控器交互设计

电视端应用的第一生死线就是遥控器交互，键盘鼠标那套逻辑在大屏上完全行不通。Blbl 的交互基本遵循 Android TV 的典型模式：左侧竖排导航栏，有“推荐”“热门”“番剧”“影视”“我的”几个大项，方向键上下移动焦点，左右键翻页或者切换 tab，确认键进入详情，返回键退出。操作逻辑非常统一，学习成本几乎为零。

让我比较意外的是它对“长按”功能的处理。在视频详情页，长按确认键会弹出快捷菜单，里面可以直接选择“稍后再看”“一键追番”甚至“屏蔽该 UP 主”。在播放页，长按 OK 键能呼出播放倍速菜单，0.5 到 2.0 倍速可调。这些功能在官方 TV 版上往往藏在二级甚至三级菜单里，Blbl 把它们提到按键层，看得出作者是认真琢磨过遥控器使用习惯的。

当然，如果你用的是带飞鼠功能的遥控器（就是那种能当空中鼠标的），Blbl 也支持焦点跟随鼠标移动，但实际体验比纯方向键要飘，我的建议还是尽量用方向键操作，稳定且不累眼睛。

3.3 播放体验：清晰度、倍速、弹幕与历史记录

播放页是视频客户端的主战场，Blbl 目前的成绩单算是及格偏上。视频加载后，清晰度可以根据网速和会员权益选择，常见的 360P、480P、720P、1080P 都有，部分高频访问的视频甚至能看到 4K 选项（前提是源视频有 4K 码流且账号权限够）。实测下来，同样的视频在 1080P 下，画质和官方客户端没有肉眼可见的差别，毕竟都是从 B 站接口拿同一份源。

倍速播放是我个人非常高频使用的功能。看课程类视频我一般开 1.5 倍，看番剧则习惯 1.0。Blbl 的倍速实现没有做烂，声音保持正常音调，不会有那种老式加速器的“花栗鼠”效果。这看起来是个小细节，但能体现播放器引擎的素质。

弹幕方面，Blbl 支持显示弹幕池、调节弹幕透明度、字号和滚动速度。默认弹幕密度比较保守，不会糊脸，如果你喜欢满屏弹幕的感觉，可以把密度调到最大。这里有一个体验上的小问题：在播放一些弹幕量极大的视频时，弹幕层偶尔会有轻微掉帧，尤其低端电视上会比较明显。遇到这种情况，我建议直接把弹幕密度降一档，流畅度立刻上来。

历史记录和家人共享场景也值得一提。Blbl 的“我的”页面里可以直接看到观看历史，点进去能续播。而且这个历史记录是绑定账号的，跟手机端同步，这意味着你在客厅看到一半的番剧，回卧室用手机可以接着看，反过来也一样，无缝衔接这点体验确实好。

3.4 这些功能背后的接口逻辑

作为开发者视角，Blbl 的基本工作原理并不复杂：它本质上是把 B 站 Web 端和移动端使用的 HTTP 接口封装成了适合电视 UI 调用的数据源，再用一个成熟的视频播放器去渲染流媒体。推荐、排行榜、视频详情、弹幕、播放地址这些数据都来自 B 站接口。之所以能实现“手机上看到的历史记录电视上同步”，就是因为登录之后拿到了和官方 App 一样的用户凭证，服务端认识你。

当然，B 站接口不是纯开放 API，很多请求需要签名参数、wbi 鉴权之类，第三方客户端得持续跟进。这也是开源项目的日常：某个接口改了，客户端就失效，然后作者发版修复。Blbl 在 v0.1.18 里能正常播放、看历史，说明作者跟接口的节奏不错，但这种兼容性的维护成本很高，所以对开源 TV 客户端的态度要宽容一点——遇到某个页面打不开，先看看是不是又该升级了。

4. 常见问题排查与使用技巧

4.1 登录失效与验证码问题

最频繁遇到的问题就是登录态掉线。前面说过，token 的有效期是 B 站控制的，不是客户端能决定的。如果你连续两天打开电视都提示要重新扫码，可以检查一下电视系统时间是否准确。安卓电视如果时间不对，HTTP 请求的签名校验会失败，用户端表现就是反复登录失败。我遇到过一次，电视休眠后时间慢了十几分钟，扫码登录总是提示“二维码已过期”，把时间改成自动同步之后立竿见影。

另一个登录相关的坑是：如果你在 B 站网页端或者手机端修改过密码，或触发过风控验证，电视端的登录态也会被踢掉。这时候别慌，重新扫码就行。万一扫码后手机显示“确认登录”，电视无反应，优先检查电视网络是否正常，再退出重进应用，一般都能解决。

4.2 播放黑屏或卡顿

播放黑屏分两种：一种是有声音但画面黑，另一种是完全没反应。有声音黑屏大概率是渲染器问题，在低端盒子上多见，可以尝试在播放设置里切换硬解/软解模式，或者降低清晰度到 720P 试试。完全没反应则多数是获取播放地址失败，可能视频本身是会员专享，或者 B 站风控策略临时拦截，这种时候除了升级新版客户端、稍等片刻重试，没有太好的根治办法。

卡顿就不一定都是客户端的锅了。先排除网络因素：电视用 2.4G Wi-Fi 的话，离路由器稍微远一点就很容易卡。我的建议是电视尽量连 5G Wi-Fi 或者网线，实在不行就改清晰度到 480P，至少能顺畅播。如果网络没问题，但播放进度条一直转圈，可以检查是不是路由器开了 IPv6 导致 DNS 解析异常，把电视的网络设置改成自动获取 IP 后重启路由试试。

4.3 遥控器按键无响应

偶尔会遇到“方向键失灵但确认键能用”的情况，这通常是焦点卡到了某一个不可见的组件上。解决方法是按下返回键回到上级页面，再重新进入详情页，基本能恢复。如果全局按键都无响应，大概率应用进程僵死，直接杀掉进程重新打开。怎么杀？设置 -> 应用 -> Blbl -> 强制停止，然后再启动，比重启整个电视快得多。

比较隐蔽的一个问题是输入法。如果电视上装了第三方输入法，且默认输入法切换出问题，可能导致搜索页无法弹出软键盘，或者文字输入不进去。Blbl 的搜索框推荐用系统默认的 leanback 键盘，第三方输入法虽然能打字，但偶尔会顶掉焦点。如果你遇到搜索框点不动，去系统设置里把默认输入法切回系统自带，问题就解决了。

4.4 快速排查表

这些排查经验不只是 Blbl 通用，其他 Android TV 应用碰到类似问题，用同样思路也能解决大半。开源项目的用户本来就需要一点折腾精神，摸清规律之后反而觉得挺有乐趣。

5. 给开发者与折腾党的技术观察

5.1 开源项目的常见技术选型

如果你不只是想用，还想看看代码，Blbl 这类项目通常不会用太冷门的框架。基于我对多个安卓电视开源客户端的观察，合理的推测是它可能选用 Jetpack Compose for TV 或者传统 Leanback 库来做界面，因为这两者是 Android TV 官方推荐方案，对遥控器焦点处理比较成熟；播放器部分大概率是 Media3（ExoPlayer 的继任者），因为它硬解软解切换成熟、弹幕渲染也有扩展接口。网络层用 Retrofit 加 OkHttp，解析 JSON 用 kotlinx.serialization 或 Gson，这些几乎是现代安卓项目的标准配置。

当然，我没拿到源码逐行确认，这里说的是“常见技术栈”的逻辑推演。如果你真想去读代码，建议先从build.gradle和核心的播放器封装类入手，那里能看到项目最核心的依赖和播放逻辑。对初学者来说，理解播放器封装是理解整个 App 的金钥匙。

5.2 电视端适配的难点

做一个能看的电视 App，难点不在 UI 美观，而在系统碎片化。电视盒子的系统版本从 Android 5.1 到 Android 14 都有，厂商定制还各不相同，硬件解码能力更是天差地别。Blbl 要在这些设备上都能播放，需要对播放器做很多兼容性判断，这也是为什么作者几乎每个小版本都在修崩溃问题。相比手机 App，电视 App 的崩溃率天然更高，因为硬件下限更低，你得时刻想着“如果用户用的是一台 1GB 内存的老盒子怎么办”。

另一个难点是 B 站接口的反爬和鉴权。第三方客户端频繁调用接口，容易触发风控，导致返回错误甚至暂时封禁 IP。好的开源客户端都会增加请求频率控制、缓存策略和用户提示机制。Blbl 目前还没在这个方面做得特别激进，也算合理，毕竟太激进的绕风控方案反而会把项目置于灰色地带，明确不做反而更安全。

5.3 如何参与贡献或自行编译

开源项目最吸引人的地方就是可以自己动手。想参与 Blbl 的贡献，门槛并不高：先到 GitHub 仓库把 Issue 和 Update log 翻一遍，了解项目当前还缺什么，然后 fork 代码到本地，修改后提 Pull Request。不过我要吐槽一句，很多新手上来就想加“大功能”，结果东一榔头西一棒子反而维护不下去。更实际的贡献方式是从小 bug 入手，比如某个页面文案错别字、某个弹幕设置项没有记忆，或者提交一份更完善的英文 README，这些都是维护者欢迎的。

如果你不想参与开发，只是想自己编译一个版本，可以按 README 里的构建说明操作。常见流程是：克隆仓库用 Android Studio 打开，设置好本地 SDK 路径，等 Gradle 同步完，直接 Build APK。这里有个容易踩的坑：因为依赖源在国外的 Maven 仓库，国内网络环境下首次构建可能非常慢，甚至卡在下载依赖。解决办法是给 Gradle 配置阿里云镜像仓库，这个知识点在开源安卓圈已经算基操了。

6. 个人实测体会与几点建议

从 v0.1.16 用到 v0.1.18，我能明显感觉到 Blbl 在“把一件事做顺”上的进步。最初版本有几个页面还会出现焦点漂移，现在已经很少遇到；播放器的启动速度也快了不少，打开的瞬间不再有“加载中”卡太久的感觉。我目前在客厅用的是一个小米盒子 4K，安装的是 arm64-v8a 版本，平时下班后刷推荐位、追番剧、看视频课程，基本能做到拿遥控器就能完成，不用再掏出手机投屏。对于这种体验的提升，我的评价是：用了就回不去了。

最后给想入坑的朋友几个实在建议。第一，Blbl 目前还是手动安装更新的模式，每次升级前看一眼更新日志，别盲目追新，如果当前版本用着稳，完全可以多等几个版本再升。第二，遇到问题时先别急着发 Issue，把电视型号、安卓版本、APK 架构、复现步骤写清楚，这样的 Issue 才有价值，开发者也能快速定位，而不是看到一句“用不了”就头疼。第三，如果未来作者打算开放自定义主题或者插件能力，那这个项目的上限会更高，毕竟大屏刷视频这件事，本质上追求的就是“看着舒服、操作顺手、内容随叫随到”。

开源软件的魅力从来不只是免费或者无广告，而是你清楚知道它在做什么、能怎么改、踩坑后能找谁。Blbl 现在还年轻，但方向足够明确，对我这种既喜欢大屏体验又对隐私和控制权有执念的人来说，它已经是电视上不可或缺的一款应用。