如何在Switch上安装wiliwili？完整手柄操作B站客户端的终极指南

wiliwili是一款专为手柄控制设计的第三方跨平台B站客户端，支持在Nintendo Switch、PSVita、PS4等游戏主机上流畅运行。本文将带你从环境准备到深度配置，一步步打造专属的Switch视频娱乐中心，让你的游戏主机秒变B站播放器。

一、为什么选择wiliwili？手柄优化的B站体验

1.1 专为游戏主机打造的核心优势

• 手柄精准操控：所有界面元素适配Joy-Con/Pro手柄操作，菜单导航、视频选集、弹幕控制均支持手柄快捷键
• 多平台覆盖：除Switch外，还支持PSVita、PS4等主机，实现跨设备B站体验
• 轻量化设计：安装包体积不足100MB，启动速度快，占用系统资源少

图1：wiliwili主界面展示，包含推荐视频、分类导航和播放控制区域

1.2 界面功能概览

从截图可以看到，wiliwili采用深色主题设计，左侧为导航栏，中间是内容展示区，底部为功能控制栏。布局清晰直观，即使初次使用也能快速上手。

二、安装前准备：Switch系统环境配置

2.1 必备系统条件

• 已破解的Switch主机（大气层Atmosphere系统）
• 至少100MB可用存储空间
• 已安装最新版签名补丁（sigpatches）
• microSD卡读卡器（用于文件传输）

2.2 工具准备清单

• 电脑（Windows/macOS/Linux均可）
• 文件管理器（推荐DBI或Tinfoil）
• 网络连接（用于下载源码和依赖）

三、3步完成安装：从源码到运行

3.1 获取项目源码

打开终端，执行以下命令克隆项目仓库：

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

3.2 编译Switch版本

进入项目目录，运行Switch专用构建脚本：

cd wiliwili
scripts/build_switch.sh

专业技巧：如果需要启用硬件加速渲染，可使用deko3d分支构建：

scripts/build_switch_deko3d.sh

3.3 安装到Switch

1. 将编译生成的wiliwili.nro文件复制到SD卡的switch目录
2. 插入SD卡到Switch并启动大气层系统
3. 在相册中找到wiliwili图标，点击即可运行

图2：wiliwili分类浏览界面，展示热门视频和分类导航

四、高级配置：打造个性化体验

4.1 安装到系统菜单（NSP格式）

如需将wiliwili添加到Switch主菜单，可使用转发器功能：

cd scripts/switch-forwarder
./pack.sh

生成的NSP文件可通过Goldleaf或Tinfoil安装

4.2 图标与启动画面自定义

1. 准备128x128像素的PNG图标文件
2. 替换scripts/switch-forwarder/source/icon0.png
3. 重新执行打包脚本生成新的NSP文件

4.3 手柄按键自定义

在应用内「设置-手柄设置」中可调整按键映射，支持：

• A键确认/播放
• B键返回
• 摇杆导航
• 肩键快速调节音量/亮度

五、常见问题排查与优化

5.1 启动失败解决方案

• 黑屏闪退：检查sigpatches是否为最新版本
• 卡在加载界面：尝试删除/switch/wiliwili/config目录重置配置
• 无法联网：确认DNS设置正确，或尝试使用手机热点

5.2 播放体验优化

• 缓存清理：定期删除/switch/wiliwili/cache目录释放空间
• 清晰度设置：在播放界面按+键调出菜单，根据网络状况选择合适清晰度
• 弹幕优化：在设置中降低弹幕密度，减少性能消耗

图3：wiliwili视频播放界面，展示进度控制、弹幕和清晰度设置

六、资源汇总：成为wiliwili高级用户

6.1 项目结构解析

• 构建脚本：scripts/build_switch.sh
• 配置文件：wiliwili/include/utils/config_helper.hpp
• 手柄映射：wiliwili/source/utils/shortcut_helper.cpp

6.2 实用功能探索

• DLNA投屏：支持将视频投射到电视或其他设备
• 收藏同步：登录B站账号后可同步收藏夹内容
• 后台播放：支持最小化到后台继续播放音频

图4：wiliwili影视详情页，展示评分、简介和剧集列表

通过本指南，你已经掌握了在Switch上安装和优化wiliwili的全部技巧。现在就拿起手柄，在大屏幕上享受B站丰富的视频内容吧！如果遇到问题，可查阅项目文档或在社区寻求帮助。