解锁Webamp的灵魂:如何切换与自定义Winamp经典皮肤(.wsz)

原创2026-09-21 15:08:311,392 阅读
文章标签:前端音视频

解锁Webamp的灵魂:如何切换与自定义Winamp经典皮肤(.wsz)

Webamp 是运行在浏览器中的 Winamp 2 复刻播放器,而切换与自定义 .wsz 皮肤正是它最出彩的功能:几乎任何经典 Winamp 2 皮肤都能在 Webamp 中逐像素还原。本文将手把手教你在 Webamp 中切换皮肤、配置 availableSkins 列表、用 initialSkin 指定启动皮肤,以及如何用 setSkinFromUrl 在运行时一键换装。

Webamp 皮肤博物馆中收集的海量 Winamp 经典皮肤

为什么 .wsz 皮肤是 Webamp 的灵魂 🎨

Winamp 2 时代的 .wsz 皮肤文件本质上是一个 ZIP 压缩包,里面装着 MAIN.BMP、GEN.BMP 等位图资源和 regions.ini 区域描述文件。Webamp 内置了完整的皮肤解析器(packages/webamp/js/skinParser.js),在浏览器里完成了解压、位图解析与区域渲染,还原度足以支撑一个线上"皮肤博物馆"项目。

Webamp 在浏览器中渲染 Winamp 经典皮肤与 Milkdrop 可视化的演示

如果你想了解官方对皮肤能力的完整描述,可以阅读 packages/webamp-docs/docs/05_features/05_skins.md。

3 步切换皮肤:使用 Options 菜单(零代码)

对于普通用户,Webamp 内置了与原版 Winamp 一致的换肤入口:

  1. 点击主窗口右上角的 Options 按钮;
  2. 选择 Skins 子菜单;
  3. 在列表中选择你想要的皮肤,或点击 Load Skin... 从本地加载一个 .wsz 文件。

该菜单由 packages/webamp/js/components/SkinsContextMenu.tsx 实现,菜单中会显示:

  • Load Skin...:弹出文件选择器加载本地皮肤;
  • <Base Skin>:恢复 Webamp 自带的默认皮肤(base-2.91,源码位于 packages/webamp/assets/skins/base-2.91/);
  • 你在初始化时通过 availableSkins 配置的每个皮肤,都会以名字列出,点击即切换。

配置 availableSkins:让多个皮肤出现在菜单里

在创建 Webamp 实例时,传入 availableSkins 数组即可把皮肤加入 Options > Skins 菜单:

const webamp = new Webamp({
  availableSkins: [
    { url: "./green.wsz", name: "Green Dimension V2" },
    { url: "./osx.wsz", name: "Mac OSX v1.5 (Aqua)" },
  ],
});

一个可以直接在浏览器中打开的完整示例在 examples/multipleSkins/index.html,它用 3 个经典皮肤演示了多皮肤切换。官方 Demo 项目中的皮肤清单实现可参考 packages/webamp-demo/js/availableSkins.ts。

⚠️ 注意:皮肤文件必须通过正确的 CORS 头提供,否则浏览器会拒绝加载,详见 packages/webamp-docs/docs/07_guides/01_cors.md。

Webamp 演示页面中加载不同 Winamp 皮肤后的效果

自定义启动皮肤:initialSkin 参数

如果希望 Webamp 一打开就显示某个皮肤,使用构造器选项 initialSkin(不设置时使用包内默认皮肤):

const webamp = new Webamp({
  initialSkin: { url: "./my-skin.wsz" },
});

官方 Demo 就是这样根据 URL 参数动态指定初始皮肤的,逻辑位于 packages/webamp-demo/js/webampConfig.ts。完整的构造器选项说明见 packages/webamp-docs/docs/06_API/02_webamp-constructor.md。

Webamp 均衡器窗口使用皮肤渲染位图控件的效果

运行时动态换肤:setSkinFromUrl 方法

页面运行中也可以随时换装——调用实例方法 setSkinFromUrl(url) 即可。皮肤加载是异步的,可用 skinIsLoaded() 等待完成:

webamp.setSkinFromUrl("./another-skin.wsz");
await webamp.skinIsLoaded();

方法签名与更多细节可查 packages/webamp-docs/docs/06_API/03_instance-methods.md 中的 setSkinFromUrl 与 skinIsLoaded 小节。

去哪里找经典 .wsz 皮肤:Webamp Skin Museum 🏛️

想换的素材去哪找?项目自带的 packages/skin-database/ 包维护着一个线上皮肤数据库(Webamp Skin Museum),支持按名称浏览、上传、截图预览与 GraphQL 查询,其说明见 packages/skin-database/README.md。数据库中的皮肤会同步到存档站,并可通过 Internet Archive 的 CORS 端点直接加载到 Webamp 中,非常适合用来充实你的 availableSkins 列表。

Winamp Skin Museum 皮肤数据库页面

常见问题速查

问题 解决
皮肤加载失败、界面空白 检查 .wsz 文件是否带 CORS 头(见 CORS 指南)
菜单里看不到我加的皮肤 确认传给构造器的是 availableSkins(注意拼写),且 url 可访问
想回到默认外观 Options > Skins > <Base Skin>,或重启时省略 initialSkin
换肤后窗口布局错乱 换肤后 Webamp 会按新皮肤尺寸重新布局,属正常现象

现在你已经掌握了 Webamp 的全部换肤姿势:菜单手动切换、availableSkins 预设清单、initialSkin 启动指定、setSkinFromUrl 运行时热换。挑一个心仪的经典皮肤,给你的 Webamp 换上独一无二的灵魂吧!

登录后查看全文
webamp