Music Player

Music-Player

本站音乐默认 本地曲库，不依赖公共 Meting。

	官方出厂（docs/official/03-功能配置/音乐播放器.md）	本站
mode	文档写默认 "meting"	"local"
决策	—	docs/adr/0002-local-music-default.md

Meting 字段仍保留在配置里：把 mode 改回 "meting" 可手工切回（公共 API 可能失效）。

配置入口

src/config/musicConfig.ts（导出名多为 musicPlayerConfig）

键	本站习惯
showInNavbar	导航栏音符入口（音频面板）
showInSidebar	还须 sidebarConfig 里 type: "music" 且 enable
mode	"local"（默认）
local.playlist	本地清单
meting.*	仅 mode === "meting" 时生效

侧栏音乐组件本站可能是关的——以 sidebarConfig 现行值为准；顶栏音符仍可开。

加一首本地歌

官方本地模式步骤仍适用，本站路径约定：

1. 把 mp3（及可选封面/歌词）放到 public/assets/music/（封面建议 cover/，歌词建议 lrc/）
2. 在 musicPlayerConfig 的 playlist 追加：name / artist / url / cover? / lrc?
3. url、cover 用站点根路径，如 "/assets/music/xxx.mp3"；也可 https:// 远程
4. 无歌词则 lrc: ""

完整字段表见官方 音乐播放器.md「本地音乐模式」。

和背景视频互斥

• 导航栏 音符 = 站点音乐（MusicManager）
• 导航栏 三角 = 横幅背景视频（BackgroundPlayer）
• 后启动的一方会停掉另一方（本站交互约定）

官方文档怎么用

查 showInNavbar、volume、playMode、meting 字段 → 官方篇。
改本站默认行为 → 先确认 mode: "local"，再改 playlist。