.NET MAUI中如何通过代码正确设置MediaElement的Source？

问题描述 #

需要通过后台代码正确实例化MediaSource和/或MediaElement，满足以下需求：

• 运行时以编程方式为MediaElement设置FileSource类型的Source
• 通过代码调用Play方法播放音频

计划隐藏该控件，仅用于选择性播放短音效，无需显示播放器控件。WelcomeVoicePlayer是XAML中已命名的MediaElement，尝试在ContentPage后台代码中动态设置/更改其Source来播放音频，但当前实现无效：

// Neither of these approaches to setting Source worked...
var voiceFile = FileMediaSource.FromFile(tempVoicePath);
//WelcomeVoicePlayer = new MediaElement { Source = voiceFile };
        
// When Play is called I hear nothing, even though audio file is good etc...
WelcomeVoicePlayer.Play();

必要时可以重新实例化控件，但仍需支持通过代码设置Source，希望得到解决思路。

附：特别感谢所有将MediaElement引入MAUI的开发者！

解决方案 #

1. 确认XAML初始配置 #

确保XAML中的WelcomeVoicePlayer声明正确，同时配置必要属性实现隐藏和可控播放：

<MediaElement x:Name="WelcomeVoicePlayer" 
              AutoPlay="False" 
              IsVisible="False"
              Volume="1" />

• AutoPlay="False"：禁止自动播放，完全由代码控制播放时机
• IsVisible="False"：隐藏控件，无需显示播放界面
• Volume="1"：显式设置音量，避免默认音量为0导致无声音

2. 正确设置现有控件的Source并播放 #

不要重新实例化XAML中已命名的控件（这会断开与XAML的绑定关系），直接为现有控件赋值Source，并在资源加载完成后触发播放：

// 获取目标音频文件的FileSource
var voiceFile = FileMediaSource.FromFile(tempVoicePath);

// 停止当前可能的播放（切换音频时需要）
WelcomeVoicePlayer.Stop();
// 为现有控件设置新Source
WelcomeVoicePlayer.Source = voiceFile;

// 监听MediaOpened事件，确保资源加载完成后再播放
WelcomeVoicePlayer.MediaOpened += (sender, args) =>
{
    WelcomeVoicePlayer.Play();
};

如果是首次设置Source，也可以直接调用Play()，但监听MediaOpened能有效避免因资源未加载完成导致的播放失败。

3. 重新实例化控件的备选方案 #

若必须重置控件状态，可在代码中创建新的MediaElement实例，添加到页面布局容器后再配置播放：

// 创建新的MediaElement实例
var newVoicePlayer = new MediaElement
{
    AutoPlay = false,
    IsVisible = false,
    Volume = 1
};

// 将新控件添加到页面的布局容器中（假设布局容器名为MainLayout）
MainLayout.Add(newVoicePlayer);

// 设置Source并监听加载完成事件播放
var voiceFile = FileMediaSource.FromFile(tempVoicePath);
newVoicePlayer.Source = voiceFile;
newVoicePlayer.MediaOpened += (sender, args) =>
{
    newVoicePlayer.Play();
};

4. 额外排查要点 #

• 验证tempVoicePath的正确性：MAUI不同平台的文件路径规则有差异，确保使用符合平台要求的路径（如安卓使用FileSystem.AppDataDirectory定位本地文件）
• 检查音频格式兼容性：确保文件为MP3、WAV等MediaElement支持的格式
• 确认设备和控件音量：设备未静音，且MediaElement的Volume属性未被设为0

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