3 步把 B 站装进游戏机:wiliwili 跨平台客户端上手指南
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
如果你想在 Switch、PSVita 或 PS4 上刷 B 站,wiliwili 是一个可以直接装进游戏机的第三方 B 站客户端。它是 C++ 编写的开源项目,界面用 nanovg 绘制,播放层基于 MPV 加 FFmpeg,同时支持手柄、触屏、鼠标与键盘。功能覆盖首页推荐、搜索、动态、直播、番剧与影视播放、弹幕评论、扫码登录,体验接近 PC 网页端。下文按安装、核心用法、按键速查与常见问题展开。
🎯 一、wiliwili 是什么
官方客户端覆盖不到游戏机,wiliwili 做的事情是把"浏览—搜索—播放—互动"这条完整链路搬过去:热搜榜单、动态关注、直播列表、弹幕与评论全都可用,且交互全部按手柄逻辑设计,A 确认、B 返回、方向键移动光标,全程不需要鼠标。
适合三类人:想在 Switch 上追番的、想在大屏加手柄环境下看直播的、以及在电脑上也想用控制器操作 B 站的。深浅两色主题跟随系统切换,界面支持简繁中、日、韩、英等语言。
上:wiliwili 的主界面,四象限布局在 PC 与掌机上通用
🚀 二、从 0 到 1 跑起来
Nintendo Switch
- 下载
wiliwili-NintendoSwitch.zip并解压。 - 将
wiliwili.nro放入内存卡的switch目录。 - 在主页按住 R 键,从任意游戏进入 hbmenu。
- 选中 wiliwili,按 A 启动。
- (可选)在应用内"设置/实用工具/使用教程"安装桌面图标。
上:在 hbmenu 列表里选中 wiliwili,按 A 启动
上:桌面图标装好后的效果,之后可直接从主页启动
PSVita
- 下载
wiliwili-PSVita.vpk。 - 在 PSVita 上安装并启动。
- 进入播放设置,开启硬件解码。
- 之后 720P 横屏视频可流畅播放,部分直播房间能到 1080P 原画。
PS4
- 下载
wiliwili-PS4.pkg安装。 - 该版本只有软件解码,播 4K@60 需在设置中开启低画质解码。
PC(Windows / macOS / Linux)
- 下载对应系统的安装包运行。
- Linux 与 Steam Deck 用户可直接在系统软件商店(Discover、GNOME Software)里搜 wiliwili 安装。
- PC 版可切换硬件解码开关,鼠标左键点击、右键返回、中键刷新。
常见坑:Switch 端要确保大气层与固件为最新、内存卡为 FAT32;各平台系统时间必须准确,否则接口签名与证书校验都会失败。
🎬 三、核心功能走一遍
追一部番剧
从首页"追番"页签或搜索页进入番剧详情,播放页会带分集列表、弹幕与评论区,点赞、投币、收藏都在播放页底部完成。提示:未登录状态下默认只能拿到较低清晰度,扫码登录后才解锁更高档位。
挑一部影视
搜索页和首页影视页签都支持筛选:地区、风格、年代、类型、付费类型这些维度组合起来,基本能把目标影片缩到两三行以内。
上:影视详情、筛选页与选集播放页
看视频:弹幕、评论与三连
从首页热搜或搜索直接进播放页,弹幕可开关、可调密度,评论区支持图片与表情包。PC 端还能切换按键图标样式(Xbox / PS / 键盘),让屏幕上的操作提示和手里的控制器对得上。
上:左上为热搜榜,左下为带评论的播放页
直播与个人中心
直播页分"关注"与"推荐"两组,进入房间后弹幕通过 WebSocket 推送。扫码登录后,历史记录、个人收藏、我的追番与追剧进度会同步到个人中心。
上:左侧为个人中心,中间为直播列表,右侧为直播间与弹幕
🕹️ 四、交互与操作速查
| 动作 | 手柄 | 鼠标(PC) |
|---|---|---|
| 确认 / 播放暂停 | A | 左键 |
| 返回上一页 | B | 右键 |
| 刷新当前页 | — | 中键 |
| 列表与页签导航 | 方向键 | 移动光标 |
进阶操作两条:长按视频区域可以加速播放;重压摇杆可临时快进。设置里的"单手模式"开启后,用一个手柄就能完成播放器全部操作。
🔧 五、调优与避坑
- Switch 启动黑屏时间过长→ 配置目录损坏 → 删除内存卡中的
config/wiliwili目录后重新进入。 - 视频打不开或登录失败→ 系统时间不准导致签名与证书校验失败 → 校准系统时间;仍不行就先跑"设置/实用工具/网络诊断"确认 DNS 配置,并暂时关闭网络代理再试。
- Switch 播 4K 卡→ 默认 OpenGL 版本上限是 4K@30 → 换 deko3d 版本(偶有崩溃);PS4 只有软解,4K@60 需开低画质解码。
- .nro 无法启动→ 内存卡不是 FAT32 → 重新格式化为 FAT32。
- PSVita 播 1080P 卡→ 未开硬解 → 开启硬件解码,以 720P 横屏为稳定档位。
📁 六、项目内部一览
wiliwili/include/activity/:顶层全屏页面层,首页、播放、搜索、设置各占一个 Activity。wiliwili/include/api/bilibili/:B 站接口的请求封装与结果结构体,页面层不直接发请求。
页面布局由resources/xml/下的 XML 文件驱动,翻译文件在resources/i18n/,想改界面先从这两处入手。
🤝 七、参与与获取
- 各平台安装包在项目 Releases 页下载;Linux 与 Steam Deck 也可以走系统软件商店。
- 自行编译:
git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili - 新 PR 提交到 dev 分支;做新功能前先提 issue 讨论,避免和别人撞车。
- 翻译贡献走 Crowdin 的 wiliwili 项目。
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考