Switch上怎么跑B站客户端?wiliwili安装与实操
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili 是一款专为手柄用户设计的第三方 B 站客户端,本文带你走通它在 Nintendo Switch 大气层系统上的安装与使用。整个流程按自检 → 安装 → 首次使用 → 排错展开,普通用户走预编译包 10 分钟内可跑通。你只需要把wiliwili.nro放进 SD 卡,通过 hbmenu 启动就能横屏追番、看弹幕。文章覆盖环境检查、两条安装路线、手柄按键速查和高频故障的自助排查方法。
🛋️ 它跟手机B站多了什么
wiliwili 的价值集中在"用手柄操作 B 站",三种用法最能体现和手机端的差异:
- 沙发上追番看弹幕:电视模式横屏播番剧,弹幕、评论、分集切换全走手柄按键,不用离开沙发去拿手机。
- 碎片时间刷动态:动态页汇总关注 UP 主的最新投稿,摇杆快速上下浏览,适合通勤和睡前刷内容。
- 大屏选片:影视频道支持按地区、风格、年份、评分多维筛选,把 Switch 当客厅选片器,定好片单再点开播放。
📋 安装前1分钟自检
装之前把环境对一遍,后面 90% 的失败都能提前避开:
| 检查项 | 达标标准 | 确认方式 | 高频踩坑 |
|---|---|---|---|
| 大气层(Atmosphere) | 1.5.0 及以上,建议保持最新 | 设置 → 系统 → 系统版本 | 版本过旧直接启动失败 |
| 签名补丁 sigpatches | 最新版 | 查看 SD 卡atmosphere/patches目录 | 补丁缺失导致应用崩溃 |
| 系统固件 | 与大气层版本同步 | 大气层配套流程更新 | 固件落后引发异常退出 |
| SD 卡格式 | FAT32 | 电脑上查看 SD 卡属性 | exFAT 格式无法正常运行 |
| 剩余空间 | 100MB 以上 | 设置 → 数据管理 | 空间不足写入失败 |
| 系统时间 | 与真实时间一致 | 系统设置中的时钟 | 时间不准网络通也登录不了 B 站 |
最容易被忽略的两项是大气层/固件没更新到最新、SD 卡不是 FAT32;另外系统时间一旦不准,页面加载和扫码登录都会失败。
💽 wiliwili Switch安装:预编译与源码两条路线
快速路线(预编译包)
- 从仓库 releases 页面下载对应版本的
wiliwili-NintendoSwitch.zip并解压。 - 将
wiliwili.nro复制到 SD 卡switch/目录,放成switch/wiliwili/wiliwili.nro也可以。 - 插回 SD 卡,在 Switch 主页按住 R 键打开任意游戏,调出 hbmenu。
- 在 hbmenu 的
sdmmc/switch列表里找到 wiliwili,按 A 启动。
源码路线(开发者编译)
适合想要最新功能或改参数再编译的用户,整个流程四步。先拉取仓库:
# 拉取仓库源码(含子模块) git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili再在 docker 容器里跑构建脚本,它会自动安装 ffmpeg、libmpv 等依赖并完成编译,脚本见 scripts/build_switch.sh:
# 在仓库目录下执行,自动编译出 wiliwili.nro docker run --rm -v $(pwd):/data devkitpro/devkita64:20251117 \ bash -c "/data/scripts/build_switch.sh"构建完成后在cmake-build-switch目录得到wiliwili.nro,替换 SD 卡里的文件即可。如需手动编译 ffmpeg/mpv 依赖,参考 scripts/README.md。
▶️ 第一次使用:从启动到播完第一个视频
首次上手是一条直线操作,默认配置即可,无需额外设置。
- 首次启动:从 hbmenu 启动 nro 会先进入教程页,演示手柄操作方式,翻完进入主界面。
- 确认联网:看界面顶部的 Wi-Fi 图标;未连接时先回系统设置连网,登录失败优先排查网络。
- 账号登录:进入"我的",选择账号登录,用手机 B 站 App 扫码并确认授权,收藏、历史记录、追番追剧列表随账号同步。
- 进入播放页:回首页从热门推荐任选一个视频点入。
- 验证播放:播放页直接支持弹幕、评论与分集切换,底部栏会显示当前按键提示(搜索/返回/确定),对照提示操作可以少误触。
- 确认成功:按左/右键快退快进、上/下键调音量,画面响应与底部提示一致即说明一切正常,可以直接日常使用。
🕹️ 手柄操作速查
屏幕底部的按键提示会跟随焦点变化,记住这张表,90% 的操作都覆盖了:
| 操作 | 按键 | 备注 |
|---|---|---|
| 确认 / 播放 / 提交 | A | 播放页即开始播放 |
| 返回上一级 / 关闭面板 | B | |
| 打开搜索框 | X | |
| 刷新当前页面 | Y | |
| 移动焦点 / 滚动列表 | 左摇杆或十字键 | |
| 切换一级页面 | L / R | 首页、动态、我的 |
| 切换二级页面 | 上 / 下 | 热门、追番、影视的子栏 |
| 快退 / 快进 | 左 / 右(播放页) | 播放页上/下键为音量 |
进阶组合键只有三个:
- 长按右摇杆:播放页临时快进,双击锁定快进
- L + A:向前跳转视频,单手模式下单个手柄即可完整操控播放
- 播放页按 L 显示/隐藏 OSD,按 B 显示/隐藏弹幕
⚙️ 进阶调优(有余力再做)
安装wiliwili桌面图标
不装图标时每次都要绕道 hbmenu。入口在:设置 → 实用工具 → 使用教程,确认后应用会把内置的 NSP 直接写入 SD 卡。图标启动时按顺序查找switch/wiliwili.nro和switch/wiliwili/wiliwili.nro,都找不到则打开 hbmenu 让你手动选。想自行打包图标,源码与说明在 scripts/switch-forwarder/。
按网络选渲染版本
默认发布的 OpenGL 版本最高支持 4K@30;追求 4K@60 可以构建 deko3d 版本(使用 Switch 原生图形 API),见 scripts/build_switch_deko3d.sh,播放更顺但偶发崩溃。网络一般时把默认画质设为自动或 720P 并开启硬件解码,比硬扛高画质稳定得多。
多设备同步
多台设备登录同一个 B 站账号即可,收藏、观看历史、追番追剧列表都会同步,历史记录支持跨设备续播,无需额外配置。
🩹 卡住了?故障自助排查
| 现象 | 最可能原因 | 处理动作 | 验证修好的标准 |
|---|---|---|---|
| 启动后长时间黑屏或直接退出 | 配置缓存损坏或过期 | 删除 SD 卡config/wiliwili目录后重新进入 | 能正常进入首页并加载内容 |
| 页面不加载、登录失败 | 系统时间不准、DNS 不当、代理未关 | 校正时间,DNS 改 8.8.8.8 / 1.1.1.1,关闭代理 | 设置 → 实用工具 → 网络诊断正常 |
| 播放卡顿、缓冲频繁 | 画质过高或走了软解 | 默认画质设为自动或 720P,开启硬件解码 | 重播同一视频不再频繁转圈 |
| 手柄按键无响应 | 手柄未识别或应用卡死 | 重新配对/重连手柄,重启应用 | 底部按键提示能跟随焦点移动 |
表里没有的,去项目 issues 区提反馈,反馈前附一张网络诊断截图会加快定位。
到这里,wiliwili 已经能在 Switch 上跑起来了,默认配置足够日常使用。下一步建议先装好桌面图标,再完整走一遍"追番 + 弹幕播放"流程,确认多设备同步符合预期。Anime4K、自定义字体等更多技巧可继续阅读 README.md 与项目文档。
【免费下载链接】wiliwili第三方B站客户端,目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考