BiliPai第三方客户端v0.2.2 安卓版

编辑点评：为纯净的景色干杯。

BiliPai是一款现代化的Bilibili第三方Android客户端，采用Jetpack Compose和Material Design 3构建，专注于提供纯粹、流畅且无广告的视频观看体验。其简洁的界面设计和高效的性能优化，确保用户在观看视频时能够享受到极致的流畅感。

BiliPai怎么注册，怎么登录？

1、点击右下角我的；

2、点击立即登录此软件；

3、在这里登录你的B站账号；

4、这样就可以顺利同步B站的信息了。

BiliPai怎么搜索？

1、点击上方搜索框

2、在这里输入想要搜索的内容

3、点击立即搜索

4、完成

BiliPai怎么看视频？

1、选择首页的视频；

2、点击进入；

3、这样就可以顺利播放视频内容了。

更新日志

v0.2.2 

[更改] 版本号 0.2.2(288)

[更改] 视频详情页的评论排序控件移至“评论”标签右侧

[修复] 视频详情分页切换时评论、播放器、指示器和小窗状态交接

[修复] 关联视频切换时隔离旧视频弹幕，避免弹幕串流

[修复] 全屏按钮进出时的播放器转场

[修复] 预测性返回过程中视频页面跟随手势收缩

[修复] 预测性返回过程中模糊与清晰度渐变中断

[更改] 设置页 Push/Pop 与预测返回过渡策略

[更改] 从首页、动态、我的等底栏页面进入设置根页时统一使用 Push/Pop 转场

[修复] 首页顶部栏反向滚动模式不生效

[修复] 首页顶部标签、底栏切换和阻尼拖动手势状态不同步

[更改] 首页顶部标签默认及最大数量均为 5 项

[更改] 首页 Dock 在图标、图标文字、文字三种模式下保持居中

[修复] 直播首页网游、手游等一级分区标签可正确切换

[修复] 直播分区接口中可点击区域 ID 解析错误

[修复] 直播父级分区加载和分区列表状态稳定性

[修复] 插件注册、开关切换并发时的闪退

[更改] 播放设置和应用图标偏好设置

[更改] 空间投稿视频网格排版对齐首页信息流

[更改] 长按倍速提示缩小尺寸并降低遮挡

[更改] App + Web 合并 Feed 使用正确的取流参数和翻页逻辑

[修复] App + Web 合并 Feed 内容重复及半边内容问题 @qyo123oyq（PR #714）

9.9.9.8.6

播放器方向与全屏

修复普通平板横屏最大化后错误进入竖屏全屏的问题。

平板横屏全屏始终保持横屏，不再因视频元数据或窗口尺寸误判方向。

仅在折叠屏完全展开的内屏上，自动全屏才会优先使用竖屏。

通过折叠屏实际展开状态判断设备姿态，不再单纯依赖屏幕宽度。

修复平板横竖屏切换时 LANDSCAPE / PORTRAIT 方向反复振荡的问题。

多窗口模式下不强制切换屏幕方向。

竖屏视频、横屏视频和播放设备方向分别处理，避免视频元数据影响平板全屏方向。

修复播放器重组时自动全屏逻辑重复触发，避免退出全屏后立即再次进入全屏。

自动全屏仅响应播放器真实状态事件，不再使用临时状态快照补发播放事件。

竖屏全屏和横屏全屏分别使用对应的弹幕配置。

修复进入、退出全屏时弹幕显示区域和弹幕设置档案串用的问题。

稳定播放器、系统栏、评论面板和共享元素转场之间的状态交接。

播放页沉浸状态栏

「播放页隐藏状态栏」调整为「播放页沉浸状态栏」。

开启后保留系统状态栏图标，不再直接隐藏状态栏。

使用视频当前画面生成顶部实时背景。

顶部背景支持模糊、渐变和黑色保护层，保证状态栏图标清晰可见。

支持 TextureView、SurfaceView 和普通播放器视图的画面采样。

SurfaceView 使用低分辨率 PixelCopy 获取环境帧，减少内存和渲染开销。

修复播放页顶部内容与系统状态栏重叠的问题。

修复详情页、内嵌播放器、全屏播放器和共享卡片转场之间顶部间距跳变的问题。

横屏评论与侧边面板

横屏全屏新增评论入口按钮。

