wiliwili：Switch上的B站第三方客户端完整安装与使用指南
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
还在为Switch无法观看B站视频而烦恼吗？wiliwili是一款专为手柄用户设计的第三方B站客户端，能够让你在任天堂Switch、PSVita、PS4等游戏主机上畅享B站内容。无论你是想躺在沙发上追番，还是在电视大屏上观看视频，wiliwili都能提供接近官方PC客户端的浏览体验，完美适配手柄操作习惯。
🔍 问题引入：为什么需要Switch上的B站客户端？
传统的B站客户端主要面向手机和PC平台，对于拥有Switch等游戏主机的用户来说，无法充分利用大屏优势和手柄操作的便利性。wiliwili的出现解决了这一痛点，它：
- 完美适配手柄操作：专门为手柄控制设计，操作逻辑符合游戏主机的使用习惯
- 多平台支持：不仅支持Switch，还兼容PSVita、PS4、Windows、macOS、Linux等多个平台
- 完整功能体验：支持视频播放、弹幕互动、搜索、收藏、历史记录等核心功能
💡 解决方案：wiliwili的核心优势
wiliwili基于nanovg绘制界面，底层可移植到任意图形库，已有OpenGL/Vulkan/Metal等支持。视频播放部分使用FFMPEG + MPV绘制，默认使用OpenGL，同时支持D3D11/Deko3d/Gxm或软件渲染。触摸/按键/输入法等平台相关功能通过GLFW或SDL来支持。
主要特性一览表
| 功能模块 | 支持情况 | 特色说明 |
|---|---|---|
| 多语言支持 | ✅ 简体中文、繁体中文、日文、韩文、英文等 | 跟随系统自动切换语言 |
| 视频播放 | ✅ 支持4K@60帧（Switch deko3d版本） | 支持硬解码，流畅播放高清视频 |
| 弹幕系统 | ✅ 实时弹幕显示与发送 | 完整的弹幕互动体验 |
| 搜索功能 | ✅ 热搜、视频、番剧、影视分类搜索 | 智能搜索推荐 |
| 个人中心 | ✅ 扫码登录、历史记录、收藏夹、追番追剧 | 完整的用户功能 |
| 主题切换 | ✅ 深浅两色主题 | 跟随系统自动切换 |
🚀 核心功能：wiliwili能为你做什么？
wiliwili提供了接近官方PC客户端的完整B站体验，让你在游戏主机上也能享受B站的丰富内容。
首页与内容推荐
首页分为多个模块，包括直播推荐、热门视频、番剧影视等分类。界面设计简洁直观，支持快速浏览和筛选内容。左侧固定侧边栏提供"首页/动态/我的"导航，顶部搜索栏支持快速查找内容。
视频播放与弹幕互动
视频播放界面支持多种清晰度选择，右侧显示评论区，底部有完整的播放控制栏。支持点赞、投币、收藏等互动功能，弹幕系统完整保留B站特色。
影视分类与筛选
wiliwili影视筛选界面
提供详细的影视分类筛选功能，支持按地区（中国、日本）、风格（喜剧、科幻）、年份等多种条件筛选。无论是追番还是看电影，都能快速找到想看的內容。
用户中心与个性化
支持扫码登录B站账号，同步历史记录、个人收藏、我的追番、我的追剧等数据。用户中心界面清晰展示粉丝数、关注数等个人信息。
📦 安装部署：Switch版详细安装步骤
方法一：NRO文件直接运行（推荐新手）
这是最简单的安装方式，适合大多数用户：
获取wiliwili.nro文件
- 从项目发布页面下载最新版本的
wiliwili-NintendoSwitch.zip - 解压后找到
wiliwili.nro文件
- 从项目发布页面下载最新版本的
复制到Switch内存卡
- 将
wiliwili.nro文件复制到microSD卡的switch/目录下
- 将
启动应用
- 在Switch主界面按住R键打开任意游戏进入hbmenu
- 在应用列表中选择wiliwili并点击打开
方法二：NSP文件系统安装（追求原生体验）
如果你想要更原生的体验，可以将应用安装到Switch系统菜单中：
构建NSP转发器
cd scripts/switch-forwarder make make wiliwili.nacp打包NSP文件
- 新建
switch-hacbrewpack目录 - 将设备key放置在目录下命名为
prod.keys - 执行打包脚本生成NSP文件
- 新建
安装NSP文件
- 使用Goldleaf或Tinfoil安装生成的NSP文件
- 安装后wiliwili将直接出现在系统菜单中
两种安装方式对比
| 特性 | NRO文件 | NSP文件 |
|---|---|---|
| 安装难度 | ⭐⭐☆☆☆（简单） | ⭐⭐⭐⭐☆（中等） |
| 启动方式 | 通过hbmenu启动 | 直接系统菜单启动 |
| 更新便利 | ⭐⭐⭐⭐⭐（直接替换文件） | ⭐⭐☆☆☆（需重新安装） |
| 系统集成 | ⭐☆☆☆☆（独立应用） | ⭐⭐⭐⭐⭐（原生应用体验） |
| 推荐用户 | 新手用户、经常更新版本 | 追求原生体验、不常更新的用户 |
🛠️ 从源码构建：开发者与进阶用户指南
如果你想要自定义功能或为其他平台构建，可以从源码开始：
1. 获取源码
git clone https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili2. 构建Switch版本
使用项目提供的构建脚本一键构建：
./scripts/build_switch.sh脚本会自动完成所有依赖下载和编译工作，最终在build目录生成wiliwili.nro文件。
3. 构建其他平台版本
wiliwili支持多平台构建，具体命令如下：
Windows/macOS/Linux构建：
cmake -B build -DPLATFORM_DESKTOP=ON make -C build wiliwili -j$(nproc)PSVita版本构建：
# 构建OpenGL ES 2.0版 docker run --rm -v $(pwd):/src/ xfangfang/wiliwili_psv_builder:latest \ "cmake -B cmake-build-psv -G Ninja -DPLATFORM_PSV=ON \ -DMPV_NO_FB=ON -DUSE_SYSTEM_CURL=ON -DUSE_SYSTEM_SDL2=ON \ -DCMAKE_BUILD_TYPE=Release && \ cmake --build cmake-build-psv"🎮 使用技巧：让体验更完美
手柄操作指南
wiliwili专门为手柄操作优化，以下是常用操作：
| 按键 | 功能 | 说明 |
|---|---|---|
| A键 | 确认/播放 | 主要确认按钮 |
| B键 | 返回/取消 | 返回上一级菜单 |
| X键 | 刷新/更多操作 | 刷新页面或显示更多选项 |
| Y键 | 搜索 | 快速进入搜索界面 |
| L/R键 | 翻页/切换标签 | 左右切换内容 |
| ZL/ZR键 | 快速滚动 | 快速上下滚动列表 |
| 摇杆 | 导航选择 | 移动光标选择项目 |
网络优化设置
如果遇到视频加载缓慢的问题，可以尝试以下优化：
- 修改DNS设置：在Switch网络设置中尝试使用公共DNS
- 使用代理：如果网络环境需要，可以配置代理服务器
- 调整视频清晰度：在设置中降低默认播放清晰度
个性化设置
在wiliwili的设置中，你可以自定义：
- 视频清晰度：根据网络状况调整默认播放质量
- 弹幕显示效果：调整弹幕大小、透明度、速度等
- 主题颜色：选择深色或浅色主题
- 界面缩放：调整界面元素大小
- 按键映射：自定义手柄按键功能
存储管理
定期清理缓存文件可以保持应用运行流畅：
- 缓存位置：
config/wiliwili目录 - 建议定期清理历史记录和临时文件
⚠️ 常见问题与故障排除
问题1：应用无法启动
可能原因及解决方案：
- ✅ 检查大气层签名补丁是否为最新版本
- ✅ 确认系统固件版本兼容性
- ✅ 确保内存卡格式为FAT32
- ✅ 验证NRO文件完整性，重新下载尝试
问题2：手柄操作不灵敏
检查步骤：
- 查看
wiliwili/include/utils/shortcut_helper.hpp中的按键映射 - 在应用设置中调整控制布局
- 尝试重新校准Switch手柄
问题3：视频播放卡顿
优化建议：
- 在设置中开启"低画质解码"选项
- 降低默认播放清晰度
- 检查网络连接稳定性
- 对于Switch用户，可以尝试deko3d版本以获得更好的硬解支持
问题4：应用黑屏时间过长
解决方案：
- 删除内存卡目录
config/wiliwili重新进入 - 确保系统时间设置正确
- 检查网络设置，特别是DNS配置
🔧 高级功能与自定义
自定义图标美化
想让你的wiliwili在Switch桌面上更加个性化吗？
准备图标文件
- 准备128x128像素的PNG或JPG图片
- 确保图片清晰度足够
修改配置文件
- 编辑
scripts/switch-forwarder/pack.sh脚本中的图标路径 - 修改
scripts/switch-forwarder/wiliwili.json中的应用元数据
- 编辑
重新打包
- 执行打包脚本生成包含新图标的NSP文件
- 重新安装到Switch系统
多语言支持
wiliwili支持多语言切换，如果你发现翻译存在问题或想贡献新的语言：
- 查看项目中的多语言配置文件
- 提交翻译改进到项目仓库
- 在应用设置中选择你偏好的语言
🎯 总结与展望
wiliwili作为一款专为手柄用户设计的第三方B站客户端，成功将B站的丰富内容带到了Switch等游戏主机平台。它不仅提供了完整的B站功能体验，还针对手柄操作进行了深度优化，让用户在游戏主机上也能享受流畅的视频观看体验。
项目优势总结
- 跨平台支持：支持Switch、PSVita、PS4、PC全平台
- 完整功能：视频播放、弹幕、搜索、个人中心一应俱全
- 手柄优化：专门为手柄操作设计，符合游戏主机使用习惯
- 开源免费：完全开源，社区活跃，持续更新
未来发展方向
根据项目的TODO列表，wiliwili还在持续开发中，未来可能增加的功能包括：
- 搜索支持搜索用户
- 长按一键三连功能
- 个人主页完善
- 评论跳转进度和搜索
- 互动视频支持
开始你的B站之旅
现在你已经掌握了wiliwili的完整安装和使用技巧。无论是追新番、看直播，还是刷短视频，你的Switch都能变身为功能强大的B站播放器。赶快动手试试，让游戏主机焕发新的娱乐价值！
如果在使用过程中遇到任何问题，建议先查看项目的Issues页面寻找解决方案，或按照"反馈问题前要做的事"部分进行自查。祝你在Switch上享受愉快的B站观影体验！
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
