企业官网建设流程全解析

把任意播放器接入BetterLyrics：网易云、Spotify、Apple Music等20+播放器配置指南

【免费下载链接】BetterLyrics一款优雅且高度自定义的歌词可视化与全能音乐播放应用，基于 WinUI3/Win2D 构建 | An elegant and deeply customizable lyrics visualizer & versatile music player, built with WinUI3/Win2D项目地址: https://gitcode.com/jayfunc/BetterLyrics

BetterLyrics是一款基于 WinUI3/Win2D 构建的歌词可视化与全能音乐播放应用。它的最大亮点是：无需更换你正在使用的播放器——无论是网易云音乐、Spotify、Apple Music，还是 foobar2000、QQ 音乐等 20+ 播放器，都可以一键接入，让任何音源获得华丽的逐字歌词动画、频谱、专辑封面背景等视觉体验。

🎵 为什么能"任意接入"：SMTC 机制一句话讲清

BetterLyrics 接入外部播放器的核心原理很简单：Windows 系统自带一套名为SMTC（System Media Transport Controls，系统媒体传输控制）的媒体事件接口。只要播放器接入了 SMTC，BetterLyrics 就能实时"听到"播放状态——当前歌曲、进度、专辑封面、播放/暂停，全部自动同步。

负责监听外部播放器会话的核心服务位于 GsmtcService.cs，它会持续接收媒体属性变更消息，并联动歌词搜索、封面搜索、翻译等全部能力。

💡 结论：凡是接入了 SMTC 的媒体播放器均受支持，支持列表并不限于下文表格，请以实际体验为准。

📋 20+ 播放器支持清单与插件要求

完整清单可查阅官方用户指南：docs/USER_GUIDE.CN.md，节选如下：

使用方法很简单：找到播放器 → 安装表格中列出的插件（若有）→ 正常播放音乐。

🚀 常见播放器配置指南（按步骤操作）

网易云音乐：安装插件即可

1. 打开网易云音乐，安装BetterNCM插件（或InfLink-rs插件），并启用该插件；
2. 启动 BetterLyrics，正常播放歌曲，即可自动识别歌名、封面与进度。

QQ 音乐：开启一个开关

前往 QQ 音乐设置，启用"显示系统媒体传输控制 (SMTC)"（建议使用较新版本），完成后 BetterLyrics 自动接入。

LX Music：两步打通本地与在线音源

1. 在 LX Music 设置 →开放 API中勾选"启用开放 API 服务"；
2. 在 BetterLyrics 的设置→播放源板块下的"LX 音乐服务器"中填入 LX Music 服务器地址并测试连接。

对应界面定义可见 PlaybackSettingsControl.xaml。

Apple Music（网页版）：配置 media-user-token

如果你使用的是 Apple Music 网页版，需要额外配置一次 Token：

1. 打开 Apple Music 网站并登录账户，按F12打开开发者工具；
2. 刷新页面，在Fetch/XHR中任选一个请求，从请求头复制media-user-token的值；
3. 打开 BetterLyrics →设置→播放源，将值粘贴进Apple Music media-user-token设置项并保存。

Token 通过系统凭据库安全存储，相关常量定义在 AppleMusic.cs 中，配置界面见 PlaybackSettingsControl.xaml。

foobar2000 / iTunes / MusicBee / AIMP

这四款播放器只需在各自插件市场安装对应插件（见上方表格）并启用，其余工作交给 BetterLyrics。

✨ 接入成功后：这些视觉体验立刻可用

• 多窗口歌词：卡片、悬浮、全屏、桌面歌词可同时共存；
• 逐字歌词 + 动画特效：雪、雨滴、雾、流体背景、频谱等；
• 专辑封面背景：自动抓取封面并生成主题配色；
• 快捷键控制：Ctrl + Alt + P播放/暂停、Ctrl + Alt + Right下一曲，全部播放器通用。

⚠️ 连接失败？三步排查

1. 显示"没有音乐正在播放"：回到上方清单，确认该播放器需要的插件已安装并启用；
2. 歌词匹配错误：前往设置→播放源→歌词搜索策略选择最佳匹配（首次约需 10 秒）；
3. 歌词时间轴来回跳动：前往设置→播放源，禁用歌词时间轴同步或提高同步阈值。

更多问题可参考官方 FAQ：docs/USER_GUIDE.CN.md。

📚 相关文档与源码

• 官方用户指南：docs/USER_GUIDE.CN.md
• 播放器接入服务源码：src/BetterLyrics.DotNet/BetterLyrics.Core/Implementations/Services/GsmtcService/
• 播放源设置界面源码：src/BetterLyrics.DotNet/BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/PlaybackSettingsControl.xaml

现在，打开你的播放器，让 BetterLyrics 为每一首歌配上它应有的舞台吧 🎶

【免费下载链接】BetterLyrics一款优雅且高度自定义的歌词可视化与全能音乐播放应用，基于 WinUI3/Win2D 构建 | An elegant and deeply customizable lyrics visualizer & versatile music player, built with WinUI3/Win2D项目地址: https://gitcode.com/jayfunc/BetterLyrics