给 Nintendo Switch 装上 B站客户端wiliwili 从安装到调优实战【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili想在电视大屏上用手柄刷 B站Switch 却只有视频 App 可选。wiliwili 是一个开源第三方 B站客户端跑在 Switch 上可以刷视频、看直播、发弹幕操作完全按手柄逻辑设计本文给出从部署到调优的完整路径。图wiliwili 的热门页与影视筛选页顶部标签可用手柄左右切换四步在 Switch 上跑起来最短路径不用碰编译环境从项目发布页下载最新版的wiliwili-NintendoSwitch.zip解压得到wiliwili.nro。把wiliwili.nro拷到内存卡的switch/目录建议 FAT32 格式。在 Switch 主页按住 R 键进入 hbmenu在列表里选中 wiliwili 启动界面如下。可选进入应用内「设置 / 实用工具 / 使用教程」安装桌面图标之后直接从主页打开。图hbmenu 列表里选中 wiliwili 并按 A 键即可启动装完桌面图标后主页会出现 wiliwili 图标它会自动按switch/wiliwili.nro、switch/wiliwili/wiliwili.nro的顺序查找程序两个都没有时才回落到 hbmenu。图以桌面图标方式启动 wiliwili体验接近原生应用如果你要改代码自己出包clone 后在容器里一条命令即可git clone https://gitcode.com/GitHub_Trending/wi/wiliwili docker run --rm -v $(pwd):/data devkitpro/devkita64:latest bash -c /data/scripts/build_switch.sh产物在cmake-build-switch目录里具体依赖安装见 构建脚本。默认包走 OpenGL4K 视频只能到 30 帧想要 4K60 可以改用 deko3d 版构建脚本代价是偶发崩溃。页面功能与手柄操作逻辑wiliwili 的页面结构和官方 PC 客户端高度一致核心页面一览页面能做什么首页 / 热门 / 追番 / 影视推荐流、热搜榜、影视筛选地区、年份、类型筛选条件可叠加播放页视频、番剧、电影、纪录片、综艺含清晰度切换、弹幕、评论、分集、UP主投稿列表搜索页视频、番剧、影视多类型检索带历史与排序个人页扫码登录、历史记录、收藏、追番 / 追剧列表直播页关注主播 系统推荐直播内弹幕互动动态页关注 UP 主的最新投稿图左侧是个人页与直播列表右侧为直播画面与实时弹幕图动态页展示关注 UP 主内容影视页支持按地区、年份、类型多条件筛选手柄默认操作逻辑很简单记住「十字键挪动、A 确认、B 返回」基本能走完全程按键作用十字键 / 摇杆移动焦点、滚动列表A确认、进入、开始播放B返回、退出当前页L / R切换顶部标签页ZL / ZR音量增减长按 快进键播放中快进 / 快退这些快捷键都支持自定义映射定义在 shortcut_helper.hpp格式如ctrl-alt-f1在设置页里改完即生效。影视番剧的选集和分P列表见下图播放中按清晰度快捷键可直接切档位图影视选集页左与播放页内部分P列表右分P可直接跳转网络、缓存与个性化设置设置页值得调的项不多但每条都有明确用途网络 / 代理可配置代理服务器网络受限时基本靠它应用内自带网络诊断设置 / 实用工具 / 网络诊断报问题前先跑一次。清晰度按网络状况设默认档位弱网环境建议压到 720P 以内。弹幕大小、透明度、速度、显示区域都可调弹幕太密时直接关掉能明显提帧。主题深浅两色主题可跟随系统自动切换。缓存数据缓存在内存卡config/wiliwili目录空间紧张时删掉重建即可相当于一次彻底清理。误触保护可开启「首页返回不退出」防止看电视时误按 B 键关掉应用。性能问题与常见坑按「现象 → 排查思路」过一遍最省时间现象先查什么启动黑屏很久或直接闪退内存卡是否 FAT32大气层与系统固件是否为最新删掉config/wiliwili后重进视频加载失败、一直转圈系统时间是否准确时间错会直接导致接口失败DNS 是否可用关掉网络代理再测4K 视频卡帧默认 OpenGL 版上限是 4K30需要 4K60 换 deko3d 版或干脆降清晰度弹幕多的视频掉帧临时关闭弹幕或调小弹幕密度手柄按键无响应确认手柄已配对自定义过快捷键的话对照设置页检查映射是否冲突PC 版用户额外有鼠标支持左键点击、右键返回、中键刷新和硬件解码切换选项老机器开「秒开」模式会顺很多。架构速览与参与入口面向想读代码或提 PR 的人压缩版地图如下界面层nanovg 绘制底层可切换 OpenGL / Vulkan / Metal这也是它能铺满 PC 全平台、PSVita、PS4、Xbox 和 Switch 的原因。播放层FFMPEG MPV 组合默认 OpenGL 渲染可选 D3D11 / Deko3d / Gxm 后端。输入层GLFW默认或 SDL 负责窗口、按键与输入法。代码组织头文件在 wiliwili/include/实现在 wiliwili/source/按 activity / fragment / presenter / api / view 分层各平台交叉编译配置集中在 scripts/ 下。贡献有三个入口新创意先在 issue 里讨论再动手避免撞车翻译支持单独有一个跟踪 issue想加语种或改错别字直接看它代码 PR 一律提往 dev 分支yoga 是主分支。图应用内使用教程入口快捷键说明与桌面图标安装都在这里写在最后wiliwili 把「手柄大屏看 B站」这件事做到了接近官方客户端的完整度而且代码全部开源从刷首页到改播放器行为都有明确的改动入口。使用时注意守住底线登录走应用内扫码别把账号密码交给任何来路不明的改包播放的影视资源版权归平台和版权方个人合理使用即可不要把它当作分发工具。版本更新时留意 release 说明大气层和固件版本过低是大部分兼容问题的根源。【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
