解锁Switch掌机B站新体验：零基础wiliwili客户端部署指南

wiliwili作为专为手柄操作优化的跨平台B站客户端，让你的Switch瞬间变身便携视频娱乐中心。这款开源应用支持在Nintendo Switch、PSVita、PS4和PC多平台运行，特别针对掌机设备做了界面适配和操作优化，无需触屏即可流畅浏览海量视频内容。本文将带你从环境准备到功能使用，一步步在Switch大气层系统上搭建专属的B站观看平台。

环境配置：从准备到验证的四步法

确认设备兼容性

在开始部署前，请确保你的Switch满足以下条件：

• 已安装最新版大气层（Atmosphere）系统
• 已配置签名补丁（确保自制程序能正常运行的系统组件）
• 至少150MB可用存储空间
• microSD卡已格式化为FAT32或exFAT格式

⚠️ 注意事项：未破解的Switch无法运行自制程序，本教程仅适用于已安装大气层破解系统的设备。

获取项目源码

执行克隆命令：

git clone https://gitcode.com/GitHub_Trending/wi/wiliwili
cd wiliwili

这将从官方仓库下载最新源代码到本地，整个过程需要保持网络连接。

编译安装文件

运行构建脚本：

./scripts/build_switch.sh

脚本会自动处理依赖下载、编译配置和NRO文件生成，全过程约10-20分钟。成功完成后，你将在build/switch/wiliwili.nro路径找到可执行文件。

图1：wiliwili客户端主界面展示，包含直播、推荐、热门等核心功能模块

部署使用：从文件传输到桌面集成

基础部署方法

1. 通过USB数据线连接Switch与电脑
2. 将生成的wiliwili.nro文件复制到SD卡的switch/目录
3. 在Switch上启动相册应用，找到wiliwili图标运行

桌面图标配置

如需将应用添加到Switch主屏幕，可使用转发器功能：

cd scripts/switch-forwarder
./pack.sh

生成的NSP文件可通过Goldleaf等工具安装，实现系统桌面直接启动。「配置文件路径：scripts/switch-forwarder/wiliwili.json」中可自定义应用名称和图标。

图2：wiliwili浅色主题模式下的视频推荐页面，展示了适配掌机的卡片式布局

功能探索：从基础操作到个性化设置

手柄控制指南

wiliwili针对Switch手柄做了专属优化：

• A键：确认选择/播放视频
• B键：返回上一级
• X键：视频收藏/点赞
• Y键：打开搜索功能
• 摇杆：导航菜单/滚动内容
• +键：打开视频设置

个性化配置选项

在设置界面可调整：

• 主题切换（深色/浅色模式）
• 弹幕显示参数（透明度、字号、速度）
• 视频画质默认选项
• 网络缓存大小设置

⚠️ 注意事项：缓存设置过大会占用SD卡空间，建议根据使用习惯调整为50-100MB。

适用场景：不同用户群体的使用价值

掌机玩家

利用碎片化时间观看游戏攻略、赛事直播，手柄操作比触屏更符合掌机使用习惯，躺在床上也能轻松操作。

家庭娱乐用户

通过Switch底座连接电视，将wiliwili作为家庭媒体中心，多人共享B站内容，支持DLNA投屏功能。

旅行通勤族

下载视频离线观看功能解决地铁、高铁等网络不稳定环境下的观看需求，节省手机流量。

图3：wiliwili影视专题页面展示，支持按地区、类型、年代等多维度筛选内容

问题解决：常见故障排除指南

启动失败问题

• 现象：应用闪退或停留在黑屏
• 解决方案：
  1. 检查大气层系统版本是否最新
  2. 重新复制NRO文件确保传输完整
  3. 验证SD卡是否有足够存储空间

视频播放问题

• 现象：卡顿、音画不同步
• 解决方案：
  1. 降低视频清晰度设置
  2. 清理应用缓存数据
  3. 关闭后台其他应用释放内存

未来功能展望

wiliwili开发团队计划在后续版本中加入更多实用功能：

• 多账号切换功能，满足家庭共享需求
• 视频续播功能，支持跨设备进度同步
• 增强的弹幕互动效果，提升观看体验
• 本地视频播放功能，整合个人媒体库

通过本指南，你已经掌握了在Switch上部署和使用wiliwili的全部要点。这款开源应用不仅扩展了Switch的娱乐功能，更为B站用户提供了全新的观看方式。随着项目的持续迭代，相信会带来更多惊喜功能，让我们一起期待wiliwili的不断进化。