目錄

主题文档 - music Shortcode

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

有三种方式使用 music shortcode.

1 自定义音乐 URL

LoveIt 新增 | 0.2.10 支持本地资源引用的完整用法.

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 [可选]

    LoveIt 更改 | 0.2.0 音乐播放器的主题色, 默认值是 #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.