这篇文章用来检查本站的 Music 音乐播放器代码块。下面会覆盖平台音乐、本地音频、直链音频、自动识别链接和错误态,方便以后调整播放器逻辑时做回归确认。

当前实现支持本地或直链音频、平台 URL 自动识别、server/type/id 平台音乐,以及 apinameartistcoverlrclrcTypethemefixedminiautoplayvolumemutexlooporderpreloadlistFoldedlistMaxHeight 这些参数。

平台音乐依赖 MetingJS 和第三方音乐接口,能否播放会受到接口、版权和地区限制影响;本地或直链音频只依赖音频地址本身。已知现状(2026-09):

  • MetingJS 内置的默认接口 api.i-meto.com 已完全无响应,本站改用备用实例(见 src/scripts/article-music.tsmetingApiDefault);
  • 该实例对 album 类型返回 400,所以下面的平台专辑会走失败态;song / playlist / artist / search 正常;
  • 播放器 10 秒内没长出来会显示「音乐播放器加载失败」——MetingJS 自己既无超时也无错误回调,没有这个看门狗就会是一个看不见的空位。

平台单曲

源码:

md
```music
server=netease type=song id=22773511
```

效果:

平台歌单

源码:

md
```music
server=netease type=playlist id=60198 listFolded=true listMaxHeight=240px
```

效果:

平台专辑

源码:

md
```music
server=netease type=album id=32311
```

效果:

平台歌手

源码:

md
```music
server=netease type=artist id=10559
```

效果:

平台搜索

源码:

md
```music
server=netease type=search id="中島みゆき 時代" listFolded=true
```

效果:

自动识别链接

源码:

md
```music
auto=https://music.163.com/#/playlist?id=60198
```

效果:

自动识别链接简写

单独写一个平台 URL 时,会按 auto 解析。

源码:

md
```music
https://music.163.com/#/song?id=22773511
```

效果:

其他平台源

源码:

md
```music
server=tencent type=song id=001Qu4I30eVFYb
```

效果:

本地或直链音频

源码:

md
```music
url=https://cdn.jsdelivr.net/gh/DIYgod/APlayer@master/docs/demo.mp3
name=Demo
artist=APlayer
preload=metadata
```

效果:

自定义主题色

源码:

md
```music
url=https://cdn.jsdelivr.net/gh/DIYgod/APlayer@master/docs/demo.mp3
name="Theme Demo"
artist=APlayer
theme=#4f8f8b
volume=0.7
mutex=true
```

效果:

简写平台参数

如果只写三个非 key=value 参数,会按 server type id 解析。

源码:

md
```music
netease playlist 60198
```

效果:

错误态

非法平台或类型会直接显示配置错误,方便在写文章时定位问题。

源码:

md
```music
server=unknown type=playlist id=60198
```

效果: