wiliwili：专为游戏主机打造的第三方B站客户端深度解析

wiliwili：专为游戏主机打造的第三方B站客户端深度解析

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

wiliwili是一款专为手柄操作优化的第三方跨平台Bilibili客户端，支持PC全平台、PSVita、PS4、Xbox和Nintendo Switch等设备。这款开源项目通过深度适配游戏主机操作逻辑，为玩家提供了在游戏设备上流畅浏览B站内容的创新体验。无论你是想在Switch上追番，还是在PS4大屏上观看视频，wiliwili都能将传统视频平台与游戏主机完美融合。

项目核心特性：重新定义主机视频体验

多平台无缝适配

wiliwili采用模块化架构设计，底层基于nanovg图形库，支持OpenGL、Vulkan、Metal等多种图形API，确保了在不同硬件平台上的兼容性。项目通过CMake构建系统实现了灵活的编译配置，开发者可以通过简单的参数切换来为目标平台生成对应的可执行文件。

平台支持矩阵：

手柄操作深度优化

wiliwili最大的特色在于对手柄操作的全面优化。与传统鼠标键盘操作不同，项目重新设计了所有交互逻辑，确保用户可以通过手柄完成浏览、搜索、播放、评论等完整操作流程。

手柄操作映射表：

界面设计：兼顾美观与实用性

wiliwili的界面设计充分考虑了游戏主机用户的视觉习惯，提供了深色和浅色两种主题模式，支持根据系统设置自动切换。

图：wiliwili在Nintendo Switch平台的应用界面，完美适配Switch系统UI设计风格

界面采用卡片式布局，视频封面、标题和互动数据清晰可见。左侧固定导航栏包含"首页"、"直播"、"推荐"、"热门"、"追番"、"影视"等分类，用户可以通过手柄方向键快速切换。搜索功能支持智能联想，大大提升了在电视大屏上的输入效率。

安装方案：多平台部署指南

Nintendo Switch安装流程

Switch版本的安装最为用户关注，wiliwili提供了两种安装方式：

方式一：NRO文件直接运行（推荐新手）

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

方式二：NSP转发器安装（系统级集成）

1. 使用项目提供的转发器工具生成NSP安装包
2. 通过Goldleaf或Tinfoil等工具安装NSP文件
3. 安装后wiliwili将直接显示在Switch主界面

PC平台编译安装

对于开发者或高级用户，可以通过源码编译获得最新功能：

# 克隆项目仓库 git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili # Linux系统编译 sudo apt install libssl-dev libmpv-dev libwebp-dev cmake -B build -DPLATFORM_DESKTOP=ON make -C build wiliwili -j$(nproc) # macOS系统编译 brew install mpv webp cmake -B build -DPLATFORM_DESKTOP=ON make -C build wiliwili -j$(sysctl -n hw.ncpu)

包管理器支持

wiliwili已被多个Linux发行版的软件仓库收录，用户可以通过包管理器直接安装：

• Arch Linux (AUR):yay -S wiliwili
• Fedora (COPR):sudo dnf copr enable mochaa/wiliwili
• Flathub:flatpak install flathub cn.xfangfang.wiliwili

技术架构解析：跨平台实现原理

图形渲染层

wiliwili采用分层架构设计，核心图形渲染基于nanovg库实现。这种设计使得项目可以轻松适配不同的图形后端：

# CMake配置示例 cmake -B build -DPLATFORM_DESKTOP=ON -DUSE_SDL2=ON

图形渲染流程：

1. UI层：nanovg处理所有界面元素的绘制
2. 视频层：FFmpeg + MPV处理视频解码和渲染
3. 输入层：GLFW或SDL处理手柄/键盘/触摸输入

依赖管理系统

项目通过CMakeLists.txt文件管理所有依赖关系，支持系统库和内置库两种模式：

# 依赖配置选项 option(USE_SYSTEM_CURL "使用系统curl库" OFF) option(USE_SYSTEM_MPV "使用系统mpv库" OFF) option(DISABLE_OPENCC "禁用简繁转换" OFF)

多语言支持

