Extended Shortcode - music

Note
This article was last updated on 2023-02-26, the content may be out of date.

The music shortcode embeds a responsive music player based on APlayer and MetingJS.

There are three ways to use it the music shortcode.

1 Custom Music URL

The complete usage of local resource references is supported.

The music shortcode has the following named parameters by custom music URL:

  • server [required]

    URL of the custom music.

  • name [optional]

    Name of the custom music.

  • artist [optional]

    Artist of the custom music.

  • cover [required]

    URL of the custom music cover.

Example music input by custom music URL:

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

The rendered output looks like this:

2 Music Platform URL Automatic Identification

The music shortcode has one named parameter by music platform URL automatic identification:

  • auto [required] (first positional parameter)

    URL of the music platform URL for automatic identification, which supports netease, tencent and xiami music platform.

Example music input by music platform URL automatic identification:

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

The rendered output looks like this:

3 Custom Server, Type and ID

The music shortcode has the following named parameters by custom music platform:

  • server [required] (first positional parameter)

    [netease, tencent, kugou, xiami, baidu]

    Music platform.

  • type [required] (second positional parameter)

    [song, playlist, album, search, artist]

    Type of the music.

  • id [required] (third positional parameter)

    Song ID, or playlist ID, or album ID, or search keyword, or artist ID.

Example music input by custom music platform:

1
2
3
{{< music server="netease" type="song" id="1868553" >}}
Or
{{< music netease song 1868553 >}}

The rendered output looks like this:

4 Other Parameters

The music shortcode has other named parameters applying to the above three ways:

  • theme [optional]

    Main color of the music player, default value is #448aff.

  • fixed [optional]

    Whether to enable fixed mode, default value is false.

  • mini [optional]

    Whether to enable mini mode, default value is false.

  • autoplay [optional]

    Whether to autoplay music, default value is false.

  • volume [optional]

    Default volume when the player is first opened, which will be remembered in the browser, default value is 0.7.

  • mutex [optional]

    Whether to pause other players when this player starts playing, default value is true.

The music shortcode has the following named parameters only applying to the type of music list:

  • loop [optional]

    [all, one, none]

    Loop mode of the music list, default value is none.

  • order [optional]

    [list, random]

    Play order of the music list, default value is list.

  • list-folded [optional]

    Whether the music list should be folded at first, default value is false.

  • list-max-height [optional]

    Max height of the music list, default value is 340px.

0%