Media Session 连接与故障排查

它是什么

Media Session 是 Windows 10 引入的一套系统级媒体控制接口。任何接入了这套接口的播放器（Spotify、Apple Music、Chrome 浏览器）都会把「正在播放什么、当前进度、能不能控制」这些信息暴露给系统，系统再分发给各应用。

Lyricify 4 同时通过两条路径获取播放信息：

1. Spotify Web API（云端）：通过 OAuth 授权拿到 access token，请求 Spotify 服务器。优点是跨设备（手机放歌电脑也能读到），缺点是 Premium 才给控制权限 + 网络延迟 + 429 限流
2. Media Session（本地）：直接读 Windows 提供的本地播放信息。优点是零延迟 + 免费账号也能控制，缺点是只能控制本机、只有 Spotify 客户端在运行时才有信号

两条通道互补，Lyricify 会智能选择优先用哪一条。

怎么看连上没

看右上角用户组件那里：

• Media Session 已连接：会有一个小图标，鼠标悬停能看到「Media Session: Connected to Spotify」之类的提示
• Media Session 未连接：没有图标，或者图标是灰色的

另外在主菜单里也能找到 Media Session 的状态项。

连不上时的排查清单

1. Spotify 桌面客户端是否在运行 Media Session 信号只来自运行中的 Spotify 进程。如果 Spotify 完全退出了，就没有 Media Session。最小化到系统托盘不算退出，没问题。
2. Spotify 是否在正常播放 Media Session 只有在「有播放内容时」才会持续发信号。暂停或停止后，部分版本的 Spotify 可能停止发送 Media Session。
3. Windows 服务是否被禁用检查以下服务是否处于运行状态：

• Media Player Network Sharing Service（可选，某些情况下相关）
• Shell Experience Host（负责任务栏的媒体控制）

1. 第三方安全软件是否拦截部分安全软件会阻止 Lyricify 读取系统媒体信息。尝试临时关闭安全软件再试。
2. 重启 Spotify 和 Lyricify最快的修复方式：先关 Lyricify，再关 Spotify，然后反过来启动——先开 Spotify 并放一首歌，等 5 秒，再开 Lyricify。
3. Windows 版本 Media Session 是 Windows 10 引入的功能，老版本的 Windows 10（低于 1809）可能支持不完整，Windows 7/8 完全不支持。

为什么重视 Media Session

Media Session 是解决两个高频痛点的钥匙：

• 免费账号也能控制播放（Premium 解锁之前，很多人靠这个获得了暂停/上一曲的能力）
• 本地控制延迟比 Web API 低很多，歌词和歌声的同步会更精准

所以即使你有 Premium 订阅，把 Media Session 搞定也能让体验更丝滑。