新增交互式横屏评论侧边面板。

评论面板默认停靠右侧。

支持将评论面板切换至左侧。

面板打开时，播放器自动预留对应宽度，避免评论覆盖视频内容。

面板关闭时，视频视口平滑恢复。

支持跟手拖动、按拖动距离关闭和按滑动速度关闭。

支持拖动中途反向操作，不必等待上一次动画结束。

支持评论列表、评论排序、只看楼主、点赞、回复、删除、举报、置顶和时间戳跳转。

支持楼中楼详情、图片预览、表情和评论身份装饰。

面板关闭时自动关闭当前楼中楼状态。

横屏评论面板与播放器转场、输入框和系统返回逻辑接通。

横屏评论面板显示时，避免重复显示原有独立评论线程。

评论与楼中楼

修复评论分页因置顶评论、热评插入导致提前显示“加载结束”的问题。

修复二级评论分页将单页数量误判为总数量的问题。

综合接口返回的分页总数、根评论数量和远端数量判断分页结束状态。

修复楼中楼评论显示“还有更多”但实际无法继续加载的问题。

楼中楼预览默认收起，减少评论列表占用空间。

缩小评论用户身份装饰的布局占用，改善窄屏显示。

支持同时显示装饰图片和编号、舰队等文字标签。

装饰图片按原始尺寸请求，避免服务端缩放导致模糊。

自动裁剪装饰图片透明留白，修复图案过小、比例失真和空白过多的问题。

修复 NO. 编号文案的换行和展示格式。

根评论和二级评论统一使用相同的装饰渲染逻辑。

番剧播放

修复番剧播放器只有声音、没有画面的问题。

恢复普通番剧播放器与 PlayerView 的直接视频输出绑定。

Anime4K 接管视频输出时，避免与普通播放器 Surface 重复争抢。

播放器、媒体源或播放器状态变化后，自动保持视频输出绑定同步。

根据播放账号的大会员状态和设备能力请求番剧画质。

支持 HDR 番剧画质优先请求。

设备支持 HEVC 时优先使用 HEVC 视频流。

HDR、杜比视界等 HEVC 视频在支持设备上优先播放高规格轨道。

不支持 HDR 或 HEVC 时自动回退到 AVC 等可解码规格。

未登录、普通账号和大会员账号分别使用对应的默认画质档位。

首页视频卡片

首页视频卡片增加稳定的卡片背景和裁剪区域。

优化卡片圆角、封面和信息区之间的衔接。

标题独占完整宽度，不再被右侧更多按钮挤占。

标题最多显示两行并保持稳定省略。

更多操作按钮移动到卡片右下角。

取消收藏按钮移动到卡片右下角操作区域。

启用首页设置中的“封面统计信息紧凑布局”。

优化视频卡片滚动、共享转场和返回时的视觉稳定性。

减少卡片滚动过程中不必要的视觉采样和重组。

首页侧边栏与多账号

平板首页侧边导航栏新增「切换账号」按钮。

手机首页抽屉新增独立的「切换账号」入口。

账号切换入口复用「账号与播放」管理面板。

支持切换当前主账号。

支持设置或取消用于播放的大会员账号。

支持添加新账号。

支持移除非当前账号。

当前账号不能直接移除，必须先切换到其他账号。

切换账号后刷新首页推荐流、个人资料和账号会话。

新增「侧边栏账号切换」设置开关。

开关默认开启。

关闭开关后，同时隐藏首页抽屉和平板侧栏中的账号切换入口。

设置支持保存、读取和跨设备设置分享。

9.9.9.1

视频与播放器

修复进入视频后弹幕开关已开启却不加载的问题，无需再手动关闭再打开。

修复平板端自动播放视频切换全屏后进度回到开头的问题。

优化相关推荐卡片：三点菜单移至卡片右下区域。

“不想看该 UP 主”不再直接拉黑，改为让用户确认是否屏蔽。

优化视频卡片共享转场、模糊效果与背景表现，移除不必要的背景缩放。

补充发布版视频转场性能采样，并限制采样仅在前台运行。

稍后再看

新增正序、倒序排序。

修复 MIUIX 主题下顶栏标题显示不全。

优化卡片返回和视频转场时的交叉淡入淡出，减少与播放器重叠的观感问题。

UP 主页

