wiliwili：开源客户端全平台适配指南

wiliwili是一款专为手柄控制设计的开源跨平台B站客户端，支持PC、PSVita、PS4及Nintendo Switch等多设备，通过优化的操作界面与硬件加速技术，实现了在游戏设备上流畅观看视频的核心价值。本文将从准备阶段到深度拓展，全面介绍这款开源工具的部署与应用。

准备阶段：环境配置与依赖管理

核心价值：确保开发环境标准化，避免因依赖缺失导致的构建失败

系统环境要求

平台	最低配置要求	推荐配置
Switch	大气层1.5.0+，64GB存储空间	大气层1.8.0+，128GB高速microSD卡
PS4	5.05/6.72/7.02破解系统	9.00系统，50GB以上存储空间
PC	Windows 10/11或Linux发行版	8GB内存，支持OpenGL 4.3的显卡

警告：在进行任何系统修改前，请确保已备份重要数据。所有操作需在合法授权的设备上进行。

开发环境搭建

1. 安装基础编译工具链

   # Ubuntu/Debian系统
   sudo apt update && sudo apt install build-essential git cmake
   
   # Arch Linux系统
   sudo pacman -S base-devel git cmake
   

2. 获取项目源码

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

3. 子模块初始化

   git submodule update --init --recursive
   

原理简析：跨平台架构设计

wiliwili采用C++编写，基于Borealis UI框架实现界面渲染，通过条件编译适配不同硬件平台。核心模块包括：

• 跨平台抽象层：统一输入处理与窗口管理
• 媒体播放核心：基于MPV实现硬件加速视频解码
• 网络模块：支持多种协议的视频流传输

核心部署：基础安装与验证

核心价值：通过标准化流程完成基础部署，确保应用可正常运行

Switch平台部署

1. 执行专用构建脚本

   ./scripts/build_switch.sh
   

   构建过程会自动下载Switch平台依赖，生成NRO格式可执行文件。

2. 部署应用文件

   • 将build/switch/wiliwili.nro复制到SD卡的switch/目录
   • 重启Switch，在自制程序菜单中启动应用

3. 基础功能验证

   • 检查网络连接状态
   • 浏览首页推荐内容
   • 播放任意视频测试音画同步

PC平台部署

1. 生成构建文件

   mkdir build && cd build
   cmake ..
   make -j$(nproc)
   

2. 运行应用

   ./wiliwili
   

注意：Linux用户可能需要安装额外依赖库：sudo apt install libmpv-dev libsdl2-dev

功能强化：系统集成与个性化定制

核心价值：提升应用与系统的整合度，打造个性化使用体验

NSP格式打包（Switch）

1. 进入转发器目录

   cd scripts/switch-forwarder
   

2. 执行打包脚本

   ./pack.sh
   

3. 安装NSP文件

   • 使用Goldleaf或Tinfoil安装生成的NSP文件
   • 应用将出现在系统主菜单，支持图标与名称自定义

界面定制方案

编辑配置文件~/.config/wiliwili/settings.json可调整：

• 主题颜色：修改theme_color字段
• 字体大小：调整font_size参数
• 按键映射：自定义keyboard_layout或controller_layout

性能优化配置

配置项	低性能设备	高性能设备
视频分辨率	720p	1080p
硬件加速	关闭	开启
弹幕数量	限制30%	无限制
缓存大小	200MB	500MB

场景化应用：不同使用场景的最佳配置

核心价值：针对不同使用场景提供优化配置，提升特定场景下的用户体验

家庭娱乐场景

配置方案：

• 启用"大屏模式"：设置ui_scale=1.2
• 开启自动播放：auto_play_next=true
• 配置DLNA投屏：在设置中启用DLNA服务

使用技巧：

• 通过手柄快捷键快速调整音量（L/R键+摇杆）
• 使用"收藏夹"功能创建家庭共享播放列表

便携游戏场景（PSVita/掌机模式）

优化配置：

• 降低分辨率至540p
• 启用"低功耗模式"：power_saving=true
• 调整界面布局为竖屏模式

续航提升技巧：

• 关闭弹幕显示
• 降低屏幕亮度至60%
• 使用飞行模式仅连接Wi-Fi

多人共享场景

推荐设置：

• 启用"家长控制"功能
• 设置内容过滤级别
• 开启观看历史同步

深度拓展：高级功能与跨平台应用

核心价值：挖掘软件潜力，实现更高级的应用场景与跨设备体验

跨设备数据同步

1. 启用云同步功能

   # 生成同步配置文件
   touch ~/.config/wiliwili/sync.json
   

2. 配置同步服务

   {
     "enable_sync": true,
     "sync_server": "custom_server_url",
     "sync_interval": 3600
   }
   

插件系统使用

1. 安装插件管理器

   ./scripts/install_plugins.sh
   

2. 常用插件推荐：

   • 广告拦截插件：plugin_adblock
   • 自定义主题插件：plugin_theme_custom
   • 视频下载插件：plugin_downloader

常见场景问题速查表

问题场景	可能原因	解决方案
视频卡顿	网络带宽不足	切换至低清晰度，或使用缓存模式
手柄无响应	控制器未正确识别	重启应用，或重新映射按键
应用闪退	系统版本不兼容	升级破解系统至推荐版本
无法加载内容	DNS解析问题	手动设置公共DNS（如114.114.114.114）
音频不同步	硬件解码问题	在设置中切换至软件解码

总结与展望

wiliwili作为开源跨平台B站客户端，通过精心设计的手柄操作界面和硬件加速技术，为游戏设备带来了优质的视频观看体验。从基础部署到深度定制，用户可以根据自身需求逐步探索这款软件的全部潜力。随着社区的不断贡献，未来还将支持更多平台和功能，为开源视频客户端树立新的标准。

无论是在电视大屏上与家人共享视频，还是在掌机上随时随地追番，wiliwili都能提供适配场景的最佳解决方案，真正实现"一次部署，全平台畅享"的核心价值。