AF Media Bar

Windows 10/11 任务栏上的媒体控制、音频设备切换与轻量系统指标。

简体中文 · English
快速开始 · 报告问题 · 功能建议

AF Media Bar 是一款便携式 Windows 10/11 媒体控制器。它读取 Windows 全局系统媒体会话（GSMTC），显示当前媒体的封面、标题和作者，并提供上一首、播放/暂停、下一首和来源切换。

程序以独立进程运行，可以将 WPF 播放器窗口挂载为任务栏子窗口，也可以作为可自由拖动的悬浮窗口运行；它不修改、不向 explorer.exe 注入代码。网易云音乐、QQ 音乐、Spotify、浏览器等应用只要向 Windows 发布媒体会话，就可以被发现和控制。

flowchart LR
    A[媒体应用] -->|GSMTC 会话| B[AF Media Bar]
    C[Windows Core Audio] -->|设备、音量、回环采样| B
    D[Windows 10/11 任务栏] -->|位置与自动隐藏状态| B
    B --> E[WPF 任务栏子窗口或悬浮窗口]

Windows 10/11 控制中心里的媒体卡片是 Explorer/Shell 的内部界面，不是公开可嵌入的控件。AF Media Bar 复用其背后的公开 GSMTC 接口，并自行渲染界面，从而避免注入 Explorer 带来的稳定性和安全风险。

• Windows 10 版本 1809（内部版本 17763）或更高版本，x64
• 使用推荐的自包含版本时，无需另行安装 .NET

1. 打开 Releases。
2. 下载最新的 AFMediaBar-vX.Y.Z-win-x64.zip，不要下载 GitHub 自动生成的 Source code 压缩包。
3. 解压后会得到单个自包含的 AFMediaBar.exe，不再附带数百个 .NET 运行时文件。
4. 将它放到一个长期保留且可写的目录，例如 D:\AFMediaBar，然后运行。
5. 右键播放器或托盘图标，选择“打开详细设置...”集中配置开机启动、布局拼贴、外观和交互。

AF Media Bar 暂未进行商业代码签名，因此 Windows SmartScreen 可能在首次运行时显示未知发布者提示。

媒体应用必须向 Windows 发布 GSMTC 会话。部分播放器需要在自身设置中启用“系统媒体控制”“媒体键”或“SMTC”。

程序启动后会延迟检查版本清单，每天最多自动检查一次；该功能可以在“详细设置 → 常规 → 获取更新”中关闭。也可以在此处立即检查，并从 GitHub、夸克网盘、百度网盘或蓝奏云等已配置渠道打开下载页面。

当前版本只负责获取更新信息和打开下载链接，不会在后台静默替换正在运行的程序。安装更新时：

1. 从托盘菜单退出 AF Media Bar。
2. 下载并解压新版本。
3. 用新的 AFMediaBar.exe 替换旧版本后重新启动。

窗口位置、宿主模式、缩放和开机启动配置保存在当前用户注册表中；布局档案及组件属性保存在 %LOCALAPPDATA%\AFMediaBar\profiles\layout.json。替换程序文件不会丢失设置。旧版本组件注册表选项会在首次启动迁移后清理。

1. 在右键菜单中关闭“开机启动”，然后退出程序。
2. 删除 AF Media Bar 程序目录。
3. 如需同时清除设置，可在 PowerShell 中执行：

reg.exe delete "HKCU\Software\AFMediaBar" /f
reg.exe delete "HKCU\Software\Microsoft\Windows\CurrentVersion\Run" /v "AF Media Bar" /f

确认应用正在播放媒体，并已启用系统媒体控制。浏览器只有在网页实际播放音视频时才会创建会话。如果依然找不到可能是程序不支持，可以在issue中反馈。

默认使用手动定位。解锁位置后拖到任务栏空白区，再勾选“锁定手动位置”。自动避让在定制任务栏或部分 Windows 更新中可能不准确。

设备枚举使用 Windows API，但设置默认设备依赖未公开的 PolicyConfig COM 接口。Windows 更新、受管设备策略或特殊驱动可能阻止切换；这不会影响媒体控制功能。

音量控制按媒体会话来源匹配 Windows 音频会话。同一进程播放多个内容、浏览器多进程模型或播放器自定义音频引擎都可能导致无法唯一匹配。