从已播放视频进入 UP 主页后，可显示“刚刚看过”提示。

提示改为右下角轻量浮层，内容为“是否定位到视频投稿”。

确认后自动切换到视频投稿区、滚动至目标视频，并闪烁卡片定位。

动态、收藏夹与列表

修复转发动态首次有评论、再次打开评论丢失的问题。

收藏夹视频可直接打开，无需等待完整播放队列。

收藏夹上滑时不再回显收藏夹顶栏。

全局列表下滑时补充一键回顶入口。

MD3 动态取色会在更换壁纸后自动刷新。

性能与开发支持

新增发布版首页滚动性能采样脚本。

优化首页滚动采样输出。

调整视频转场性能采样策略。

9.9.8.5

导航 / 预测返回 / 设置壳层

设置页不透明底：设置页面用不透明底色，减轻叠色闪烁。

详情取消退出恢复：预测返回取消后恢复沉浸状态栏。

收藏 / 合集 UP 进空间：收藏与合集场景可进入 UP 主空间。

合集 shared key 归一化：合集详情与收藏列表使用 LIGHT_SIBLING_POP，减轻预测返回重叠。

追更 / 搜索过渡：完善追更入口与搜索相关导航过渡。

视频卡片一镜到底

相关推荐进场：相关推荐详情 → 详情路由层 NO_OP，并恢复列表来源 session，保证 shell morph。

相关推荐 / 分区：恢复整卡 shell 一镜到底（曾短暂改为封面位对称进退后已回退）。

返回过渡观感：完善视频卡返回时序与景深对齐。

分区景深匹配：内嵌分区来源可正确匹配首页景深背景。

竖屏直达刷视频

直达 + 卡片过渡：开启「竖屏视频直达刷视频」且开启卡片过渡时，走详情页 sharedBounds 逐渐放大，并以 directPortraitEntry 强制进入 standalone 全屏竖屏流（点赞 / 评论 / 发弹幕），避免停在内联竖屏详情页。

关闭卡片过渡：仍短路进入 Story 竖屏流。

UP 主名显示：全屏 overlay 优先使用已加载的 Success.info.owner，修复 seed 进场 @ 后空白。

设置 / 搜索 / 侧栏修复

MIUIX 隐私与存储弹窗：下载位置、图片保存位置、清除缓存在 MIUIX 主题下改用窗口 Dialog 承载（不再依赖未挂载的 OverlayDialog host），点击可正常打开设置弹窗。

视频详情标签跳转搜索：修复标签上长按复制手势吞掉单击的问题，点击标签可进入对应搜索结果。

搜索结果点 UP 名：补齐 onUpClick，可进入对应空间。

侧栏模糊：修复点头像打开侧栏时模糊效果延迟生效。

9.9.5

优化音乐播放器交互和体验

修复一些反馈的问题

v9.8.0 完整更新日志

发布日期： 2026-06-29

问题修复

设置页搜索跳转错位：点击「播放与画质」跳到「互动与评论」、点击「互动与评论」跳到「网络与画质」的问题已修复。四个设置区块的搜索聚焦索引按实际页面顺序重新映射，同步更新单元测试

首页顶部标签左侧间距：与右侧对齐，视觉更协调

评论区 HTML 实体反转义：评论区 &#39 等 HTML 实体现在正确显示为对应字符，同步补充 HtmlEntityUtils 边界用例测试

消息页面沉浸式适配：AdaptiveTopAppBar 补充 windowInsets = statusBars，顶栏背景延伸至状态栏背后

底部小白条沉浸：AdaptiveScaffold 默认 contentWindowInsets 改为 WindowInsets.navigationBars，内容区域正确避开底部导航栏

个人空间 Tab 居中：下划线模式下 Tab 行改为居中排列，不再左对齐

预测返回手势

退出方向跟随卡片位置：根据 cardSourceDirection 自动推导退出方向--卡片在左侧向右滑出，右侧向左滑出，居中/无卡片时跟随手势。共享元素动画处理器新增 exitDirection 构造参数，三种方向对应不同滑出/滑入偏移

动画平稳性优化：将 inPredictiveBackAnimation 状态写入从 Composition body 迁入 SideEffect，修复 PostExit 阶段画面抖动（涉及缩放动画、跨 Activity 动画、共享元素动画三条路径）

