wiliwili:手柄 B 站客户端完整指南,Switch 追番与 PSVita 直播一次配齐
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili 是面向手柄用户的第三方 B 站客户端,运行在 Switch、PSVita、PS4 与 PC 全平台,复刻官方 PC 端的浏览、播放与追番体验,支持手柄、鼠标、键盘、触屏四种操控,即装即用。
🧭 定位:谁需要游戏机 B 站客户端
wiliwili 只解决一个问题:怎么用游戏机手柄看 B 站,目标用户是想在电视或掌机上刷 B 站的人。
| 你 | 现有方案 | wiliwili |
|---|---|---|
| 有官方 B 站 PC 客户端,想在电视上玩游戏机版 | 官方没有游戏机版本 | 跑在 Nintendo Switch、PSVita、PS4 上,手柄是第一输入 |
| 在用电视盒子类 B 站客户端 | 大多没有弹幕或功能不全 | 统一播放页,弹幕、评论、点赞投币收藏齐全 |
| 想跨设备衔接观看进度 | 盒子客户端没有账号体系 | 扫码登录后,历史、收藏、追番追剧跨设备衔接 |
| 电视上看,掌机想干别的 | 需要另找投屏应用 | 内置 DLNA 投屏,把播放推到局域网设备 |
深浅两色主题跟随系统自动切换,应用内语言支持简、繁、日、韩、英等 7 种。源码分层也清晰:整屏页面在 wiliwili/include/activity/,B 站数据请求在 wiliwili/include/api/bilibili/,可复用控件在 wiliwili/include/view/。
📦 首次体验:各平台安装速查
从项目 release 页拿对应平台的包,装完即可开机。
| 平台或系统 | 下载包或命令 | 前置条件 | 一句话坑 |
|---|---|---|---|
| Nintendo Switch | wiliwili-NintendoSwitch.zip | 大气层与系统固件更新到最新,内存卡 FAT32 | wiliwili.nro放内存卡switch目录,默认 OpenGL 版最高 4K@30 |
| PSVita | wiliwili-PSVita.vpk | 主机可直接安装 | 不开硬解 720P 会卡 |
| PS4 | wiliwili-PS4.pkg | USB 拷贝安装 | 只有软解,4K@60 要开「低画质解码」 |
| Windows / macOS | 对应系统安装包 | Windows 7+、macOS 10.11+ | 鼠标左键确认、右键返回、中键刷新 |
| Linux / Steam Deck | 软件商店搜wiliwili | 无 | 无 |
Switch 装完可在「设置 / 实用工具 / 使用教程」里安装桌面图标。图标会依次尝试switch/wiliwili.nro和switch/wiliwili/wiliwili.nro,两个位置都没有就打开 hbmenu 让你自选路径,放错目录也能自救。
🎬 功能巡礼:追番、直播、播放的日常 6 个场景
按你想做的事组织,共 6 张场景卡。
首页信息流:一屏找齐今天要看的内容
- 目标:把当天要追的内容一屏找齐
- 路径:首页 → 直播 / 推荐 / 热门 / 追番四 tab → UP 主动态页
- 效果:热门榜与关注动态同屏并排,UP 主动态单独成页,分全部视频与全部动态
- ⚠️ 坑:列表页误触 B 容易退出去,打开设置里的「首页返回退出保护」
搜索与筛选:一步定位想看的影视
- 目标:精确找到想看的影视
- 路径:顶部搜索 → 热搜 / 视频 / 番剧 / 影视四 tab → 影视筛选(地区、风格、年代、付费类型)→ 详情页
- 效果:热搜、视频、番剧、影视四类分 tab 呈现,筛选支持地区、风格、年代、付费类型,不用翻第二屏
- ⚠️ 坑:搜索页暂不支持搜索用户,找 UP 主只能搜关键词
追番:从详情页到自动连播分集
- 目标:把今天的番一次性追完
- 路径:首页 → 追番 tab → 番剧详情(评分、简介、分集列表)→ 播放分集 → 自动播放分集
- 效果:打开「自动播放分集」「自动播放推荐」后一集接一集不用手动点,播放页还展示合集与 UP 主最新投稿
- ⚠️ 坑:未登录默认只给 360P,登录 B 站账号才能解锁更高画质
看直播:关注主播与弹幕调整
- 目标:关注的主播开播不落空
- 路径:首页 → 直播 tab(关注主播 + 系统推荐)→ 直播间 → 侧边栏调弹幕
- 效果:部分直播间能直接看 1080P 原画(PSVita 硬解下),弹幕数量可调或整体隐藏
- ⚠️ 坑:弹幕走 WebSocket 实时通道,断网时弹幕先停,画面可能还停在缓冲
播放视频:弹幕、评论与三连
- 目标:带着弹幕和评论完整看完
- 路径:任意类型(视频、番剧、电影、纪录片、综艺)→ 同一播放页 → 切倍速 / 调弹幕 / 看评论 → 点赞投币收藏
- 效果:暂停后再进入自动记回原进度,评论支持图片与大表情,弹幕密度在弹幕设置里调,重压摇杆临时快进
- ⚠️ 坑:评论「跳转进度」还在开发中,别指望点评论直达对应时间点
DLNA 投屏:把播放推到局域网设备
- 目标:电视上看,掌机干别的
- 路径:设置 → 实用工具 → DLNA 投屏 → 选局域网设备 → 发起投屏
- 效果:把 wiliwili 的播放内容推到电视或机顶盒,掌机继续干别的
- ⚠️ 坑:收发双方必须同一局域网且接收端支持 DLNA,搜不到设备先查路由器隔离设置
⚖️ 取舍:画质与帧率怎么取舍
掌机先保帧率再谈分辨率:PSVita 不开硬解别指望 720P 流畅,PS4 的 4K@60 是用画质换的。
| 项目 | 默认行为 | 推荐设置 | 说明 |
|---|---|---|---|
| Switch 画质 | OpenGL 版 4K@30 | 换 deko3d 版上 4K@60 | deko3d 走原生图形 API,可能偶尔崩溃 |
| PSVita 解码 | 软解,720P 会卡 | 设置里开硬解 | 720P 横屏、480P 竖屏流畅,部分直播 1080P 原画 |
| PS4 解码 | 软解,画质受限 | 开「低画质解码」 | 以画质换帧率,可上 4K@60 |
| PC 解码 | 硬件解码 auto-safe | 老电脑切软解 | 秒开流畅 |
| 播放画质 | 未登录 360P | 登录 B 站账号 | 登录后解锁更高画质 |
结论:掌机选帧率——PSVita 开硬解、Switch 换 deko3d;电视端选清晰度——PS4 开低画质解码,PC 用 auto-safe 即可,取舍只看你在哪看。
🧯 自查:黑屏、卡顿与断网速查
大部分问题靠三步自查能解决:清缓存、对齐解码方式、核对网络时间。
配置与缓存集中在一个目录(Switch 上是内存卡config/wiliwili),删掉它重新进入是排查第一动作。
| 症状 | 可能原因 | 动作 |
|---|---|---|
| 启动后长时间黑屏 | 缓存损坏或占满 | 删config/wiliwili目录重新进入 |
| 播放卡顿、掉帧 | 解码方式没对上平台 | 按取舍表切换:Switch 4K@60 换 deko3d,PSVita 开硬解,PS4 开低画质解码 |
| 视频打不开、弹幕不显示 | 系统时间不对、DNS 错误、代理未关 | 先改时间、查 DNS、关代理重测 |
| Switch 黑屏无响应 | 大气层或系统固件过旧 | 两者都更新到最新,确认内存卡是 FAT32 |
反馈前先到「设置 / 实用工具 / 网络诊断」生成诊断截图(能看到 API 连通性、时间差、DNS、IP),连同可复现步骤一起提交,问题定位会快很多。
🚀 延伸:贡献与反馈去哪提
贡献分代码、翻译、反馈三条路,各有固定入口。
- 代码:新功能先开一个 issue 讨论避免撞车,改动以 PR 形式提交,PR 一律提向
dev分支(yoga分支是已发布的最新代码);需要 clone 时用git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili - 翻译:添加语言或订正现有译文走 Crowdin 平台
- 反馈:按上表自查后仍解决不了,提交到项目 Issues / Discussions,附网络诊断截图与复现步骤
路线图已排上长按一键三连、评论跳转进度与互动视频,搜索用户也在计划中。更多使用技巧见项目 WIKI,安装包在 release 页,各平台构建脚本在仓库scripts/目录。
想上手就去 release 页拿对应平台的包装起来,想参与就把代码 PR 提向dev分支、翻译提给 Crowdin、反馈附诊断截图提 Issues。wiliwili 的起点,就是你手里那只手柄。
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考