零基础玩转wiliwili：开源手柄控制B站客户端完整指南

在电视或游戏机上观看B站内容时，传统触屏操作往往显得格格不入，而wiliwili作为一款专为手柄控制设计的第三方B站客户端，完美解决了这一痛点。本指南将帮助你在Nintendo Switch等设备上从零开始构建并配置这款开源应用，让你轻松享受躺在沙发上用手柄刷B站的乐趣。wiliwili支持多平台运行，包括PC、PSVita、PS4和Nintendo Switch，是开源社区为游戏玩家打造的优质娱乐解决方案。

分析使用需求：为什么选择wiliwili

识别使用场景

想象这样的场景：你正舒服地躺在客厅沙发上，电视屏幕上显示着B站的精彩内容，但每次想切换视频或发送弹幕都需要拿起手机操作，体验十分割裂。wiliwili正是为解决这一问题而生，它将B站内容完美适配到手柄控制的设备上，让你享受大屏观看的同时，获得原生的游戏级操控体验。

核心功能需求

• 手柄优化控制：所有操作专为手柄设计，按键布局符合游戏操作习惯
• 多平台适配：支持Nintendo Switch、PSVita等多种设备
• 完整B站功能：包括视频播放、直播观看、弹幕互动、动态浏览等核心功能
• 个性化定制：支持界面布局调整、按键映射自定义等个性化设置

选择解决方案：wiliwili的技术优势

开源架构解析

wiliwili采用C++开发，基于SDL2和MPV等成熟开源库构建，具有以下技术特点：

• 跨平台框架：使用CMake和xmake构建系统，实现一次编码多平台部署
• 硬件加速：针对不同设备优化的视频渲染 pipeline
• 模块化设计：清晰分离UI、业务逻辑和数据层，便于维护和扩展

与其他方案对比

方案	优势	劣势
官方网页版	功能完整	手柄操作体验差，需浏览器支持
其他第三方客户端	部分支持手柄	功能有限，更新不及时
wiliwili	专为手柄优化，开源免费，多平台支持	需要自行构建，有一定技术门槛

实施步骤：从源码到运行

准备开发环境

在开始构建前，请确保你的系统已安装以下依赖：

• Git
• CMake 3.10+
• 交叉编译工具链（针对Switch等嵌入式设备）
• 必要的开发库（SDL2、MPV等）

# 以Ubuntu/Debian为例安装基础依赖
sudo apt update && sudo apt install -y git cmake build-essential

获取源代码

使用Git克隆项目仓库到本地：

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

构建应用程序

根据目标平台选择相应的构建脚本。以Nintendo Switch为例：

# 执行Switch平台构建脚本
./scripts/build_switch.sh --release

⚠️ 注意事项：构建过程可能需要下载多个依赖库，确保网络连接稳定。完整构建时间根据硬件配置不同，可能需要15-30分钟。

构建成功后，生成的NRO文件位于build/switch/wiliwili.nro。

打包系统应用

若希望将wiliwili安装到Switch系统菜单中，需进行NSP打包：

# 进入转发器目录
cd scripts/switch-forwarder

# 执行打包脚本
./pack.sh

打包完成后，会在当前目录生成NSP安装包，可通过Goldleaf等工具安装到Switch系统。

wiliwili主界面展示了针对手柄优化的布局，包含直播、推荐、热门等主要功能区域

部署到设备

有两种部署方式可供选择：

1. NRO文件部署：将wiliwili.nro复制到SD卡的switch/目录，通过Homebrew菜单启动
2. NSP安装包：使用Goldleaf或Tinfoil安装NSP文件，应用将出现在系统菜单中

配置与个性化

基础设置配置

首次启动应用后，建议完成以下基础配置：

1. 进入"设置"界面
2. 配置网络连接
3. 调整视频质量默认设置
4. 设置默认弹幕显示方式

wiliwili分类页面展示了清晰的内容分类导航和手柄友好的交互界面

定制手柄按键

wiliwili支持按键自定义，你可以根据个人习惯调整：

1. 进入"设置 > 控制设置"
2. 选择需要修改的功能
3. 按下新的按键进行映射
4. 保存配置并应用

更改应用图标

自定义应用图标可以让wiliwili在系统菜单中更加独特：

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

优化与拓展

提升视频加载速度

通过以下设置可以优化网络性能：

1. 进入"设置 > 网络设置"
2. 启用DNS缓存
3. 设置适当的预加载缓冲区大小
4. 根据网络状况调整默认视频质量

wiliwili视频播放界面展示了清晰的控制元素和弹幕显示效果

启用硬件加速

针对支持的设备，可以启用硬件加速提升性能：

# 构建时添加硬件加速支持
./scripts/build_switch_deko3d.sh

⚠️ 注意事项：硬件加速功能可能会增加电池消耗，在移动设备上使用时请注意电量。

进阶功能探索

1. 弹幕发送与管理

wiliwili支持完整的弹幕交互功能，包括：

• 发送彩色弹幕
• 弹幕速度和透明度调整
• 屏蔽特定类型的弹幕

2. 视频收藏与同步

通过B站账号登录后，可实现：

• 同步网页端收藏夹
• 观看历史记录同步
• 稍后再看功能

wiliwili影视分类页面展示了丰富的影视内容和详细的分类筛选功能

3. 后台播放模式

开启后台播放后，即使关闭应用界面，音频仍可继续播放，适合收听音频内容。

常见问题速查

Q: 构建过程中提示依赖缺失怎么办？

A: 检查是否已安装所有必要的开发库，可参考项目README中的依赖列表。对于Switch平台，确保已正确设置devkitPro环境。

Q: 应用启动后卡在加载界面如何解决？

A: 尝试清除应用缓存，路径通常为/switch/wiliwili/cache。如问题持续，可能需要重新构建应用。

Q: 手柄按键无响应如何处理？

A: 检查手柄连接状态，进入"设置 > 控制设置"执行按键测试。如仍有问题，可尝试删除按键配置文件重置为默认设置。

Q: 视频播放卡顿怎么办？

A: 降低视频质量设置，关闭不必要的后台应用，或尝试使用有线网络连接以提高稳定性。

Q: 如何更新到最新版本？

A: 拉取最新代码后重新构建：

git pull
./scripts/build_switch.sh

总结与资源

wiliwili作为一款开源的第三方B站客户端，为游戏设备带来了优质的视频娱乐体验。通过本指南，你已经掌握了从源码构建到个性化配置的完整流程。随着项目的持续发展，更多功能将不断添加，建议定期关注项目更新。

项目仓库 | 问题反馈