回首页导航改进：从子页面返回首页时改用 snap 落地而非 animateToPage，解决 HorizontalPager 惯性偏移导致落到错误页面的问题

BiliPaiNavDisplayHost 重构：过渡期间屏蔽输入（NavDisplayTransitionEffects(blockInputDuringTransition = true)），退出方向统一自动管理

AndroidX Navigation Event 适配

新增 navigationevent-compose 适配模块（5 个文件，424 行核心事件处理器、事件状态管理、调度器所有者组合记忆、局部提供、导航状态组合记忆），为后续导航事件驱动提供基础架构

首页横幅

共享元素过渡：HomeHeroCarouselCard 点击时记录位置到 CardPositionManager，封面图注册 sharedBounds（videoCoverSharedElementKey）。从视频详情预测返回时，退出动画朝向横幅卡片实际位置

统计信息补全：底部添加时长、播放量、弹幕数，各自独立注册 sharedBounds（新增 DURATION 共享元素枚举 + videoDurationSharedElementKey），跟随共享元素与预测返回做联动过渡

布局优化：改为 Column 两行布局，标题在上行不受压缩，统计信息在下行靠右排列，互不遮挡且不干扰左下角点状指示器

视频卡片统计联动

弹幕数的 HomeVideoBadgePill 补上 videoDanmakuSharedElementKey 的 sharedBounds。至此播放量、弹幕数、UP 主名、标题、封面等核心元素全部跟随共享元素过渡

首页刷新与导航

首页刷新指示器：Material 默认样式下不再对内容区施加额外 translationY 偏移，避免指示器与内容位移叠加导致的视觉错位

视频详情返回封面过渡：将返回时的视觉状态判断集中封装为 shouldUseReturningVideoDetailVisualState，封面过渡更一致

MainHostTabBackHandler：预测返回 commit 时序控制增强

9.1.2

超大图片预览崩溃修复：图片预览根据设备纹理上限和安全像素预算限制解码尺寸，避免超长图或超大图触发 Canvas: trying to draw too large bitmap 崩溃。

动态角标参与底栏折射：底栏液态玻璃指示器的隐藏采样层保留动态未读红点与数量，左右滑动经过“动态”时，角标会与图标和文字一起被放大、扭曲和折射。

热门页返回选中态修复：视频详情覆盖首页期间暂停 Pager 对分类状态的反向写入；返回首页后以 ViewModel 保存的分类重新对齐，避免从“热门”进入视频再退出时顶栏误跳到“关注”。

平板字幕可读性增强：字幕字号按播放器有效宽度适配

平板横屏设置滚动修复：设置页左侧分类栏改为独立滚动列表，右侧根设置、搜索结果和各子设置页获得明确的有限高度与独立滚动区域，修复平板横屏时无法下滑的问题。

9.0.3

提高软件稳定性，优化软件流畅度

9.0.0 

六一儿童节快乐；也提前祝高考学子高考顺利，落笔生花，奔赴热爱。

直播互动与横屏发送：补齐直播互动链路与横屏发送能力，直播观看中的输入、发送和横屏操作更完整。

评论输入体验增强：视频评论输入支持 @ 好友昵称搜索；动态评论楼层可自动展开，小站评论跳转修复，评论链路从输入到定位更顺。

空间动态转发与删除修复：转发动态改为按 Web 端 dyn_req JSON 协议提交，空间页、动态页和动态详情页共享的转发弹窗在失败后会恢复按钮与取消能力；个人空间动态会使用服务端返回的删除菜单参数提交删除请求，删除成功后从列表移除。

个人页动态交互修复：从动态侧边栏头像进入个人页后，动态卡片三点菜单可正常展开，支持复制链接与删除自己的动态；动态图片、图文图片点击后可沿用动态页图片预览的展开动画进入全屏预览。

底栏搜索入口修复：底栏搜索图标点击后直接进入搜索页，不再依赖底栏展开动画完成回调；搜索框展开且搜索词为空时，点击搜索框也会进入搜索页，已有输入内容时仍保留键盘搜索提交；正式版保留底栏搜索、搜索页入口和导航交接相关代码，避免压缩优化破坏点击链路。

追更合集与详情修复：修复追更合集入口与详情页相关问题，降低从合集入口进入内容时的断链风险。

