开源安卓电视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 盘大法。具体步骤非常固定将 APK 文件复制到 U 盘根目录建议重命名为简单的英文名比如blbl.apk避免电视自带文件管理器对中文文件名显示乱码。U 盘插入电视的 USB 接口等电视弹出检测通知。打开电视自带的“文件管理器”或“媒体中心”找到 U 盘里的 APK。点击安装这时候电视通常会弹“禁止安装未知来源应用”的确认框需要在设置里允许来自 U 盘的安装权限。这里提醒一句不同品牌的电视设置路径差很多索尼的通常在“应用安全”里小米电视在“账号与安全”里当贝盒子则在“通用设置”里。如果你找不到最快的办法是直接装一个当贝市场之类的中转应用再从当贝市场里打开本地安装功能。但从安全角度讲能不装额外商店就不装给电视留一个干净环境对长期体验很重要。2.3 ADB远程安装进阶如果你手头没有 U 盘或者电视上的文件管理器压根不识别 APKADB 远程安装是更稳妥的方案。所谓 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 快速排查表现象可能原因处理方式扫码后电视无反应电视网络异常 / token 过期检查网络重启应用重新扫码播放黑屏但有声音解码器不兼容切换解码模式或降低清晰度视频一直缓冲网络差 / DNS 异常换 5G 频段 / 检查路由设置搜索框无法输入输入法冲突切换回系统自带输入法应用频繁闪退安装包架构不符下载对应 CPU 架构的 APK弹幕掉帧弹幕密度过高降低弹幕密度或关闭弹幕这些排查经验不只是 Blbl 通用其他 Android TV 应用碰到类似问题用同样思路也能解决大半。开源项目的用户本来就需要一点折腾精神摸清规律之后反而觉得挺有乐趣。5. 给开发者与折腾党的技术观察5.1 开源项目的常见技术选型如果你不只是想用还想看看代码Blbl 这类项目通常不会用太冷门的框架。基于我对多个安卓电视开源客户端的观察合理的推测是它可能选用 Jetpack Compose for TV 或者传统 Leanback 库来做界面因为这两者是 Android TV 官方推荐方案对遥控器焦点处理比较成熟播放器部分大概率是 Media3ExoPlayer 的继任者因为它硬解软解切换成熟、弹幕渲染也有扩展接口。网络层用 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 现在还年轻但方向足够明确对我这种既喜欢大屏体验又对隐私和控制权有执念的人来说它已经是电视上不可或缺的一款应用。