wiliwili 完整指南：游戏主机 B站客户端，从 Switch 追番到 PS4 直播
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili 是一款专为手柄设计的第三方 B站 客户端，常被称作游戏主机 B站客户端，运行在 PC 全平台、Nintendo Switch、PSVita、PS4 与 Xbox 上。下面按"先装好、再会用"的思路，讲清各平台版本选择、Switch NRO 部署、手柄按键逻辑与常见故障排查。
功能速览：追番、直播、弹幕一次覆盖
wiliwili 的页面结构接近官方 PC 客户端，核心能力如下：
- 追番与影视：番剧、电影、纪录片、综艺的分集播放，详情页含评分与剧集列表
- 直播：关注主播与系统推荐直播间，支持直播内弹幕
- 弹幕：实时发送，颜色、大小、透明度、位置、滚动速度均可设置
- 动态：关注 UP 主的最新视频更新
- 搜索与筛选：热搜、视频/番剧/影视搜索；影视支持地区、年份、风格、付费类型等维度筛选
- 个人中心：扫码登录、观看历史、收藏夹、我的追番
- 互动：点赞、投币、收藏，评论浏览
与官方 PC 客户端的差异主要在运行环境：
| 官方 PC 客户端 | wiliwili | |
|---|---|---|
| 平台 | Windows / macOS / Linux 桌面 | 桌面 + Switch、PS4、PSVita、Xbox |
wiliwili 安装教程：Switch NRO 步骤与各平台版本选择
Switch 版 NRO 安装步骤
- 获取 wiliwili.nro：从项目 Releases 页面下载
wiliwili-NintendoSwitch.zip解压即可；也可以自行编译，克隆仓库后运行构建脚本：
git clone https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili ./scripts/build_switch.sh该脚本（位于 scripts/）基于 Docker 自动安装依赖并完成编译，产物为wiliwili.nro。
- 把
wiliwili.nro复制到内存卡switch/目录下。 - 在主界面按住 R 键打开任意游戏进入 hbmenu，在列表中选择 wiliwili 启动。
- 可选：在应用内"设置/实用工具/使用教程"入口安装桌面图标。图标会依次尝试
switch/wiliwili.nro与switch/wiliwili/wiliwili.nro，两处都不存在时回退到 hbmenu 手动选择路径。
各平台版本差异与选择建议
- Switch：Releases 默认提供 OpenGL 版，最高 4K@30，稳定性好；deko3d 版走原生图形 API，可播放 4K@60，但可能偶尔崩溃。求稳选 OpenGL，追求帧率选 deko3d。
- PS4：下载
wiliwili-PS4.pkg安装。仅支持软解码，想播放 4K@60 需在设置中开启低画质解码。 - PSVita：下载
wiliwili-PSVita.vpk安装。开启硬解后可流畅播放 720P 横屏、480P 竖屏视频，以及部分直播 1080P 原画。 - PC：覆盖 Windows 7 及以上、macOS 10.11 及以上与主流 Linux 发行版，支持硬件解码切换，老电脑也能流畅使用；Linux 与 Steam Deck 用户可直接在系统软件中心（Discover、GNOME Software 等）搜索
wiliwili安装。 - Xbox：项目同样覆盖该平台，安装包见 Releases 页面。
观看与互动：播放控制、弹幕与直播
播放页支持 0.5x–2.0x 倍速、拖拽进度条、分集与章节跳转；点赞、投币、收藏集中在播放控制区，一次按键完成。弹幕可实时发送，颜色、大小、透明度、显示位置与滚动速度在弹幕设置页逐项调整。
影视详情页展示影片信息、评分与剧集列表，进入剧集后按 1080P 等清晰度播放，右侧面板可展开选集。
直播页分为"关注"与"推荐"两部分，进入直播间后，弹幕接收与发送、评论区交互和视频页一致。个人页面集中了观看历史、追番追剧与收藏，扫码登录也在这里完成。
手柄按键对照与个性化设置
日常操作基本全部由手柄完成，常用按键对照如下：
| 按键 | 动作 |
|---|---|
| A | 确认 / 播放 |
| B | 返回 |
| X / Y | 调出菜单 |
| L / R | 切换标签页 |
| 十字键 / 摇杆 | 选择项目 |
| 重压左摇杆 | 临时快进 |
| 重压右摇杆 | 临时快退 |
个性化项集中在设置页：
- 单手模式：用一只手柄控制播放器
- 主题：深色 / 浅色两套，可跟随系统自动切换
- 按键图标：在 Xbox、PS、键盘三种图标风格间切换
- 字体：在配置目录放入
font.ttf、icon.ttf、danmaku.ttf等文件即可替换内置字体 - 多语言：应用内切换简中、繁中、英、日、韩等语言
- PC 附加：支持鼠标操控（左键确认、右键返回、中键刷新）与键盘快捷键重绑定
进阶优化与常见故障排查
优化类设置主要有三项：通过shader.json配置 Anime4K 等后处理提升观感；在硬件解码与软件解码之间切换适配不同机型；配置代理与 DNS，并用"设置/实用工具/网络诊断"检查 API 连通性、DNS 与系统时间差。
高频问题按"问题 → 排查步骤"整理：
启动失败或长时间黑屏（Switch）
- 确认大气层与系统固件已更新到最新，内存卡为 FAT32
- 删除内存卡
config/wiliwili目录后重新进入
视频加载缓慢或卡顿
- 把清晰度降到 720P 再试
- PS4 用户在设置中开启低画质解码
- 尽量使用有线网络
登录失败或网络报错
- 运行"设置/实用工具/网络诊断"查看 API 连通性与 DNS
- 确认系统时间正确；若使用网络代理，先关闭再复测
桌面图标无法启动
- 检查 nro 是否位于
switch/wiliwili.nro或switch/wiliwili/wiliwili.nro
写在最后
wiliwili 把追番、直播、弹幕这些 B站 日常装进了一只手柄：Switch 上装好 NRO，PSVita 上装好 VPK，剩下的时间可以交给沙发和电视。项目保持开源迭代，构建脚本与平台差异可参见 scripts/ 与 docs/。
请遵守 B站 用户协议，尊重创作者版权。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
