wiliwili 跨平台 B 站客户端指南：三步在游戏主机上搭好追番大屏
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
客厅里你刚打开电视准备追番，手机上的 B 站还要先跑完一段广告。其实你完全可以握着手柄，在 PS4 或 Switch 上直接用 wiliwili 打开 B 站——这个跨平台 B 站客户端从导航到弹幕全都围绕手柄设计，A/B 键就能刷完整页内容，不需要再掏手机。
它是什么，解决什么问题
wiliwili 是一款专为手柄用户打造的第三方 B 站客户端，覆盖 Nintendo Switch、PSVita、PS4、Xbox 以及 Windows / macOS / Linux 全平台。它把 B 站完整的浏览体验——推荐、搜索、直播、番剧、影视筛选、弹幕与评论——搬到了电视大屏和掌机上，交互逻辑完全复用游戏手柄习惯，零学习成本。
三种典型使用场景
- 客厅大屏追番：在 PS4 或 Switch 上连接电视，方向键在「推荐 / 热门 / 追番 / 影视」之间切换，A 键进入播放，弹幕和评论直接互动。
- 掌机碎片时间：PSVita 上安装 wiliwili，开启硬解后可流畅播放 720P 横屏和 480P 竖屏视频，通勤路上刷动态、看直播都不在话下。
- PC 日常浏览：Windows / macOS / Linux 版本同时支持鼠标（左键确认、右键返回、中键刷新）、键盘与手柄，适合多显示器环境。
三个值得留意的细节
手柄交互范式所有操作都与游戏一致：方向键导航、A 确认、B 返回、L1/R1 切页、Y 键呼出菜单。不需要记任何额外快捷键，拿起来就能用。
跨端一致体验同一套代码跑在全部平台上，界面布局与功能保持一致。Switch 上刷过的首页，回到 PC 打开视觉和交互几乎无差异，连深色/浅色主题都跟随系统自动切换。
播放链路底层使用 MPV + FFmpeg 进行解码渲染。Switch 支持 OpenGL（4K@30）与 deko3d（4K@60 硬解）两种后端；PS4 默认软解，可在设置中开启低画质解码应对 4K@60；PSVita 硬解后 720P 横屏流畅无压力。
上手指南
环境准备
- Switch：已安装大气层（Atmosphere）自制系统与 hbmenu，内存卡格式为 FAT32
- PSVita：已刷入自制固件（如 Henkaku）
- PS4：已安装调试菜单或自制系统
- PC：无特殊要求，直接安装对应系统安装包即可
获取文件
到项目 releases 页面下载对应平台的压缩包：Switch 为wiliwili-NintendoSwitch.zip，PSVita 为wiliwili-PSVita.vpk，PS4 为wiliwili-PS4.pkg，PC 为对应系统的安装包。如需从源码编译，仓库地址如下：
git clone https://gitcode.com/GitHub_Trending/wi/wiliwili分平台部署
- Switch：解压后将
wiliwili.nro放入内存卡switch/目录，通过 hbmenu 启动 - PSVita：用 VitaShell 安装
.vpk文件 - PS4：通过调试菜单安装
.pkg文件 - PC：运行下载的安装包完成安装
首次启动
启动后应用会自动完成初始化。Switch 用户若黑屏时间过长，可删除内存卡config/wiliwili目录后重新进入。更详细的编译与安装说明见 scripts/README.md。
手柄按键速查
| 按键 | 播放页 | 首页 / 列表页 |
|---|---|---|
| A | 播放 / 暂停、确认 | 进入内容 |
| B | 返回 / 退出 | 返回 |
| 方向键 | 菜单导航 | 列表导航 |
| L1 (LB) | 快退 | 上一个 Tab / 上一项 |
| R1 (RB) | 快进 | 下一个 Tab / 下一项 |
| X | 切换弹幕 | 刷新 / 影视筛选 |
| Y | 显示 / 隐藏 OSD | 打开搜索 |
| RT + ↑ / ↓ | 音量 +/- | — |
| Start | 画质切换 | 设置入口 |
| LT / RT | 播放列表上一项 / 下一项 | — |
画质与性能建议
- 默认画质：未登录时 B 站仅提供 360P，登录后默认 1080P60；PSVita GXM 版默认 720P，OpenGL 版默认 480P。进入播放页后可通过 Start 键随时切换。
- Switch 4K 播放：默认 OpenGL 版本最高 4K@30，追求 4K@60 请切换到 deko3d 版本（偶有崩溃风险）。
- 配置文件：所有设置保存在
config/wiliwili/wiliwili_config.json（各平台路径不同，详见 AGENTS.md），修改后重启应用生效。 - 网络诊断：若加载缓慢或报错，进入「设置 → 实用工具 → 网络诊断」查看 API 连通性与 DNS 状态。
常见问题
Q：Switch 上启动黑屏或视频加载缓慢？确认大气层与系统固件已更新到最新版，内存卡为 FAT32 格式。可删除config/wiliwili目录后重新进入，或在网络诊断中检查 DNS 是否正确。
Q：PSVita 上播放卡顿怎么解决？确保设置中已开启硬件解码（默认使用vita-copy硬解方案）。若仍卡顿，将画质从 720P 降至 480P 即可恢复流畅。
Q：如何切换手柄按键图标风格？进入「设置 → 其他 → 按键图标」，可选 Xbox / PS / 键盘三种风格，切换后立即生效，不影响按键实际映射。
写在最后
wiliwili 的源码按 Activity / Fragment / Presenter / View 分层组织，结构清晰，入口在 wiliwili/source/。如果你在使用中遇到 Bug 或有功能改进想法，欢迎到项目 Discussions 区参与讨论，一起把它打磨得更顺手。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
