浏览器端音频可视化器,从
SDL3 + FFmpeg版 Rysual 迁移到Web Audio API + Three.js。
线上地址:https://iLogIng.github.io/WebRysual/
技术栈
- TypeScript + Vite(无前端框架)
- Three.js
- Web Audio API
- Vitest
- 本地音频播放(多选)
- 播放列表:拖拽文件与目录、移除、自动下一首、循环、坏文件跳过
- Spectrum(48 个对数频段)与 Waveform(去直流 + RMS 亮度)
- 两种模式共用可配置渐变
- 进度条、拖动 seek、单曲无缝循环
- 图片壁纸(cover + 暗化)
- 全屏(Fullscreen API,空闲 3 秒隐藏光标)
- 解码/播放错误 toast
- 网络 URI 串流(延后)
- 播放速度(延后,需要不改变音高的方案)
- controls 图标化(延后)
- 3D / Bloom(P6)
- Simulated 模式:已移除
| 按键 | 功能 |
|---|---|
Space |
暂停 / 继续 |
, . / ← → |
后退 / 前进 5 秒 |
- = |
音量 -/+ 0.05 |
n p |
下一首 / 上一首 |
1 2 |
Spectrum / Waveform |
L |
播放列表显隐 |
F |
进入 / 退出全屏 |
H / ? |
快捷键提示 |
全屏使用 Fullscreen API;
Esc退出为浏览器保留行为。F11是浏览器窗口级快捷键,不作为应用控制。
npm run dev # 开发服务器
npm test # Vitest
npm run build # 类型检查 + 生产构建
npm run preview # 预览生产构建- 托管:GitHub Pages 项目页
- 地址:https://iLogIng.github.io/WebRysual/
- Vite
base:/WebRysual/ - 推送
master后,由.github/workflows/deploy.yml自动执行测试、构建并发布
| 阶段 | 内容 | 状态 |
|---|---|---|
| M0 | 脚手架、Stage、正交相机、DPR 与 Resize | 完成 |
| M1 | 音频引擎与传输控制 | 完成 |
| M2 | Waveform | 完成 |
| M3 | Spectrum | 完成 |
| M4 | 播放列表:拖拽、自动下一首、错误跳过 | 完成 |
| P0 | 面板收尾、目录拖拽、toast | 完成 |
| P1 | 共用渐变、两种模式渐变、图片壁纸 | 完成 |
| P2 | 全屏 API、空闲光标隐藏 | 完成 |
| P3 | 单元测试、README 同步、浏览器矩阵 | 完成(矩阵待实测) |
| P4 | 性能调优 | 延后 |
| P5 | 部署:GitHub Pages 项目页 | 完成 |
| P6 | 3D / Bloom | 待开始 |
原 M4 Simulated 已移除;原 M5 的全屏与目录拖拽已完成。
- HUD / controls 每帧 DOM 写入 → 10Hz 或变化时才写
- Waveform 预分配缓冲,避免每帧
setPositions分配 -
backdrop-filter在低端设备降级 - 目标:1080p 稳定 60fps
- 静态托管、Vite
base、HTTPS - GitHub Actions 自动部署
- 多面板 / 双窗口远期设计
- 设计:正交 ↔ 透视、柱子挤出、相机对 RMS 的反应
-
EffectComposer+UnrealBloomPass - 性能预算与降级路径
| 项 | 当前结论 |
|---|---|
| 播放速度 | 延后;不接受变调,需要 preservesPitch 或 DSP 方案 |
| 持久化 | 不提前设计;候选 AppConfig + 内置默认配置 + localStorage + 导入/导出 |
| 壁纸默认表现 | 当前为 cover + dim 0.35;是否暴露可调待定 |
| controls 图标化 | 延后 |
| 网络 URI 串流 | 延后 |
| 多面板 / 双窗口 | 远期 |
目标:Chrome / Edge 最新两版、Firefox 最新两版、Safari 最新版;移动端仅观察。
| 验证项 | Chrome / Edge | Firefox | Safari |
|---|---|---|---|
| 启动与 WebGL 渲染 | 待测 | 待测 | 待测 |
| 文件选择、多选、解码 | 待测 | 待测 | 待测 |
| 播放 / 暂停 / seek / 音量 | 待测 | 待测 | 待测 |
| 列表增删、自动下一首、坏文件跳过 | 待测 | 待测 | 待测 |
| 拖拽文件与目录 | 待测 | 待测 | 待测 |
| 全屏 / Esc / 光标隐藏 | 待测 | 待测 | 待测 |
| 壁纸加载 / 清除 / cover | 待测 | 待测 | 待测 |
| 键盘与面板焦点 | 待测 | 待测 | 待测 |
| 后台播放时自动切歌 | 待测 | 待测 | 待测 |
已知差异与处理:
| 项 | 差异 | 处理 |
|---|---|---|
.wma |
浏览器普遍不支持 | toast 跳过 |
| Ogg / Opus | Safari 版本差异 | 解码失败 → toast 跳过 |
| m4a / AAC | Firefox 依赖系统编解码 | 同上 |
| 全屏 | iOS 可能不支持任意元素全屏 | fullscreenEnabled 检测,按钮禁用 |
backdrop-filter |
旧版本不支持 | 纯色背景兜底 |
| 自动播放 | 所有浏览器都需要用户手势 | 首次交互解锁 AudioContext |
inert |
旧版本不支持 | 当前面向现代浏览器 |