这个项目能做什么

AF Media Bar 是一款面向 Windows 10/11 的便携式任务栏媒体控制器,从系统媒体会话读取正在播放的内容,把封面、歌词、播放控制和音频设备切换留在桌面边缘。 主要功能 - 音乐控制:上一首、播放/暂停、下一首、循环,点击或拖动进度条跳转。 - 任务栏歌词:由 Web 歌词引擎显示实时歌词,支持译文、音译与双行对齐,按网易云音乐、LRCLIB、QQ 音乐、酷狗音乐、汽水音乐的顺序匹配。 - 来源与交互:切换媒体会话;封面、标题与歌词的点击操作可分别设为播放/暂停、切回媒体应用或打开完整菜单。 - 音频与系统:点击或滚轮切换默认输出设备、调整当前媒体应用音量、查看空间音效,提供四种频谱样式与性能检测组件。 - 布局与外观:自动避让任务栏图标及系统区域,可选目标屏幕、无播放时自动隐藏,可调字体、主题色与窗口材质。 - 快捷操作:悬停显示控制按钮,完整层展示更多信息,音符图标打开快速启动列表。 安装与运行 提供安装程序与便携版两种发布包,均自带 .NET 运行时。安装版默认安装到 %LOCALAPPDATA%\Programs\AFMediaBar,支持程序内检查、下载与安装更新;便携版不写注册表,更新时手动替换文件。系统要求 Windows 10 1809(内部版本 17763)或更新的 x64 系统,并需要 Microsoft Edge WebView2 Runtime。程序尚未进行商业代码签名,首次运行可能出现 SmartScreen 提示。 工作方式 以独立 WPF 进程运行,将媒体栏挂载为任务栏子窗口,使用 Windows 公开的 GSMTC 接口读取媒体会话,通过 Core Audio 处理设备与音量,不修改或向 explorer.exe 注入代码。只有向 Windows 发布 GSMTC 媒体会话的播放器才会出现,部分播放器需在自身设置中启用系统媒体控制或媒体键。当前仅有任务栏运行模式,设置中的灵动岛、桌面卡片、悬浮球为占位选项。 隐私与安全 不包含遥测、广告、账号系统或联网分析代码,媒体信息、系统指标与音量操作全部在本机处理。更新检查只请求两个公开清单端点;歌词按当前媒体信息向五个来源的公开接口请求,只发送曲名、歌手、专辑与时长。程序以当前用户权限运行,不请求管理员权限。 构建与项目结构 需要 Windows 10 1809 或更高版本、.NET 10 SDK 和 PowerShell,仓库通过 global.json 固定受支持的 SDK 特性带。源码包含 WPF 应用主项目(分层业务代码、可复用控件、主题样式与三语文案、MVVM 视图模型与页面)、布局测试项目、架构静态检查脚本、Inno Setup 安装脚本与文档目录。 许可与致谢 项目使用 MIT License 开源,致谢 FluentFlyout、Lyricify-Lyrics-Helper、TaskbarLyrics 等开源项目。