扩展 Shortcode - music
Lruihao
music shortcode 基于 APlayer 和 MetingJS 提供了一个内嵌的响应式音乐播放器。
有三种方式使用 music shortcode。
1 自定义音乐 URL
支持 本地资源引用 的完整用法。
music shortcode 有以下命名参数来使用自定义音乐 URL:
server [必需]
音乐的链接。
type [可选]
音乐的名称。
artist [可选]
音乐的创作者。
cover [可选]
音乐的封面链接。
一个使用自定义音乐 URL 的 music 示例：
| |
呈现的输出效果如下：
2 音乐平台 URL 的自动识别
music shortcode 有一个命名参数来使用音乐平台 URL 的自动识别：
auto [必需]]（第一个位置参数）
用来自动识别的音乐平台 URL, 支持
netease,tencent和xiami平台。
一个使用音乐平台 URL 的自动识别的 music 示例：
| |
呈现的输出效果如下：
3 自定义音乐平台，类型和 ID
music shortcode 有以下命名参数来使用自定义音乐平台：
server [必需]（第一个位置参数）
[
netease,tencent,kugou,xiami,baidu]音乐平台。
type [必需]（第二个位置参数）
[
song,playlist,album,search,artist]音乐类型。
id [必需]（第三个位置参数）
歌曲 ID, 或者播放列表 ID, 或者专辑 ID, 或者搜索关键词，或者创作者 ID。
一个使用自定义音乐平台的 music 示例：
| |
呈现的输出效果如下：
4 其它参数
music shortcode 有一些可以应用于以上三种方式的其它命名参数：
theme [可选]
音乐播放器的主题色，默认值是 #448aff。fixed [可选]
是否开启固定模式，默认值是
false。mini [可选]
是否开启迷你模式，默认值是
false。autoplay [可选]
是否自动播放音乐，默认值是
false。volume [可选]
第一次打开播放器时的默认音量，会被保存在浏览器缓存中，默认值是
0.7。mutex [可选]
是否自动暂停其它播放器，默认值是
true。
music shortcode 还有一些只适用于音乐列表方式的其它命名参数：
loop [可选]
[
all,one,none]音乐列表的循环模式，默认值是
none。order [可选]
[
list,random]音乐列表的播放顺序，默认值是
list。list-folded [可选]
初次打开的时候音乐列表是否折叠，默认值是
false。list-max-height [可选]
音乐列表的最大高度，默认值是
340px。