YGZ Music Widget - WordPress Music Player Plugin

Core Features

多平台支持

支持网易云音乐、QQ音乐、酷狗音乐、虾米音乐、百度音乐等主流音乐平台

多种类型

支持单曲、歌单、专辑、歌手、搜索等多种播放类型

自定义主题

支持自定义主题色，轻松匹配您的网站风格

歌词显示

内置歌词显示功能，让音乐体验更加丰富

多种模式

支持吸底模式、迷你模式，灵活适配各种场景

响应式设计

完美适配各种设备，提供一致的用户体验

Supported Music Platforms

网易云音乐

QQ音乐

酷狗音乐

虾米音乐

百度音乐

Installation

1

下载插件

下载 aplayer-meting-widget 插件包

2

上传安装

将插件上传到 WordPress 的 /wp-content/plugins/ 目录

3

启用插件

在 WordPress 后台"插件"菜单中启用插件

4

添加小工具

进入"外观" → "小工具"，将播放器添加到侧边栏

Download Plugin

如何获取歌单ID

在浏览器中打开歌单页面，查看URL中的数字部分

https://music.163.com/#/discover/toplist?id=3778678

URL中的数字部分（3778678）就是歌单ID

Configuration Options

音乐平台

选择音乐来源：网易云音乐、QQ音乐、酷狗音乐、虾米音乐、百度音乐

播放类型

选择要播放的内容类型：单曲、歌单、专辑、歌手、搜索

ID配置

输入歌曲/歌单/专辑的ID，在音乐平台页面URL中可以找到

音量控制

设置默认音量（0-1之间），播放器会记住用户设置

主题色

自定义播放器主题颜色，使用颜色选择器轻松选择

循环模式

选择全部循环、单曲循环或不循环

播放顺序

选择列表顺序或随机播放

预加载

设置音频预加载方式：自动、仅元数据或无

歌词显示

选择是否显示歌词，支持多种歌词类型

列表高度

设置播放列表的最大高度，默认340px

自动播放

勾选后页面加载时自动播放（可能被浏览器阻止）

折叠列表

勾选后默认折叠播放列表

吸底模式

勾选后播放器固定在页面底部

迷你模式

勾选后显示迷你播放器，节省空间

互斥播放

勾选后播放此播放器时自动暂停其他播放器

Frequently Asked Questions

为什么自动播放不工作？

现代浏览器通常会阻止音频自动播放以改善用户体验。这是浏览器的安全策略，不是插件的问题。建议不要依赖自动播放功能。

支持哪些音乐平台？

目前支持：网易云音乐、QQ音乐、酷狗音乐、虾米音乐、百度音乐。我们会持续更新以支持更多平台。

如何更改播放器主题色？

在小工具设置中找到"主题色"选项，点击颜色选择器选择您喜欢的颜色即可。主题色会立即应用到播放器上。

可以在页面中放置多个播放器吗？

可以，您可以在侧边栏或其他小工具区域添加多个播放器。但建议开启"互斥播放"选项，这样播放其中一个时会自动暂停其他播放器，避免多个音频同时播放。

插件需要依赖外部CDN吗？

不需要！插件已将所有必需的资源文件（APlayer.min.css、APlayer.min.js、Meting.min.js）集成到插件中，完全本地运行，不依赖任何外部CDN，确保稳定性和可靠性。

插件兼容哪些WordPress版本？

插件兼容 WordPress 5.0 及以上版本，已测试至 WordPress 6.4。需要 PHP 7.0 或更高版本。