在Switch上跑通B站客户端wiliwili入门到进阶【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwiliwiliwili 是一款专为手柄用户设计的 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.jsonSwitch 的配置目录是内存卡的/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 构建最高 4K30deko3d 构建scripts/build_switch_deko3d.sh可流畅 4K60但偶尔崩溃。PS4 软解播 4K60 需要在设置里开启低画质解码。本地构建后网络流播不了— 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），仅供参考