在Switch上跑通B站客户端：wiliwili入门到进阶
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili 是一款专为手柄用户设计的 B 站客户端，让 Switch 和掌机直接刷起 B 站。
它目前运行在 Nintendo Switch、PSVita、PS4、Xbox 以及 PC 全平台（Windows、macOS、Linux），客厅大屏和床上小屏都能用。
读完这篇，你会知道怎么从源码构建 Switch 版、常用功能怎么用，以及黑屏、卡播放这类问题怎么处理。
它和同类方案差在哪
常见做法是手机投屏或浏览器，前者操控有延迟，后者界面对手柄不友好。wiliwili 是原生客户端，同时支持手柄、鼠标、触屏和键盘。浏览体验接近官方 PC 客户端，弹幕（滚动评论）互动全程不离开游戏设备。
🚀 快速上手（5 分钟内跑通）
官方发布页有现成安装包，这里走一遍源码构建流程，方便你之后自己改。
把源码拉下来。
git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili这一步只是把代码取到本地，--recursive会一并拉取依赖子模块。
用 Docker 构建 Switch 版，容器里自带交叉编译工具链。
docker run --rm -v $(pwd):/data devkitpro/devkita64:20251117 \ bash -c "/data/scripts/build_switch.sh"构建结束后，cmake-build-switch/目录里会生成wiliwili.nro，也就是 Switch 可执行的安装包。
把它复制到内存卡（SD 卡）的switch/目录下，装回主机。
在主页按住 R 键打开任意游戏，进入 hbmenu（游戏内启动的自制软件菜单），选中 wiliwili 打开。
需要大气层（Atmosphere）加 hbmenu 环境，内存卡保持 FAT32 格式。如果进主页黑屏时间过长，删除内存卡的
config/wiliwili目录再重新进入。
进入后就是首页推荐流，手柄方向键滚动、确认键选择。
🎬 功能速览：你能拿它做什么
大屏端看番剧与影视
番剧影视的筛选页按地区、类型、年份、发行状态多维过滤，找片不用逐个翻列表。支持从流畅到 4K 的清晰度切换，登录会员账号还能看到高规格档位。
刷推荐流与看直播
首页推荐流和动态页分别对应官方 App 的推荐与关注动态，动态页展示关注 UP 主的最近投稿。直播页列出关注主播和系统推荐，进房可看直播弹幕。
按关键词搜热视频
搜索页分热搜、视频、番剧、影视 4 个分区，热搜区直接展示实时榜单。视频、番剧、影视各有独立结果页，影视结果自动转成竖图排版。
扫码登录同步观看记录
扫官方 App 的二维码登录，历史记录、收藏夹、追番追剧都会同步到个人页。播放页支持弹幕、评论、点赞投币收藏，长按摇杆还能快速微调进度。
配置与个性化
所有设置存在配置目录的wiliwili_config.json，Switch 的配置目录是内存卡的/config/wiliwili/。常用可调项：
- 主题：深浅色跟随系统切换，自定义主题放进配置目录的
theme/子目录 - 快捷键：设置页可重绑 PC 按键，解析规则见
wiliwili/include/utils/shortcut_helper.hpp，格式如ctrl-r - 字体：向配置目录放
font.ttf、icon.ttf、danmaku.ttf，覆盖内置字体和弹幕字体 - 画质增强：Anime4K 这类锐化着色器通过配置目录的
shader.json加载 - 按键图标：Xbox、PS、键盘 3 套样式可切换
🔧 常见问题速查
视频打不开或加载慢— 先确认系统时间正确，时间错误会导致 SSL 证书验证失败。把 DNS 改成公共 DNS，用应用内「设置/实用工具/网络诊断」截图自查。
打开应用黑屏或启动极慢— Switch 用户把大气层和系统固件更新到最新，确认内存卡为 FAT32，再删除内存卡config/wiliwili目录重新进入。
高清晰度播放卡顿— 默认 OpenGL 构建最高 4K@30；deko3d 构建（scripts/build_switch_deko3d.sh）可流畅 4K@60，但偶尔崩溃。PS4 软解播 4K@60 需要在设置里开启低画质解码。
本地构建后网络流播不了— devkitpro 的默认 ffmpeg/mpv 包不支持网络流，构建脚本会自动下载项目定制包。本地编译时也要按scripts/README.md换成定制版依赖。
💡 进阶与参与
代码按 Android 风格分层，读源码从这 3 处入手：
wiliwili/include/activity/与wiliwili/source/activity/：首页、播放、搜索等顶层页面wiliwili/include/view/：可复用组件，含播放器核心 MPVCore、弹幕渲染、列表控件wiliwili/include/api/bilibili/：B 站接口封装；界面布局在resources/xml/，翻译在resources/i18n/
新功能先提 issue 讨论再动手，新的 PR 提交到 dev 分支，翻译贡献按多语言 issue 的流程走。想要换布局的，可以参考 wiliwili_theme 主题仓库，直接放进配置目录即可生效。
把发布包里的 nro 丢进内存卡就能开刷，想深度定制再按上面的步骤自己构建。使用第三方客户端请遵守 B 站用户协议，支持正版内容。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