首页顶部布局设置：新增首页顶部布局设置，扩展顶部折叠设置，首页顶部可按不同显示偏好调整；顶部标签固定为六项展示并补齐分页、默认展示和超六项回退策略。

顶部标签视觉与交互打磨：修正顶部标签垂直居中、MD3 顶部标签样式、安卓原生顶部标签指示器、热门子页签切换动效，以及顶部标签长按拖动与点击切换体验。

顶部标签液态玻璃与折射：顶部 dock 跟随 iOS26 底栏玻璃，补齐顶部标签液态玻璃 dock、内容折射采样预热、顶部/底栏指示器交互复用、折射避让和发行版分层，减少玻璃指示器错位、外溢和矩形捕获问题。

液态玻璃滑动形变优化：补齐胶囊速度形变、X/Y 双轴 scale 弹簧和点按落位四向回弹，形变速度改为弹簧过滤，保留 BiliPai 现有指示器放大倍数，减少左右滑动时的抖动和顿挫。

分区页重构与指示器复用：重构分区页样式，增强分区侧栏长按拖动和滑动手势处理，修复分区返回、侧栏指示器漂移、视频返回状态，并复用首页顶部与底栏指示器渲染。

首页返回与底栏收尾修复：修复首页视频返回时顶栏复位、底栏重复隐藏、底栏收尾和延迟恢复问题，让返回路径的顶部/底部镀铬状态更稳定。

离线下载与本地播放增强：增强离线下载与断点续传稳定性，修复离线播放器弹幕与进度条体验，离线播放链路更可靠。

番剧影视 API 完善：完善番剧影视 API 功能，扩展内容获取与页面承载能力。

CDN 稳播优选与手动检测：优化 CDN 区域优选、播放 fallback 和手动检测链路，提升弱网或区域节点不稳时的播放恢复能力。

空降助手统计与卡片修复：补齐空降助手洞察统计和卡片展示策略，修复相关卡片状态与 CDN 手动检测联动问题。

骨架屏同步呼吸光：首页与视频详情骨架屏改为统一节奏的同步呼吸光动画，首屏加载和详情加载占位更一致。

首页下拉刷新修复：MD3 下拉刷新按完整指示器和提示文字高度预留空间，内容下移更跟手，刷新指示器层级高于视频卡片，避免被视频遮挡；松手刷新后旧卡片先停留在原位置，等新内容插入后再回顶，减少刷新过程跳动。

顶部胶囊点击态修复：胶囊指示器场景关闭默认矩形水波纹，普通 MD3 下划线标签保留点击反馈，修复点按切换时胶囊周围出现矩形形状的问题。

低版本底栏闪退修复：移除底栏交互高光对 RuntimeShader 的直接引用，避免 Android 10 等低版本系统在解析高光 Modifier 时因缺少类而闪退。

开源致谢补全：设置页开源致谢按当前工程依赖、投屏/测试模块与明确参考实现补齐库名、许可和 GitHub 链接，并注明该列表可能不包含全部传递依赖或完整法律清单；列表样式跟随当前主题色。

版本与文档同步：版本号升级到 9.0.0 / versionCode 213，README、README_EN 和更新日志同步到 9.0.0。

8.1.3

播放手势修复：收敛播放器滑动/拖动判定和进度条手势策略，补充长按倍速、seek 手势与全屏覆盖层相关设置链路，降低横屏/播放器区域操作冲突。

底栏与首页手感：继续优化底栏指示器位移、液态拖拽阻尼和首页网格策略，降低滑动时的抖动、回弹错位和布局跳动。

收藏与合集稳定性：修正收藏夹、合集/系列详情和通用列表的本地状态映射与空数据处理，降低列表聚合、模式切换和详情初始化时的异常概率。

PR #316 空指针修复：合入 @chenx-dust 的初始化顺序修复，避免列表/合集 ViewModel 在父类 init 阶段访问尚未初始化的子类 Map 时触发 NullPointerException。

视频内互动提示隐藏：原“屏蔽关注/点赞弹幕”扩展为“隐藏视频内互动提示”，设置会同时隐藏关注、一键三连、UP 提示和投票等命令弹幕，并接入播放设置、视频详情弹幕面板、横屏/竖屏播放器覆盖层和设置分享。

v7.7.2 

版本信息

版本号从 7.7.1 升级到 7.7.2，versionCode 升级到 148。

