☰
Switch上怎么跑B站客户端?wiliwili安装与实操
2026/10/21 1:29:43 网站建设 项目流程

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安装:预编译与源码两条路线

快速路线(预编译包)

  1. 从仓库 releases 页面下载对应版本的wiliwili-NintendoSwitch.zip并解压。
  2. 将wiliwili.nro复制到 SD 卡switch/目录,放成switch/wiliwili/wiliwili.nro也可以。
  3. 插回 SD 卡,在 Switch 主页按住 R 键打开任意游戏,调出 hbmenu。
  4. 在 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。

▶️ 第一次使用:从启动到播完第一个视频

首次上手是一条直线操作,默认配置即可,无需额外设置。

  1. 首次启动:从 hbmenu 启动 nro 会先进入教程页,演示手柄操作方式,翻完进入主界面。
  2. 确认联网:看界面顶部的 Wi-Fi 图标;未连接时先回系统设置连网,登录失败优先排查网络。
  3. 账号登录:进入"我的",选择账号登录,用手机 B 站 App 扫码并确认授权,收藏、历史记录、追番追剧列表随账号同步。
  4. 进入播放页:回首页从热门推荐任选一个视频点入。

  1. 验证播放:播放页直接支持弹幕、评论与分集切换,底部栏会显示当前按键提示(搜索/返回/确定),对照提示操作可以少误触。
  2. 确认成功:按左/右键快退快进、上/下键调音量,画面响应与底部提示一致即说明一切正常,可以直接日常使用。

🕹️ 手柄操作速查

屏幕底部的按键提示会跟随焦点变化,记住这张表,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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询