关闭不需要的性能指标和音频可视化，或启用“低配置模式”。音频可视化会每 50 ms 读取一次 WASAPI 回环缓冲区。

• AF Media Bar 是独立进程中的 WPF 窗口；任务栏模式通过 SetParent 挂载到 Explorer，悬浮模式使用独立顶层窗口。它不是 Explorer 内部插件，也不注入代码。
• Explorer 重启或第三方任务栏工具改变窗口结构时，程序需要重新发现并挂载任务栏窗口；特殊定制环境可能不兼容。
• 输出设备切换使用未公开的 Windows PolicyConfig 接口，未来 Windows 更新可能改变其行为。
• 自动定位依赖 Windows UI Automation；第三方任务栏工具、定制布局和系统更新可能影响识别。
• 当前只跟随主显示器任务栏，不会在每个辅助显示器上分别创建控制器。
• 同一浏览器内多个网页如何呈现为 GSMTC 会话，由浏览器决定。
• 程序当前仅提供 win-x64 发布包，尚未提供 ARM64 构建。

• 不包含遥测、广告、账号系统或联网分析代码。
• 自动检查更新只请求公开的 latest.json 版本清单，不上传媒体信息、设备信息或用户设置；此功能可以在设置中关闭。
• 媒体信息、系统指标和音量操作均在本机处理。
• 程序以当前用户权限运行，不请求管理员权限，也不向 Explorer 注入代码。
• 安全问题请按 SECURITY.md 私下报告，不要在公开 Issue 中披露利用细节。

需要 Windows 10 版本 1809 或更高版本、.NET 10 SDK 和 PowerShell。仓库通过 global.json 固定受支持的 SDK 特性带（feature band）。

git clone https://github.com/Fervent-Tempo/AF-Media-Bar.git
cd AF-Media-Bar
dotnet restore .\AFMediaBar.slnx
dotnet build .\AFMediaBar.slnx -c Release --no-restore
dotnet test .\AFMediaBar.slnx -c Release --no-build
dotnet run --project .\src\AFMediaBar\AFMediaBar.csproj

生成供普通用户使用的自包含单文件：

dotnet publish .\src\AFMediaBar\AFMediaBar.csproj -c Release -r win-x64 --self-contained true -o .\artifacts\AFMediaBar-win-x64

AF-Media-Bar/
|-- .github/
|   |-- ISSUE_TEMPLATE/     # Issue 表单
|   `-- workflows/          # 构建与发布工作流
|-- src/
|   |-- AFMediaBar/         # WPF 外壳、界面与发布配置
|   |-- AFMediaBar.Core/    # UI 无关模型、契约与纯逻辑
|   `-- AFMediaBar.Platform.Windows/ # Windows 系统访问与持久化服务
|-- tests/
|   `-- AFMediaBar.Core.Tests/ # Core 自动化测试
|-- prototypes/             # WinUI 迁移实验项目
|-- docs/                   # 项目文档与资源
|-- AFMediaBar.slnx         # 解决方案构建与测试入口
`-- README.md               # 中文说明

个人开发较慢、能力有限，不保证全部完成。

• 提升 Windows 自动隐藏任务栏模式下的跟随动画流畅度。
• 完善自动避让任务栏图标功能。
• Windows 10 适配测试。
• 无媒体播放时自动隐藏、窗口全局置顶。
• 自动适配系统深浅色主题。
• 提供悬浮窗口模式与长条外边缘折叠容器。
• 为任务栏和悬浮窗口提供显示比例与横向/竖向布局。
• 提供独立详细设置页面。
• 字体自定义。
• 优化点击封面快速打开软件功能，增加快速打开任务管理器。
• 提供自由输入的自定义窗口大小、增加更多自定义设置。
• 视频字幕/歌词滚动展示。
• 媒体进度条展示。
• UI美化、提供多种预制主题。
• 提供独立的组件布局编辑器。
• 配置导出与分享。
• 添加新手教程引导。

提交问题或代码前请阅读 CONTRIBUTING.md。错误报告请附 Windows 版本、AF Media Bar 版本、媒体播放器和完整复现步骤。

版本变化记录见 CHANGELOG.md。

AF Media Bar 使用 MIT License 开源。