本次为一版“动态页重写进行中 + 竖屏推荐去同质化 + 二级评论边看边刷 + 评论读取回退补强”的维护更新。

动态页重写进行中

动态页顶部分类扩展为“全部 / 投稿 / 番剧 / 专栏 / UP”，并补上对应的筛选策略，视频、番剧、图文和按用户查看的入口开始拆分。

动态流请求链路补充 type 透传，后续分类页可以按不同动态类型拉取数据，不再只能固定请求 all。

动态卡片与详情页开始改用更窄、更接近移动端信息流的布局，视频卡片统一回到纵向结构，顶部分类栏也改为可横向滚动。

动态卡片和详情页补上番剧卡片跳转能力，番剧动态现在可以直接落到番剧详情或播放目标，不再只能当普通动态处理。

动态模块目前仍在重写中，当前版本存在功能缺陷和不稳定情况；不同动态类型的展示、筛选、跳转、评论和交互在部分场景下仍可能异常，不建议把动态页当作稳定功能预期。

评论与二级楼中楼

手机视频详情里的二级评论不再一律强制全屏，打开后会优先占据播放器下方剩余区域，可以一边看视频一边刷楼中楼回复。

当页面上方没有预留播放器区域时，二级评论详情仍会保持全屏展示；有预留区域时会自动取消多余的状态栏顶边距，顶部不会再空一截。

评论读取链路补上“地理位置缺失时从 gRPC 回退到 REST”的判断，减少评论列表正文有了但位置信息丢失、显示不完整的问题。

修复IP归属地消失的问题

竖屏推荐流

竖屏连续上滑的优先选择首页推荐流，不再只沿着当前视频的相关推荐推送。

推荐候选继续打散，但现在会额外按标题归一化、封面、关键词重合、同 UP 和时长接近等特征过滤近重复内容，减少同题材、同内容、同模版视频连续出现。

继续滑到列表尾部时会优先补首页推荐，首页推荐不够时再拿当前视频相关推荐兜底，让推荐来源更分散。

7.5.0更新

空间页改成更稳定的首屏加载方式，进入页面时更容易直接看到完整内容。

修复空间页首次进入时偶尔显示“暂无视频”，刷新后才恢复的问题。

空间页界面重新设计，信息层级更清晰，关注按钮和用户信息的对齐也更稳定。

动态页新增“回到顶部”按钮，刷动态时回顶更方便。

竖屏全屏播放器改进了切换和退出时的表现，画面过渡更自然。

视频封面显示逻辑优化，减少返回详情页或手动起播时的黑屏和突兀切换。

7.2.1

优化视频评论区外观与筛选栏表现，补充统一的评论主题配色策略。

调整子回复与评论面板展示细节，改善视频详情评论交互体验。

修复高画质切换时的 codec 选择问题，避免切换后卡死或需要重进。

修复竖屏播放页弹幕顶部定位问题。

优化弹幕同步与视频加载请求策略

微调平板与全屏视频布局相关行为。

v7.1.0 (2026-03-22)

版本信息

版本号从 7.0.2 升级到 7.1.0，versionCode 升级到 123。

本次为“番剧播放器控制层对齐普通视频播放器 + 横屏顶部操作补齐”的功能更新版本。

番剧播放器与横屏控制

番剧播放器继续向普通视频播放器控制层靠拢，横屏与全屏场景现在复用更多共享 overlay 能力，整体交互更统一。

番剧横屏顶部的点赞、投币、分享入口已补齐为真实可用能力，不再出现按钮显示出来但点击无反应的情况。

番剧分享改为走番剧专用分享链接，分享标题会自动拼接番剧标题与当前剧集标题，信息更完整。

番剧横屏顶部不再显示点踩按钮，避免展示暂未完整支持的交互入口。

状态与交互反馈

番剧播放器会同步刷新当前剧集的点赞状态与投币状态，横屏顶部按钮和投币结果反馈会跟随真实状态更新。

番剧投币入口已接入投币弹窗与硬币余额查询，交互体验与普通视频播放器保持更接近的一致性。

修复评论区的一些问题

重要提醒

历史记录的“全部批量删除”功能当前存在问题，暂时不要使用“全部删除”。

在该问题修复前，如需清理历史记录，请改用单条删除或谨慎分批处理。