扩展 Shortcode - Music

music shortcode 基于 APlayer 和 MetingJS 提供了一个内嵌的响应式音乐播放器。

有三种方式使用 music shortcode。

自定义音乐 URL

支持 本地资源引用 的完整用法。

music shortcode 有以下具名参数来使用自定义音乐 URL:

• server [必需]

  音乐的链接。

• type [可选]

  音乐的名称。

• artist [可选]

  音乐的创作者。

• cover [可选]

  音乐的封面链接。

一个使用自定义音乐 URL 的 music 示例：

1

{{< music url="/music/Wavelength.mp3" name=Wavelength artist=oldmanyoung cover="/images/Wavelength.webp" >}}

呈现的输出效果如下：

音乐平台 URL 的自动识别

music shortcode 有一个具名参数来使用音乐平台 URL 的自动识别：

• auto [必需]]（第一个位置参数）

  用来自动识别的音乐平台 URL, 支持 netease, tencent 和 xiami 平台。

一个使用音乐平台 URL 的自动识别的 music 示例：

1
2
3

{{< music auto="https://music.163.com/#/playlist?id=60198" >}}
或者
{{< music "https://music.163.com/#/playlist?id=60198" >}}

呈现的输出效果如下：

自定义音乐平台，类型和 ID

music shortcode 有以下具名参数来使用自定义音乐平台：

• server [必需]（第一个位置参数）

  [netease, tencent, kugou, xiami, baidu]

  音乐平台。

• type [必需]（第二个位置参数）

  [song, playlist, album, search, artist]

  音乐类型。

• id [必需]（第三个位置参数）

  歌曲 ID, 或者播放列表 ID, 或者专辑 ID, 或者搜索关键词，或者创作者 ID。

一个使用自定义音乐平台的 music 示例：

1
2
3

{{< music server="netease" type="song" id="1868553" >}}
或者
{{< music netease song 1868553 >}}

呈现的输出效果如下：

其它参数

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。