终极跨平台B站客户端：wiliwili完整使用指南

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili

🎮 想在大屏幕电视、游戏掌机甚至游戏主机上享受B站视频吗？wiliwili就是你的完美选择！这是一款专为手柄操控设计的第三方跨平台B站客户端，支持PC、PSVita、PS4、Xbox和Nintendo Switch等多种设备，让你摆脱手机小屏幕的限制，享受全新的观影体验。

🌟 wiliwili是什么？为什么选择它？

wiliwili是一款开源的第三方B站客户端，最大的特色就是专为手柄操控设计。无论你是想在客厅电视上观看B站，还是在游戏机上浏览视频，wiliwili都能提供流畅的操作体验。与官方客户端相比，wiliwili在多平台支持方面有着无可比拟的优势。

图1：wiliwili客户端主界面，包含推荐、分类、播放和筛选四大核心模块

✨ 核心功能亮点

• 多平台支持：支持Windows、macOS、Linux、Nintendo Switch、PSVita、PS4、Xbox
• 手柄优化：所有操作都针对手柄进行优化，支持摇杆、按键操作
• 完整B站功能：视频播放、弹幕、评论、搜索、动态、个人中心一应俱全
• 多语言界面：支持简体中文、繁体中文、日语、韩语、英语等
• 主题切换：拥有深浅两色主题，可跟随系统自动切换

📱 多平台安装指南

Nintendo Switch安装教程

想在Switch上享受B站视频？wiliwili为你提供了完美的解决方案！Switch版本支持OpenGL和deko3d两种渲染模式，让你在掌机模式下也能流畅观看视频。

安装步骤：

1. 从项目仓库下载最新的wiliwili-NintendoSwitch.zip文件
2. 将解压后的wiliwili.nro文件放置到内存卡的switch目录下
3. 在Switch主页按住R键打开任意游戏进入hbmenu
4. 在应用列表中选择wiliwili并启动

💡 小贴士：deko3d版本可以流畅播放4k@60视频，但稳定性稍差；OpenGL版本更稳定，最高支持4k@30。

PSVita和PS4安装方法

对于索尼游戏机用户，wiliwili同样提供了完美支持：

• PSVita：下载wiliwili-PSVita.vpk文件直接安装，开启硬解后可流畅播放720P横屏视频
• PS4：下载wiliwili-PS4.pkg文件安装，支持软解播放4k@60视频（需在设置中开启低画质解码）

PC平台安装（Windows/macOS/Linux）

PC用户可以通过多种方式安装wiliwili：

Windows用户：

• 直接下载安装包运行
• 支持鼠标操作（左键点击、右键返回、中键刷新）
• 可切换硬件解码，适合老电脑

Linux用户：

• 通过系统软件商店（如Discover、GNOME Software）搜索安装
• 支持Flatpak、Snap等多种包管理器

macOS用户：

• 通过Homebrew安装依赖：brew install mpv webp
• 编译安装或下载预编译版本

图2：wiliwili视频播放界面，支持弹幕、评论和个性化推荐

🎯 功能特色深度解析

首页与推荐系统

wiliwili的首页设计非常接近官方PC客户端，提供丰富的推荐内容：

• 热门推荐：根据你的观看习惯推荐视频
• 分类浏览：按影视、综艺、动漫等分类查找内容
• 动态页面：查看关注的UP主最新动态
• 直播专区：观看B站直播内容

视频播放体验

作为B站客户端，视频播放功能是wiliwili的核心：

• 弹幕支持：完整支持B站弹幕功能
• 评论系统：可以查看和发布评论
• 播放控制：支持进度条拖拽、播放速度调整
• 画质选择：根据网络状况自动选择最佳画质

个人中心功能

通过扫码登录B站账号后，你可以享受完整的个人功能：

• 历史记录：查看观看历史
• 我的收藏：管理收藏的视频和合集
• 追番追剧：管理动漫和影视剧的观看进度
• 账号管理：切换账号、查看个人信息

