解锁Webamp的灵魂:如何切换与自定义Winamp经典皮肤(.wsz)
解锁Webamp的灵魂:如何切换与自定义Winamp经典皮肤(.wsz)
Webamp 是运行在浏览器中的 Winamp 2 复刻播放器,而切换与自定义 .wsz 皮肤正是它最出彩的功能:几乎任何经典 Winamp 2 皮肤都能在 Webamp 中逐像素还原。本文将手把手教你在 Webamp 中切换皮肤、配置 availableSkins 列表、用 initialSkin 指定启动皮肤,以及如何用 setSkinFromUrl 在运行时一键换装。
为什么 .wsz 皮肤是 Webamp 的灵魂 🎨
Winamp 2 时代的 .wsz 皮肤文件本质上是一个 ZIP 压缩包,里面装着 MAIN.BMP、GEN.BMP 等位图资源和 regions.ini 区域描述文件。Webamp 内置了完整的皮肤解析器(packages/webamp/js/skinParser.js),在浏览器里完成了解压、位图解析与区域渲染,还原度足以支撑一个线上"皮肤博物馆"项目。
如果你想了解官方对皮肤能力的完整描述,可以阅读 packages/webamp-docs/docs/05_features/05_skins.md。
3 步切换皮肤:使用 Options 菜单(零代码)
对于普通用户,Webamp 内置了与原版 Winamp 一致的换肤入口:
- 点击主窗口右上角的 Options 按钮;
- 选择 Skins 子菜单;
- 在列表中选择你想要的皮肤,或点击 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。
自定义启动皮肤: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。
运行时动态换肤: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 列表。
常见问题速查
| 问题 | 解决 |
|---|---|
| 皮肤加载失败、界面空白 | 检查 .wsz 文件是否带 CORS 头(见 CORS 指南) |
| 菜单里看不到我加的皮肤 | 确认传给构造器的是 availableSkins(注意拼写),且 url 可访问 |
| 想回到默认外观 | Options > Skins > <Base Skin>,或重启时省略 initialSkin |
| 换肤后窗口布局错乱 | 换肤后 Webamp 会按新皮肤尺寸重新布局,属正常现象 |
现在你已经掌握了 Webamp 的全部换肤姿势:菜单手动切换、availableSkins 预设清单、initialSkin 启动指定、setSkinFromUrl 运行时热换。挑一个心仪的经典皮肤,给你的 Webamp 换上独一无二的灵魂吧!



