很多用 Zibll 主题的站长都想在站点里挂一个音乐播放器：访客逛站的时候能听歌，页面有氛围，自己也喜欢。市面上的方案要么样式老旧、要么和主题风格不搭、要么功能残缺。Zib Music 音乐播放器就是为解决这个问题而写的——一个专门面向 Zibll 主题的独立插件，装上就能用。

悬浮播放器 + 悬浮歌词

播放器入口挂在页面右侧的悬浮按钮区，点击后弹出播放面板，不遮挡正文。播放时页面底部正中会显示当前歌词，前一句、后一句一同带出，翻行时有平滑的滑动动画；暂停或展开播放器时自动隐藏，不打扰阅读。

网易云一键导入

不用手动填歌名、歌手、封面。粘贴网易云歌单或单曲的 ID（也可以直接粘贴分享链接），点一下「导入」，歌名、歌手、封面、时长全部自动填好，一次最多导入 500 首。导入的列表可以直接在后台调整顺序、启用/停用单首歌。

三种接口模式，稳定可配

• 自动（默认）：优先使用自建 API，失败时自动回退到内置公开直连；
• 内置公开直连：什么都不用配，开箱即用；
• 自建 API：填写自己部署的 NetEaseCloudMusicApi 根地址，走自己的接口更稳。

另外可选填网易登录 Cookie（MUSIC_U 等），登录态由服务端保管，可以提升受限歌曲的可播率。

也支持本地音频

除了网易云，还可以直接从媒体库上传音频、封面和 LRC 歌词文件，完全自控的歌单。LRC 可以贴文本也可以传文件，上传歌曲还可以填对应的网易 ID 自动抓歌词。

三种封面样式 + 极光配色

弹窗封面支持三种样式：圆角方形、旋转唱片、方形封面露出唱片。播放器还会根据当前歌曲自动生成一组「极光」渐变底色，切歌时配色跟着变，每一首都有自己的颜色。

播放状态记忆

播放到一半关掉页面，短时间内回来会自动续播上次的歌、上次的进度；展开/收起状态、音量、每首歌的实际时长也都会记住。列表不自动跳来跳去，正在播的歌始终看得见。

配置备份，放心折腾

后台支持播放器配置的一键备份、恢复、JSON 导入导出和重置。导入、重置、恢复前会自动创建快照，最多保留 20 份，折腾配置不再怕翻车。

安装与使用

1. 把完整的 zib-music 目录放到 wp-content/plugins/，在后台启用「Zib Music 音乐播放器」；
2. 打开后台的「Zib Music」，按需勾选启用播放器、悬浮歌词，选好封面样式和接口模式；
3. 在「歌曲管理」粘贴网易云歌单/单曲链接点「导入」，或者手动添加上传歌曲；
4. 保存后回到前台，右侧悬浮区就会出现音乐按钮，点击开始听歌。

常见问题

Q：所有歌都能播放吗？
A：部分歌曲受版权、VIP 或地区限制，只能播放官方试听片段或直接跳过，播放失败会自动切下一首并提示。填了网易登录 Cookie 后可播范围会更大。

Q：非 Zibll 主题能用吗？
A：不能。插件依赖 Zibll 主题的悬浮按钮区等特性，非 Zibll 环境只会显示依赖提示。

Q：会拖慢网站吗？
A：播放器脚本和样式只在功能开启且有歌曲时才加载，网易云接口的请求结果在服务端有缓存，前台歌词也有浏览器缓存。