搜索与筛选功能

wiliwili提供了强大的搜索和筛选系统：

• 热搜榜单：查看B站实时热搜
• 多维度搜索：支持视频、番剧、影视、用户搜索
• 高级筛选：按地区、风格、年代、付费类型筛选内容
• 搜索历史：记录你的搜索记录

图3：wiliwili影视筛选界面，支持多种筛选条件

🔧 高级功能与自定义设置

手柄操作优化

wiliwili最大的特色就是对手柄的完美支持：

• 摇杆导航：使用左摇杆进行界面导航
• 按键映射：A键确认、B键返回、X/Y键功能操作
• 快捷操作：支持重压摇杆临时快进
• 单手模式：支持使用单个手柄控制播放器

主题与界面自定义

• 主题切换：深浅两色主题，可自动跟随系统切换
• 按键图标：支持切换不同风格的按键图标
• 界面布局：可根据设备屏幕大小自动调整布局

性能优化设置

• 解码选项：可选择硬件解码或软件解码
• 画质优化：支持Anime4K提升观感
• 网络优化：内置网络诊断工具
• 缓存管理：可调整缓存大小优化性能

🛠️ 常见问题解决

网络连接问题

如果遇到网络连接问题，可以尝试以下方法：

1. 检查系统时间是否正确
2. 调整DNS设置（推荐使用公共DNS）
3. 关闭网络代理后重新测试
4. 使用应用内的网络诊断工具

Switch用户注意事项

Switch用户在使用wiliwili时需要注意：

• 确保大气层和系统固件更新到最新版本
• 内存卡格式必须为FAT32
• 如果打开应用黑屏时间过长，可尝试删除内存卡目录config/wiliwili重新进入

问题反馈指南

在反馈问题前，请确保：

1. 提供网络诊断截图（设置/实用工具/网络诊断）
2. 完整详细地描述问题，最好附加演示视频或截图
3. 尝试复现问题，找到BUG出现的规律
4. 查看是否有其他人遇到过类似问题

🚀 开发与贡献

wiliwili是一个开源项目，欢迎开发者参与贡献：

软件移植

wiliwili基于nanovg绘制界面，底层可移植到任意图形库。如果你有想要移植的设备，可以在GitHub上发布issue讨论。

新功能开发

如果你有创意想法，建议在开发前发布issue讨论，避免与他人创意撞车。

多语言支持

wiliwili支持多语言翻译，如果你想添加新的语言支持或修正现有翻译，可以参考项目中的翻译贡献指南。

编译与开发环境

wiliwili支持多种编译方式：

PC本地运行：

git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili cmake -B build -DPLATFORM_DESKTOP=ON make -C build wiliwili -j$(nproc)

交叉编译Switch版本：

docker run --rm -v $(pwd):/data devkitpro/devkita64:20251117 \ bash -c "/data/scripts/build_switch.sh"

📈 未来规划与TODO

wiliwili团队正在不断完善功能，未来计划包括：

• 搜索支持搜索用户功能
• 长按一键三连操作
• 完整的个人主页功能
• 评论跳转进度和搜索
• 互动视频支持

💝 致谢与开源精神

wiliwili的发展离不开开源社区的支持，特别感谢以下项目和组织的贡献：

• 工具链支持：devkitpro、switchbrew、vitasdk、OpenOrbis、PacBrew
• UI库：borealis（natinusala和XITRIX）
• 视频播放器：pplay、nxmp、FFmpeg-vita、mpv-vita
• 其他开源库：cpr、json、QR-Code-generator、OpenCC等

🎉 开始使用wiliwili吧！

无论你是想在客厅大电视上观看B站，还是在游戏机上浏览视频，wiliwili都能为你提供完美的解决方案。现在就下载体验，享受手柄操控B站的乐趣吧！

核心源码路径：wiliwili/include/配置文件：cmake/脚本工具：scripts/

记得关注项目的更新，wiliwili团队会持续优化和添加新功能，让你的观影体验越来越好！🎬

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili