给你的 WordPress 网站加点「音乐气息」！吸底播放器 + Jellyfin\Emby 音乐库 + PJAX 支持，一次搞定！
🔍 插件简介
APlayer Jellyfin 音乐播放器 是一款为 WordPress 打造的全站吸底播放器插件，基于开源播放器 APlayer 开发。通过对接本地或远程的 Jellyfin 或Emby 媒体服务器，你可以将自己的音乐库直接引入到 WordPress 网站中播放，并配合 PJAX 实现切换页面不断播、localStorage 实现播放列表缓存。
✨ 插件功能亮点
- 🎧 对接 Jellyfin、Emby 音乐库，支持 MP3、FLAC、AAC 等格式
- 📌 全站吸底播放器，始终固定在页面底部
- 🖼 自动加载专辑封面，美观实用
- 📂 仅加载指定音乐库下的音轨，不会加载全部媒体资源
- 🧠 使用 localStorage 缓存歌曲列表，减少请求次数
- 🛠 支持 PJAX 页面加载，播放器不中断，内容无刷新切换
- 🎛 完整 APlayer 控件：暂停、播放、切歌、音量、展开播放列表等功能一应俱全
🧩 安装步骤
- 下载插件文件，上传到 WordPress 的
/wp-content/plugins/目录 - 后台启用插件
- 打开
设置 > APlayer Jellyfin页面，填写相关配置信息 - 保存后，刷新页面即可看到底部播放器自动加载
⚙️ 配置说明
进入插件后台设置页，填写以下字段：
- Jellyfin Server URL：你的 Jellyfin 地址，如
http://localhost:8096 - User ID：在 Jellyfin 中播放音乐的用户 ID
- API Key：用户的 API 密钥
- Device ID：设备标识，自定义字符串即可
- Music Library ID：你想用于播放的音乐库 ID（仅支持一个）
🧠 插件工作原理与细节说明
- 播放器固定在底部，始终可见，可展开查看播放列表
- 所有交互功能使用 APlayer 原生控制（如播放/暂停/音量等）
- 插件会在加载后自动拉取 指定音乐库下的所有音轨，无需额外操作
- 使用 PJAX 自动拦截
id="content"容器内的链接，使页面切换不中断播放 - 播放列表保存于 localStorage，刷新或跳转后自动还原
🧑💻 开源地址与下载
该插件已开源，欢迎参与开发或提交 Issue：
📌 使用注意事项
- 确保 Jellyfin 服务器运行且 WordPress 能访问
- 使用 API Key 前请在 Jellyfin 后台为对应用户创建密钥
- 当前仅支持加载一个音乐库中的音轨，不支持多库混合
- 插件仅提供全站吸底播放器，不支持嵌入文章中使用
- 当前版本暂不支持播放器的不间断播放功能。如需实现该效果，请配合使用 OOW PJAX 插件。