wiliwili跨平台B站客户端如何部署到Switch、PSVita、PS4与PC完整指南【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwiliwiliwili 是一个专为手柄操控设计的第三方 B 站客户端属于跨平台 B 站客户端可运行在 Nintendo Switch、PSVita、PS4 与 Windows、macOS、Linux 等 PC 全平台。它把浏览、搜索、播放、登录同步等 B 站常用功能搬进了手柄交互体系你不必在设备上装模拟器或装浏览器装好对应的应用包即可用方向键加 A 键完成绝大多数操作。一、项目定位它解决什么问题官方 B 站客户端以触屏和键鼠为中心放在掌机、主机上基本不可用浏览器方案则页面臃肿、无法按键操作。wiliwili 面向的问题正是在只能靠手柄操作的设备上看 B 站界面按方向键逐格导航A 键确认、B 键返回与游戏操作习惯一致无需学习额外快捷键同一套代码适配多平台图形与输入后端nanovg 绘制界面mpv FFmpeg 负责播放手柄、触屏、鼠标、键盘均可操控功能覆盖接近官方 PC 客户端热搜与搜索、番剧/影视筛选、动态、直播、弹幕与评论、扫码登录与个人内容同步。从 源码目录 的分层结构可以看出其按页面Activity—子页Fragment—数据Presenter—组件View—接口API组织页面之间通过统一的 Intent 跳转见 wiliwili/include/utils/activity_helper.hpp这也是它能在不同平台保持一致交互体验的基础。二、支持平台一览平台运行形态输入方式备注Nintendo Switchwiliwili.nro大气层环境手柄 / 触屏默认 OpenGL 版另有 deko3d 版支持原生图形接口PSVitawiliwili-PSVita.vpk自制系统环境手柄 / 触屏GXM 原生渲染版与 OpenGL ES 2.0 版PS4wiliwili-PS4.pkg自制系统环境手柄仅软件解码Windows7独立 exe / 安装包手柄、键鼠、触屏支持 Scoop 安装macOS10.11独立 app / 安装包手柄、键鼠、触屏支持 Homebrew 依赖本地构建Linux含 Steam Deck安装包 / Flathub / 包管理器手柄、键鼠、触屏支持 AUR、Fedora Copr 等渠道多语言支持简中、繁中、日、韩、英、意等可在应用内切换翻译文件位于 resources/i18n/。三、部署全流程3.1 环境准备Nintendo Switch大气层Atmosphere与系统固件更新到最新版内存卡格式为 FAT32确认已安装 hbmenu从任意游戏进入。PSVita已刷入对应自制系统如 GoldHEN / OrbisHEN 等PS4已具备可安装 pkg 的自制系统环境如 devkit 调试菜单。PCWindows 7 及以上、macOS 10.11 及以上或主流 Linux 发行版Steam Deck 走 Linux 渠道即可。网络B 站接口对 DNS 与系统时间敏感出发前确认设备联网正常、系统时间正确。3.2 获取与安装Switch从 Releases 下载wiliwili-NintendoSwitch.zip解压得到wiliwili.nro放入内存卡switch目录sdmc:/switch/wiliwili.nro或sdmc:/switch/wiliwili/wiliwili.nro均可。PSVita下载wiliwili-PSVita.vpk在 VitaShell 等工具中安装。PS4下载wiliwili-PS4.pkg通过调试菜单安装。PC下载对应系统的安装包直接运行Linux 与 Steam Deck 用户可直接在系统软件商店Discover、GNOME Software 等中搜索wiliwiliWindows 可选 Scoop、Arch 用户可选 AUR、Fedora 用户可选 Copr。如需从源码构建例如想切换底层 ffmpeg/mpv 依赖先拉取代码git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili cmake -B build -DPLATFORM_DESKTOPON # 以桌面端为例主机平台见 README 中 Docker 构建命令 make -C build wiliwili各平台交叉编译细节与构建脚本说明见 scripts/README.md 及 scripts/ 目录。3.3 首次运行验证Switch在任意游戏运行中按住 R 键打开 hbmenu选中 wiliwili 按 A 启动上图即 hbmenu 选择 wiliwili 的过程。PSVita / PS4 / PC在系统列表或桌面点击应用图标启动。验证点首页推荐流能加载出视频卡片、顶部搜索框可输入、设置页的网络诊断显示正常即说明安装完成。可选Switch 上按 设置 → 实用工具 → 使用教程 内的提示安装桌面图标NSP forwarder 会自动尝试switch/wiliwili.nro与switch/wiliwili/wiliwili.nro两个位置之后可直接从主页启动。四、功能全景按使用动线走一遍打开首页与页签首页提供 直播、推荐、热门、追番、影视 五个页签方向键左右切换其中热门带 全榜 / 每周榜 / 历史榜 / 地区榜 四个二级菜单截图左上为热搜榜、右上为影视分类。推荐页为竖图与横图混排的信息流影视页则提供 地区、风格、年代、付费类型、配音类型、完结状态、季度 等完整筛选项见第六节的截图。首页误触返回直接退出的问题可通过设置里的防误触选项解决。找片搜索与筛选搜索入口在首页顶部PC 上默认CtrlF。搜索页包含 热搜、历史 标签支持 视频 / 番剧 / 影视 / 用户 分类番剧与影视结果以竖图卡片呈现可切换 综合 / 最新 / 最多播放 / 最多点击 / 最多收藏 排序。影视筛选面板支持按 综合排序、最多播放、最多收藏、最近更新、最高评分 以及 美国/日本/韩国 等地区与风格标签组合过滤。看片播放页播放页覆盖 视频、番剧、电影、纪录片、综艺 全类型能力包括弹幕D 键开关、完整评论区、点赞/投币/收藏、拖拽进度条、清晰度与倍速菜单F2/F3 键、分集列表、UP 主最新投稿、合集与相关推荐。番剧播放时右侧展示任务分集可逐集跳转播放页底部常驻按键提示方便确认当前可执行的操作。管片源个人中心说明上图为影视筛选界面。个人中心我的页签通过扫码登录绑定 B 站账号后可同步 历史记录、稍后再看、收藏夹、我的追番、我的追剧动态页则展示关注的 UP 主最近视频与投稿适合登录后按天追更。同步偏好设置与个性化主题深浅两色主题可跟随系统自动切换语言简、繁、日、韩、英等多语言应用内直接切换网络代理地址与 TLS 证书校验开关配合 设置 → 实用工具 → 网络诊断 使用播放硬件解码方式、画质档位、Anime4K 档位见第六节外观自定义字体、图标、按键图标样式xbox/ps/keyboard以及把快捷键绑定到自己的习惯按键上所有设置保存在配置目录的wiliwili_config.json含登录凭据与全部设置项目录位置见下节换设备时可自行整理。五、手柄键位与操作参考按键功能方向键 / 左摇杆上下左右导航、滚动列表A确认进入、播放、选中B返回返回上一页、关闭菜单触屏 / 鼠标触屏点击PC 上左键点击、右键返回、中键刷新X / Y播放页辅助操作具体以播放页底部实时按键提示为准重压摇杆临时快进按住期间生效拖拽进度条调节播放进度触屏 / 鼠标PC 端播放页快捷键默认值均支持在 设置 中重新绑定定义见 wiliwili/include/utils/shortcut_helper.hpp按键功能空格播放 / 暂停[/]快退 / 快进p提高倍速0/9音量增大 / 减小d弹幕开关f1视频详情面板f2清晰度菜单f3倍速菜单f4播放列表分集f5设置页o播放 OSD 信息PageUp/PageDn左 / 右切换页签ShiftPageUp/ShiftPageDn切换二级菜单热门、追番、影视CtrlRmacOS 为CmdR刷新当前页CtrlFmacOS 为CmdF打开搜索不确定某个页面上能做什么操作时看屏幕底部的按键提示条即可它是全局生效的。六、体验优化播放能力与默认表现Switch默认 OpenGL 版最高 4K30追求 4K60 可换用 deko3d 构建版原生图形接口偶发不稳定。PSVitaGXM 版为推荐版本开启硬件解码后横屏 720P、竖屏 480P 可流畅播放部分直播 1080P 原画可用。PS4仅软件解码播放 4K60 需在 设置 → 播放 中开启低画质解码。PC默认auto-safe硬件解码并可手动切换配置较低的电脑可关闭硬解以换稳定。画质档位可选 8K、4K、1080P60、1080P、720P、480P、360P未登录时默认 360P登录后默认 1080P60。画质档位、硬解方式都集中在 设置 → 播放 分组Anime4K 等效果通过配置目录下的shader.json定义档位甚至可按番剧 ID 绑定专属档位结构说明见 wiliwili/include/utils/shader_helper.hpp。文件组织各平台配置目录存放wiliwili_config.json、自定义字体/图标/主题与手柄映射平台路径Switch/config/wiliwili/PSVitaux0:/data/wiliwili/PS4/data/wiliwili/macOS~/Library/Application Support/wiliwili/Linux~/.config/wiliwili/Windows%LOCALAPPDATA%\xfangfang\wiliwili\把font.ttf、icon.ttf等文件放入配置目录即可替换内置字体与按钮图标PC 端还可放入gamecontrollerdb.txt改进手柄识别。网络调校B 站接口对 DNS 与系统时间敏感排查网络问题前先确认系统时间正确、DNS 正常使用了代理的话在 设置 → 网络 中配置代理或临时关闭后再测。诊断入口设置 → 实用工具 → 网络诊断它会给出接口连通性、时间差、WiFi 状态与 DNS 信息。七、问题排查现象可能原因处理办法Switch 启动黑屏或长时间卡启动画面大气层/固件过旧或配置文件损坏更新大气层与系统固件到最新、确认内存卡为 FAT32删除内存卡config/wiliwili目录后重启应用无法连接 B 站 / 加载失败系统时间错误、DNS 异常、代理干扰校正系统时间与网络设置运行 设置 → 实用工具 → 网络诊断 并保存截图有代理的先关闭再测Switch 播放 4K60 掉帧默认 OpenGL 版上限为 4K30换用 deko3d 构建版或在播放设置中调低清晰度档位PS4 高码率播放卡顿仅支持软解在 设置 → 播放 中开启低画质解码或降低清晰度档位PSVita 播放卡顿未开启硬件解码开启硬解横屏建议 720P、竖屏建议 480P 以内界面字体、图标异常自定义字体/主题不匹配移除配置目录中对应的font.ttf、icon.ttf或主题目录后重启按键图标可在设置中切换 xbox / ps / 键盘样式向社区反馈问题前建议先按上面条目自查一遍并附上网络诊断截图与问题复现步骤。八、结语wiliwili 把用 B 站这件事完整搬到了游戏主机与掌机上从首页浏览、搜索筛选到播放互动、登录同步全部可以用手柄完成并且各平台的默认参数解码方式、画质档位已经按设备能力做了区分。项目基于 C17 构建采用 borealis/nanovg 界面框架与 mpv FFmpeg 播放栈源码结构清晰如果你有改进想法、想参与新设备移植或补充多语言翻译欢迎通过仓库的 issue 与讨论区交流也可以为翻译提订正。【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考