wiliwili通过Crowdin平台管理多语言翻译，目前支持简体中文、繁体中文、日语、韩语、英语等多种语言。翻译文件位于项目的i18n目录，社区贡献者可以轻松参与翻译工作。

图：wiliwili支持多种语言界面，满足不同地区用户需求

高级配置与自定义选项

视频播放优化

wiliwili提供了丰富的视频播放配置选项，用户可以根据设备性能进行调整：

硬件解码支持：

• Switch Deko3d版本：支持4K@60流畅播放
• PSVita Gxm版本：支持720P横屏视频硬解
• PC版本：支持多种硬件解码器切换

画质增强功能：项目集成了Anime4K算法，可以为动画内容提供实时超分辨率增强，显著提升在电视大屏上的观看体验。

网络配置

wiliwili内置网络诊断工具，帮助用户排查连接问题：

1. DNS优化：支持自定义DNS服务器配置
2. 代理支持：支持HTTP/HTTPS/SOCKS5代理
3. 缓存管理：可配置视频缓存大小和位置

主题自定义

用户可以通过修改主题配置文件来自定义界面外观：

{ "theme": { "primary_color": "#FF6699", "background_color": "#1A1A1A", "font_family": "Noto Sans CJK SC" } }

使用场景与最佳实践

家庭娱乐中心

wiliwili在电视大屏上的表现尤为出色。通过PS4或Switch连接电视，用户可以享受以下优势：

1. 大屏观影：支持4K分辨率输出，画质清晰
2. 多人观看：手柄操作便于多人共享控制权
3. 语音搜索：配合主机语音输入功能（如PS4）

移动场景应用

在Switch掌机模式下，wiliwili提供了便携的B站观看体验：

1. 离线缓存：支持视频下载功能
2. 省电模式：优化视频解码功耗
3. 睡眠恢复：支持从睡眠状态快速恢复播放

开发者调试

对于开发者，wiliwili提供了详细的调试信息：

图：wiliwili的调试界面显示实时FPS和网络状态信息

社区资源与贡献指南

问题反馈流程

在提交问题前，请确保完成以下步骤：

1. 网络诊断：在应用内设置→实用工具→网络诊断中获取诊断截图
2. 系统验证：确保系统固件和自制系统为最新版本
3. 配置检查：验证系统时间、DNS设置和代理配置
4. 问题复现：尝试复现问题并记录详细步骤

代码贡献规范

wiliwili采用分支开发模式：

• 主分支 (yoga)：稳定版本代码
• 开发分支 (dev)：正在开发的功能

Pull Request要求：

1. 所有新功能必须向dev分支提交
2. 提交前运行代码格式化工具
3. 添加相应的测试用例
4. 更新相关文档

多语言翻译贡献

翻译工作通过Crowdin平台管理，贡献者可以：

1. 访问项目Crowdin页面
2. 选择目标语言
3. 提交翻译建议
4. 等待维护者审核

未来发展与技术展望

路线图规划

根据项目的TODO列表，wiliwili正在开发以下功能：

平台扩展计划

项目团队正在探索向更多平台扩展的可能性：

1. Android TV：适配电视盒子平台
2. 游戏主机：探索Xbox Series X|S的适配
3. 智能电视：为各大电视品牌提供定制版本

总结：开启主机视频新时代

wiliwili代表了开源社区在跨平台应用开发上的重要成就。通过将Bilibili内容生态与游戏主机硬件特性深度结合，项目为玩家提供了全新的娱乐体验。无论是技术架构的优雅设计，还是用户体验的细致优化，wiliwili都展现出了开源项目的强大生命力。

立即行动建议：

1. 普通用户：通过包管理器或Release页面下载预编译版本
2. 技术爱好者：尝试从源码编译，探索自定义功能
3. 开发者：参与项目贡献，帮助完善多平台支持
4. 内容创作者：测试不同平台的表现，提供反馈建议

wiliwili的成功证明了开源协作的力量，也为其他希望将互联网服务引入游戏主机的开发者提供了宝贵经验。随着项目的持续发展，我们有理由相信，未来会有更多优秀的跨平台应用涌现，进一步丰富游戏主机的功能生态。

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