企业官网建设流程全解析

Switch 手柄看B站：wiliwili 跨平台B站客户端上手记

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili

wiliwili 是一款为手柄玩家做的第三方 B 站客户端，解决的是"想在大屏上看 B 站却只能用键盘鼠标"的尴尬。它在 Switch、PS Vita、PS4 和 PC 上都能跑，复刻了官方 PC 端的核心体验。以下内容基于当前主分支的仓库信息整理。

一、项目速览

wiliwili 用 C++17 编写，界面由 nanovg 绘制，窗口与输入走 GLFW 或 SDL2，视频部分交给 mpv + FFmpeg。UI 框架是 borealis 的自定义分支，页面按 Activity / Fragment / Presenter / View 分层组织，和你在 App 里看到的"页"一一对应。

它复刻的不只是播放器：首页有推荐、热门、直播、番剧、影视五个分区，搜索页覆盖热搜、视频、番剧与影视，播放页带弹幕和评论，个人中心支持扫码登录、历史记录、收藏夹与追番追剧。

• 接近官方 PC 端的浏览与播放体验，深浅两套主题
• 手柄、键盘、鼠标、触屏四种操控方式通吃
• 播放页支持弹幕、评论、投币点赞收藏与倍速
• 扫码登录同步个人数据，追番追剧集中管理
• 自定义字体、主题、Anime4K 滤镜等可调项丰富

各平台能达到的上限差异不小，选下载哪个包前先看这张表：

二、安装与首次配置

以 Switch 为主流程，其他平台在末尾一句话带过。准备工作：

• 运行大气层（Atmosphere）的 Switch，固件与大气层保持最新
• SD 卡格式化为 FAT32，这一步别跳过，格式不对是闪退大户
• 一台电脑，用来拷贝文件
• 能连上 WiFi 的主机，应用依赖网络访问 B 站

安装步骤：

1. 到项目 releases 页下载wiliwili-NintendoSwitch.zip，解压得到wiliwili.nro。
2. 把 nro 文件放进 SD 卡，结构如下：

SD卡根目录/ └── switch/ └── wiliwili.nro

3. 回到主机，按住 R 键点开任意游戏进入 hbmenu，在列表里选择 wiliwili 启动。
4. 想省掉以后每次按 R 的麻烦，可装桌面图标：设置 > 实用工具 > 使用教程里操作；图标会依次找switch/wiliwili.nro和switch/wiliwili/wiliwili.nro，找不到就弹 hbmenu 让你选路径。

⚠️ 装桌面图标属于自制软件范畴，应用内明确提示过"可能导致 ban 机，请再次确认"，是否接受风险自己权衡。

首次启动后建议按顺序做四件事：

1. 进设置 > 实用工具 > 网络诊断，确认"访问网络"测试通过、系统时间与网络时间一致——时间不对会导致签名类接口全部失败。
2. 扫码登录账号，历史记录、收藏夹、追番追剧都依赖登录态。
3. 按网络情况定默认画质，弱网下先选 720P 或 480P 保证流畅。
4. 到播放设置里定好弹幕密度与字号，避免开看之后手忙脚乱。

其他平台：PC 直接装对应系统安装包；Linux 与 Steam Deck 可在系统自带软件商店（Discover、GNOME Software）里搜wiliwili；PS Vita 装.vpk、PS4 装.pkg即可。

三、核心功能实操

3.1 首页浏览与内容搜索

五个分区各有分工：推荐是默认信息流，热门分综合、每周必看、排行榜与播放历史几个入口，直播按分区切，番剧与影视则是竖图卡片加筛选器。

• 路径：主界面 > 番剧/影视 页签 > 筛选
• 建议：筛选器里"综合排序 + 地区 + 年份 + 付费类型"组合最常用；找新番先看番剧页"我的追番 / 正在热播"，比翻热门更快。

3.2 播放页：弹幕、评论与三连

点开任意视频后，弹幕、评论区、分集列表和 UP 主最新投稿都在同一页内，投币、点赞、收藏与分享按钮齐全。

• 路径：播放中呼出 OSD 后播放设置 > 弹幕设置或播放设置 > 视频/字幕
• 弹幕设置分三组：过滤（等级、滚动、顶屏、底屏、彩色）、样式（显示区域、透明度、速度、字号、行高、背景）、性能（渲染档位）。
• 建议：电视上先看把"显示区域"调成上半屏，避免字幕遮挡；老机器把渲染档位调低一档，弹幕再多也不卡。

3.3 个人中心：扫码登录与追番追剧

登录入口在"我的"页，手机 B 站 App 扫码确认后，历史、收藏、追番追剧就都跟过来了。

• 路径：主界面 > 我的 > 历史记录 / 收藏夹 / 追番
• 建议：把常看的收藏夹用播放设置里针对单个番剧的自定义项（专属画面比例、跳过前几秒）配上，追更时不用每次手动调。

四、进阶玩法与调优

4.1 隐藏快捷键与单手模式

按设置 > 实用工具 > 使用教程 > 隐藏的快捷键说明可以调出完整按键表。底部常驻操作是：Y 刷新、X 搜索、B 返回、A 确定。播放器内还有几组值得记的：

4.2 画质、解码与平台取舍

画质是播放设置里的手动档位，未登录默认 360P，登录后默认 1080P60，往上还有 4K、8K 档，能选到多少取决于账号权益与设备性能。

• Switch 标准版是 OpenGL 渲染，上限 4K@30；想跑 4K@60 换 deko3d 编译版，代价是"可能偶尔崩溃"，作者明说这是原生图形 API 的收益与风险并存。
• PS4 只有软解，放 4K 前先开"低画质解码"，否则帧率会很难看。
• 弹幕渲染档位、均衡器（亮度、对比度、饱和度、Gamma、色调）都在播放设置里，屏幕偏暗的房间把亮度和 Gamma 各提一档，比调系统亮度更精准。

4.3 换字体、上滤镜与 DLNA 投屏

定制入口都指向同一个地方——配置目录（设置 > 实用工具 > 其他 > 打开配置目录）：

• 把字体文件改名为font.ttf、icon.ttf、danmaku.ttf放进去，重启应用即可替换界面字体、按键图标和弹幕字体，内置字体自动兜底。
• 想要 Anime4K 观感，参考 shader_helper 的配置格式写shader.json，还能给指定番剧单独绑定一套滤镜配置。
• 路径：设置 > 实用工具 > 其他 > DLNA 投屏，搜索约 5 秒超时；投到电视或投影仪上播放，主机就能放下，省的是电也省的是注意力。

五、故障速查

打不开 / 一直转圈，内容加载不出来

1. 先确认大气层与系统固件都是最新版，旧版自制系统是多数怪病的根源。
2. 打开设置 > 实用工具 > 网络诊断，看"系统时间 vs 网络时间"是否一致；不一致先改系统日期，这是签名接口失败的头号原因。
3. 同页查看 IP 与 DNS；如果动过自定义 DNS 或开过代理，恢复默认网络设置后重测"测试获取首页推荐"。
4. 反馈问题前记得按仓库要求附一张网络诊断截图，省得来回补材料。

应用随机报错退出

1. 检查 SD 卡文件系统，不是 FAT32 就重新格式化再拷回文件。
2. 升级大气层与固件到最新。
3. 仍复现的话，记录复现路径（哪个页面、什么操作）再去报问题，随机问题没有规律信息很难修。

启动后长时间黑屏

1. 删掉 SD 卡里的config/wiliwili整个目录，重进应用——本地缓存配置损坏时这是官方给的重置手段。
2. 删掉后仍黑屏，回到上一条查固件与时间问题。

4K 视频卡顿

1. 确认当前是 OpenGL 版 nro，它的上限就是 4K@30，先降码率或换 1080P 验证是否流畅。
2. 确认无误后换 deko3d 版重试 4K@60；偶发崩溃是已知代价，重要观看前想清楚要不要冒险。

DLNA 投屏找不到设备

1. 确认主机和电视/投影在同一个网段，跨路由器的设备基本不会被发现。
2. 确认对方开启了媒体服务器或渲染器功能。
3. 重新发起搜索并等满 5 秒超时，再点一次刷新。

更细的问题排查和项目 Wiki 入口在仓库主页的"反馈问题前要做的事"一节，提问题前先翻一遍 Issues 列表，大概率有人踩过同样的坑。

六、项目资源与社区

• 仓库主页与 releases：xfangfang/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