扩展 Shortcode - music

注意
本文最后更新于 2023-02-26,文中内容可能已过时。

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

有三种方式使用 music shortcode。

1 自定义音乐 URL

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

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

  • server [必需]

    音乐的链接。

  • type [可选]

    音乐的名称。

  • artist [可选]

    音乐的创作者。

  • cover [可选]

    音乐的封面链接。

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

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

呈现的输出效果如下:

2 音乐平台 URL 的自动识别

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

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

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

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

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

呈现的输出效果如下:

3 自定义音乐平台,类型和 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 >}}

呈现的输出效果如下:

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

0%