Rockbox WPS 播放界面 - While Playing Screen 的自定义

WPS 是什么

WPS（While Playing Screen） 是 Rockbox 播放音乐时默认显示的界面——你正在听歌时看到的那个屏幕。原厂固件叫它「Now Playing」，Rockbox 社区习惯叫 WPS。

WPS 是 Rockbox 最常看的界面，也是主题定制的主战场——Rockbox 主题包的核心就是 .wps 配置文件。

WPS 能显示什么

默认主题的 WPS 会显示：

• 状态栏：电量、充电状态、音量、Hold 锁定、系统状态图标
• 进度条：当前播放进度，Cue Sheet 模式下还会显示分轨标记点
• 歌曲信息：艺人 / 专辑 / 曲目标题（从 ID3 标签读取）
• 播放控制：播放/暂停/快进/快退图标
• 音量条：当前音量
• 正在播放的频谱：部分主题带实时音频频谱可视化

切换 WPS

Settings → Theme Settings → Load WPS

每个主题包通常自带 1~N 个 WPS 变体：

• 默认 WPS（基本信息版）
• 带大封面的 WPS
• 带频谱的 WPS
• 极简 WPS（只显示进度和曲目名）

选择后实时切换，不需要重启 DAP。

WPS 里能放哪些信息

Rockbox 的 WPS 配置语言（Rockbox WPS Language，不是 HTML/CSS）支持以下信息类型：

自动切换 WPS 变体

部分主题支持根据播放状态自动切换：

• Hold 开启时 → 显示极简 WPS（减少误触）
• 封面可用时 → 显示带大封面的 WPS
• 暂停时 → 显示暂停状态 WPS
• 充电中时 → 显示充电状态 WPS

这些条件判断在 .wps 配置文件里用 Rockbox 条件语句实现。

自定义 WPS

有两种方式自定义：

方式一：用 Rockbox WPS 编辑器（电脑上）

下载 Rockbox 社区提供的 WPS 编辑器（Windows 上常见的有 WPS Viewer / SBS WPS Editor 等），图形化拖拽界面元素，导出 .wps 文件放 .rockbox/wps/ 目录下。

方式二：直接改 .wps 文件

Rockbox WPS 文件是纯文本，用文本编辑器就能改。最简单的改动——把某个字段的显示位置调整一下、换个颜色。

语法参考 Rockbox 官方 Wiki 的 WPS Tags 页面——所有可用的占位符（%ar = 艺人、%al = 专辑、%in = 音轨号）都有详细说明。

WPS vs SBS

Rockbox 界面分两大部分：

• SBS（Screen Based Skin）：主菜单界面、文件浏览器界面（静态）
• WPS：正在播放界面（动态）

主题包通常同时包含 .sbs（菜单）和 .wps（播放屏）两个配置文件。

没有主题时

Rockbox 自带 Default Theme——极简风格、小字体、适合所有分辨率屏幕。装了 Rockbox 字体包后（见 字体管理），Default Theme 会自动用更清晰的字体。