Switch 手柄看B站wiliwili 跨平台B站客户端上手记【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwiliwiliwili 是一款为手柄玩家做的第三方 B 站客户端解决的是想在大屏上看 B 站却只能用键盘鼠标的尴尬。它在 Switch、PS Vita、PS4 和 PC 上都能跑复刻了官方 PC 端的核心体验。以下内容基于当前主分支的仓库信息整理。一、项目速览wiliwili 用 C17 编写界面由 nanovg 绘制窗口与输入走 GLFW 或 SDL2视频部分交给 mpv FFmpeg。UI 框架是 borealis 的自定义分支页面按 Activity / Fragment / Presenter / View 分层组织和你在 App 里看到的页一一对应。它复刻的不只是播放器首页有推荐、热门、直播、番剧、影视五个分区搜索页覆盖热搜、视频、番剧与影视播放页带弹幕和评论个人中心支持扫码登录、历史记录、收藏夹与追番追剧。接近官方 PC 端的浏览与播放体验深浅两套主题手柄、键盘、鼠标、触屏四种操控方式通吃播放页支持弹幕、评论、投币点赞收藏与倍速扫码登录同步个人数据追番追剧集中管理自定义字体、主题、Anime4K 滤镜等可调项丰富各平台能达到的上限差异不小选下载哪个包前先看这张表平台解码方式可玩上限Switch标准 OpenGL 版硬解4K30Switchdeko3d 编译版硬解4K60偶发崩溃PS Vita开硬解GXM 硬解720P 横屏 / 部分 1080P 直播原画PS4仅软解4K60 需开低画质解码PC硬解可切换老电脑秒开二、安装与首次配置以 Switch 为主流程其他平台在末尾一句话带过。准备工作运行大气层Atmosphere的 Switch固件与大气层保持最新SD 卡格式化为 FAT32这一步别跳过格式不对是闪退大户一台电脑用来拷贝文件能连上 WiFi 的主机应用依赖网络访问 B 站安装步骤到项目 releases 页下载wiliwili-NintendoSwitch.zip解压得到wiliwili.nro。把 nro 文件放进 SD 卡结构如下SD卡根目录/ └── switch/ └── wiliwili.nro回到主机按住 R 键点开任意游戏进入 hbmenu在列表里选择 wiliwili 启动。想省掉以后每次按 R 的麻烦可装桌面图标设置 实用工具 使用教程里操作图标会依次找switch/wiliwili.nro和switch/wiliwili/wiliwili.nro找不到就弹 hbmenu 让你选路径。⚠️ 装桌面图标属于自制软件范畴应用内明确提示过可能导致 ban 机请再次确认是否接受风险自己权衡。首次启动后建议按顺序做四件事进设置 实用工具 网络诊断确认访问网络测试通过、系统时间与网络时间一致——时间不对会导致签名类接口全部失败。扫码登录账号历史记录、收藏夹、追番追剧都依赖登录态。按网络情况定默认画质弱网下先选 720P 或 480P 保证流畅。到播放设置里定好弹幕密度与字号避免开看之后手忙脚乱。其他平台PC 直接装对应系统安装包Linux 与 Steam Deck 可在系统自带软件商店Discover、GNOME Software里搜wiliwiliPS Vita 装.vpk、PS4 装.pkg即可。三、核心功能实操3.1 首页浏览与内容搜索五个分区各有分工推荐是默认信息流热门分综合、每周必看、排行榜与播放历史几个入口直播按分区切番剧与影视则是竖图卡片加筛选器。路径主界面 番剧/影视 页签 筛选建议筛选器里综合排序 地区 年份 付费类型组合最常用找新番先看番剧页我的追番 / 正在热播比翻热门更快。3.2 播放页弹幕、评论与三连点开任意视频后弹幕、评论区、分集列表和 UP 主最新投稿都在同一页内投币、点赞、收藏与分享按钮齐全。路径播放中呼出 OSD 后播放设置 弹幕设置或播放设置 视频/字幕弹幕设置分三组过滤等级、滚动、顶屏、底屏、彩色、样式显示区域、透明度、速度、字号、行高、背景、性能渲染档位。建议电视上先看把显示区域调成上半屏避免字幕遮挡老机器把渲染档位调低一档弹幕再多也不卡。3.3 个人中心扫码登录与追番追剧登录入口在我的页手机 B 站 App 扫码确认后历史、收藏、追番追剧就都跟过来了。路径主界面 我的 历史记录 / 收藏夹 / 追番建议把常看的收藏夹用播放设置里针对单个番剧的自定义项专属画面比例、跳过前几秒配上追更时不用每次手动调。四、进阶玩法与调优4.1 隐藏快捷键与单手模式按设置 实用工具 使用教程 隐藏的快捷键说明可以调出完整按键表。底部常驻操作是Y 刷新、X 搜索、B 返回、A 确定。播放器内还有几组值得记的按键作用为什么值得用Y快进双击后锁定看熟片时反复快进不怕误退L R 方向单手操控播放器沙发上单手也能完整控制B显示/隐藏播放器 OSD看弹幕时让界面彻底消失X显示/隐藏弹幕讨论内容多时一键清净右摇杆显示/隐藏视频数据随时盯码率帧率排查卡顿4.2 画质、解码与平台取舍画质是播放设置里的手动档位未登录默认 360P登录后默认 1080P60往上还有 4K、8K 档能选到多少取决于账号权益与设备性能。Switch 标准版是 OpenGL 渲染上限 4K30想跑 4K60 换 deko3d 编译版代价是可能偶尔崩溃作者明说这是原生图形 API 的收益与风险并存。PS4 只有软解放 4K 前先开低画质解码否则帧率会很难看。弹幕渲染档位、均衡器亮度、对比度、饱和度、Gamma、色调都在播放设置里屏幕偏暗的房间把亮度和 Gamma 各提一档比调系统亮度更精准。4.3 换字体、上滤镜与 DLNA 投屏定制入口都指向同一个地方——配置目录设置 实用工具 其他 打开配置目录把字体文件改名为font.ttf、icon.ttf、danmaku.ttf放进去重启应用即可替换界面字体、按键图标和弹幕字体内置字体自动兜底。想要 Anime4K 观感参考 shader_helper 的配置格式写shader.json还能给指定番剧单独绑定一套滤镜配置。路径设置 实用工具 其他 DLNA 投屏搜索约 5 秒超时投到电视或投影仪上播放主机就能放下省的是电也省的是注意力。五、故障速查打不开 / 一直转圈内容加载不出来先确认大气层与系统固件都是最新版旧版自制系统是多数怪病的根源。打开设置 实用工具 网络诊断看系统时间 vs 网络时间是否一致不一致先改系统日期这是签名接口失败的头号原因。同页查看 IP 与 DNS如果动过自定义 DNS 或开过代理恢复默认网络设置后重测测试获取首页推荐。反馈问题前记得按仓库要求附一张网络诊断截图省得来回补材料。应用随机报错退出检查 SD 卡文件系统不是 FAT32 就重新格式化再拷回文件。升级大气层与固件到最新。仍复现的话记录复现路径哪个页面、什么操作再去报问题随机问题没有规律信息很难修。启动后长时间黑屏删掉 SD 卡里的config/wiliwili整个目录重进应用——本地缓存配置损坏时这是官方给的重置手段。删掉后仍黑屏回到上一条查固件与时间问题。4K 视频卡顿确认当前是 OpenGL 版 nro它的上限就是 4K30先降码率或换 1080P 验证是否流畅。确认无误后换 deko3d 版重试 4K60偶发崩溃是已知代价重要观看前想清楚要不要冒险。DLNA 投屏找不到设备确认主机和电视/投影在同一个网段跨路由器的设备基本不会被发现。确认对方开启了媒体服务器或渲染器功能。重新发起搜索并等满 5 秒超时再点一次刷新。更细的问题排查和项目 Wiki 入口在仓库主页的反馈问题前要做的事一节提问题前先翻一遍 Issues 列表大概率有人踩过同样的坑。六、项目资源与社区仓库主页与 releasesxfangfang/wiliwili各平台安装包都在这构建入口CMakeLists.txt桌面端编译命令直接写在 README 里平台编译脚本build_switch.sh、build_switch_deko3d.sh脚本说明见 scripts/README.md源码分层activity/ 全屏页、fragment/ 子页、presenter/ 异步数据层、view/ 可复用组件社区渠道使用技巧与 FAQ 集中在项目 Wiki应用内使用教程可直接跳转改进想法与创意先到 Discussions 讨论避免和别人的点子撞车源码里几个值得留意的目录多语言文案在 resources/i18n/界面布局 XML 在 resources/xml/B 站接口封装在 api/bilibili/。从掌机客厅到桌面wiliwili 把用 B 站的方式刷 B 站这件事做到了游戏机里而它真正的乐趣在于——你手里拿的是手柄。装好它、扫一次码剩下的时间就交给片单吧。⚠️ 使用请遵守 B 站服务条款与所在平台的使用规范在 Switch 等主机上运行自制固件与第三方应用存在一定风险账号与设备安全请自行把握。【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考