如何在 Windows 上正确提取媒体控制会话的缩略图（Thumbnail）

在 Windows 桌面开发中，全局媒体控制会话（System Media Transport Controls）可以暴露当前播放媒体的标题、艺术家以及封面缩略图。很多应用希望把正在播放的歌曲封面显示在自家界面里，但实际调用 API 时常常得到空图像或者尺寸不对的结果。本文从 Windows 提供的媒体控制命名空间出发，说明提取缩略图的正确流程与注意点。

一、媒体控制会话与缩略图来源

Windows 从 10 版本开始引入 Windows.Media.Control 命名空间，其中的 GlobalSystemMediaTransportControlsSessionManager 负责管理系统中所有媒体会话。每一个会话对应一个播放器实例，例如 Spotify、Edge 浏览器中的视频或系统音乐应用。通过会话对象，我们能够读取 MediaProperties，里面就包含了 Thumbnail 这个属性。

需要注意的是，Thumbnail 并不是一张现成的图片对象，而是一个 IRandomAccessStream 形式的异步流。系统并不会一直把解码后的位图放在内存里，而是在你主动请求时才去对应播放器进程取出封面数据。因此，如果在错误的时机读取，或者没有等待流就绪，就会得到长度为 0 的空流。

二、常见错误写法与问题分析

下面这段代码是初学者最容易写的错误示例：它在获取到会话后立刻读取缩略图，并且没有检查会话是否真的处于播放状态。

using Windows.Media.Control;
using System;

async void BadGetThumbnail()
{
    var manager = await GlobalSystemMediaTransportControlsSessionManager.RequestAsync();
    var session = manager.GetCurrentSession();
    // 错误：直接读取，可能会话还没加载完媒体属性
    var props = await session.TryGetMediaPropertiesAsync();
    var thumb = props.Thumbnail;
    if (thumb != null)
    {
        // 错误：假设流里已经有完整数据，直接按原尺寸读取
        var file = await Windows.Storage.StorageFile.CreateStreamedFileAsync(
            "thumb.jpg",
            async req =>
            {
                var buffer = new byte[thumb.Size];
                await thumb.ReadAsync(buffer.AsBuffer(), (uint)thumb.Size, Windows.Storage.Streams.InputStreamOptions.None);
                req.Write(buffer);
                req.Dispose();
            },
            null);
    }
}

这段逻辑有两个典型问题。第一，TryGetMediaPropertiesAsync 返回的媒体属性中，Thumbnail 流只有在媒体信息变更事件之后才可靠；如果在播放器刚启动、还未上报封面时调用，流就是空的。第二，代码在 lambda 里直接按 thumb.Size 读取，但随机访问流如果未被正确定位到开头，或者播放器提供的是渐进式编码图像，一次性读取可能只拿到部分数据。

另外，有些开发者把流放到后台线程去解码，结果抛出 COM 异常。这是因为媒体会话 API 大多绑定到调用时的线程上下文，跨线程操作流会导致对象被回收或拒绝访问。

三、正确的提取流程

稳定提取缩略图应遵循以下步骤：先拿到会话管理器，监听 CurrentSessionChanged 与 MediaPropertiesChanged 事件；在事件回调中再请求属性；得到 Thumbnail 流后，使用 BitmapDecoder 按需要尺寸解码，而不是盲目原样保存。

using Windows.Media.Control;
using Windows.Graphics.Imaging;
using Windows.Storage.Streams;
using System;

public async Task<SoftwareBitmap> GetSafeThumbnailAsync()
{
    var manager = await GlobalSystemMediaTransportControlsSessionManager.RequestAsync();
    var session = manager.GetCurrentSession();
    if (session == null)
        return null;

    // 等待媒体属性变更，确保封面已就绪
    var props = await session.TryGetMediaPropertiesAsync();
    var stream = props.Thumbnail;
    if (stream == null || stream.Size == 0)
        return null;

    // 将流定位到开头并解码
    stream.Seek(0);
    var decoder = await BitmapDecoder.CreateAsync(stream);
    // 按需取缩略图，例如最长边 300 像素
    var transformed = await decoder.GetSoftwareBitmapAsync(
        BitmapPixelFormat.Bgra8,
        BitmapAlphaMode.Premultiplied,
        new BitmapTransform() { ScaledWidth = 300, ScaledHeight = 300 },
        ExifOrientationMode.IgnoreExifOrientation,
        ColorManagementMode.DoNotColorManage);

    return transformed;
}

上面代码里，stream.Seek(0) 是关键一步，它保证我们从流首部开始解码。通过 BitmapDecoder 创建的 SoftwareBitmap 可以直接绑定到 XAML 的 Image 控件，或者转为 PNG 缓冲上传。这种做法不依赖原图尺寸，也避免了空流问题。

如果希望实时更新封面，应当订阅事件：

manager.CurrentSessionChanged += async (s, e) =>
{
    var newSession = manager.GetCurrentSession();
    if (newSession != null)
    {
        newSession.MediaPropertiesChanged += async (se, ev) =>
        {
            var bmp = await GetSafeThumbnailAsync();
            // 回到 UI 线程更新界面
        };
    }
};

四、注意事项与兼容细节

并非所有媒体会话都会提供缩略图。例如某些浏览器标签播放音频时，可能只给标题而不给封面，此时 props.Thumbnail 为 null，代码需要做空值保护。另外，在 Windows 11 上，如果系统设置了硬件加速解码限制，BitmapDecoder 偶尔会返回低分辨率图，这时可以先用 decoder.PixelWidth 检查原始尺寸再决定是否缩放。

还有一个容易忽略的点：GlobalSystemMediaTransportControlsSessionManager.RequestAsync 必须在有窗口的 UI 线程或带有合适 Apartment 状态的后台线程调用，否则会抛出入门级 COM 错误。推荐在应用启动完成后立刻缓存 manager 实例，避免反复请求造成延迟。

按照上述方式处理，就能在 Windows 上稳定提取媒体控制会话的缩略图，并将其用于桌面通知、悬浮窗封面或后台记录，不会再出现空白图像或尺寸异常的情况。

Windows.Media.ControlThumbnail提取MediaSession修改时间：2026-07-31 22:30:31