C++/WinRT下MediaPlayer API本地音频播放的正确实现问题

一、当前文件打开方式的正确性与优化方案 #

你调用StorageFile::GetFileFromPathAsync的方式本身是正确的，但回调内创建局部MediaPlayer实例是核心问题——回调结束后实例被销毁，导致播放无法正常进行，这也是你修正实例生命周期后播放恢复正常的原因。

如果你不在意异步、可以接受同步等待文件打开，需根据线程环境选择正确的等待方式：

• UI线程场景：不能直接用.get()，会引发死锁，推荐用C++/WinRT的协程co_await异步等待，避免阻塞UI。
• 非UI线程场景：可以安全使用.get()，但必须先初始化WinRT环境（调用winrt::init_apartment()）。

优化后的实现示例 #

1. 协程方式（UI线程友好，推荐）

#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Media.Core.h>
#include <winrt/Windows.Media.Playback.h>

// 函数需标记为winrt::fire_and_forget或返回异步类型
winrt::fire_and_forget PlayAudioAsync(std::wstring const& filename)
{
    try
    {
        // 异步等待文件获取，不阻塞UI
        auto file = co_await winrt::Windows::Storage::StorageFile::GetFileFromPathAsync(filename);
        auto source = winrt::Windows::Media::Core::MediaSource::CreateFromStorageFile(file);
        
        // 注意：MediaPlayer实例需保留在类成员/全局作用域，避免局部销毁
        static winrt::Windows::Media::Playback::MediaPlayer s_player;
        s_player.Source(source);
        
        // 注册播放完成通知
        s_player.MediaEnded([](auto const&, auto const&) {
            // 播放完成后的自定义逻辑
            OutputDebugStringW(L"音频播放完成\n");
        });
        
        s_player.Play();
    }
    catch (winrt::hresult_error const& ex)
    {
        // 捕获并输出错误信息
        OutputDebugStringW((L"错误：" + ex.message() + L"\n").c_str());
    }
}

2. 非UI线程同步等待方式

#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Media.Core.h>
#include <winrt/Windows.Media.Playback.h>

void PlayAudioSync(std::wstring const& filename)
{
    // 初始化WinRT环境（仅非UI线程需要）
    winrt::init_apartment();
    
    try
    {
        // 同步等待文件获取
        auto file = winrt::Windows::Storage::StorageFile::GetFileFromPathAsync(filename).get();
        auto source = winrt::Windows::Media::Core::MediaSource::CreateFromStorageFile(file);
        
        // 保留MediaPlayer实例
        static winrt::Windows::Media::Playback::MediaPlayer s_player;
        s_player.Source(source);
        
        s_player.MediaEnded([](auto const&, auto const&) {
            OutputDebugStringW(L"音频播放完成\n");
        });
        
        s_player.Play();
    }
    catch (winrt::hresult_error const& ex)
    {
        OutputDebugStringW((L"错误：" + ex.message() + L"\n").c_str());
    }
}

二、错误原因解析 #

你遇到的1008（引用不存在的令牌）、14007（激活上下文未找到查找键）错误，主要源于以下两点：

1. 实例生命周期问题：回调内的局部MediaPlayer在回调结束后立即销毁，导致关联的MediaSource资源被释放，触发令牌无效错误。
2. 线程环境问题：如果在未初始化WinRT的线程调用.get()，或者在UI线程阻塞等待异步操作，会破坏WinRT的激活上下文，引发14007错误。

三、正确打开本地音频文件的注意事项 #

• 路径要求：必须使用绝对路径，格式需符合WinRT规范（如L"C:\\test.mp3"，注意转义反斜杠）；确保文件存在且应用有权限访问（桌面应用默认可访问本地文件，UWP需配置文件访问权限）。
• 实例留存：MediaPlayer和MediaSource实例必须保留到播放完成，不能在局部作用域创建后立即销毁。
• 异步规范：UI线程优先用co_await，非UI线程需先初始化WinRT环境再使用同步等待，避免死锁或上下文异常。

内容的提问来源于stack exchange，提问作者Simpleton