.NET MAUI ContentView自定义MediaEnded事件及播放异常排查

一、实现自定义MediaEnded事件 #

在你的AudioPlayerContentView中直接声明并触发自定义事件，步骤如下：

1. 组件类中定义事件并绑定内置MediaElement的事件

public partial class AudioPlayer : ContentView
{
    // 自定义播放结束事件
    public event EventHandler MediaEnded;

    public AudioPlayer()
    {
        InitializeComponent();
        // 将内置MediaElement的MediaEnded事件关联到组件的处理逻辑
        mediaElement.MediaEnded += OnMediaElementEnded;
    }

    private void OnMediaElementEnded(object sender, EventArgs e)
    {
        // 向外触发自定义事件
        MediaEnded?.Invoke(this, EventArgs.Empty);
    }
}

注：假设XAML中MediaElement的x:Name为mediaElement

2. 外部使用时订阅事件

// 页面中实例化组件并订阅事件
var audioPlayer = new AudioPlayer();
audioPlayer.MediaEnded += AudioPlayer_OnMediaEnded;

private void AudioPlayer_OnMediaEnded(object sender, EventArgs e)
{
    // 此处处理播放结束后的逻辑，比如切换音源
}

二、解决切换音源后无法自动播放的问题 #

BindingContext更新但播放器未自动播放，核心是要确保音源加载完成后主动调用Play()，以下是两种可行方案：

方案1：组件内部自动处理播放 #

重写OnBindingContextChanged方法，在音源更新后自动触发播放：

protected override void OnBindingContextChanged()
{
    base.OnBindingContextChanged();
    
    if (BindingContext is AudioModel audioModel)
    {
        // 加载新音源（根据你的模型结构调整路径获取方式）
        mediaElement.Source = MediaSource.FromResource(audioModel.FileName);
        
        // 监听资源加载完成事件，确保播放时机正确
        mediaElement.MediaOpened += (s, e) => 
        {
            mediaElement.Play();
            // 移除事件避免重复绑定
            ((MediaElement)s).MediaOpened -= (s, e);
        };
    }
}

// 示例音频模型类
public class AudioModel
{
    public string FileName { get; set; }
}

方案2：外部订阅事件后主动触发播放 #

如果需要在页面层控制播放逻辑，可在组件中封装公共播放方法：

// AudioPlayer类中添加公共方法
public void StartPlay()
{
    if (mediaElement.Source != null)
    {
        mediaElement.Play();
    }
}

然后在页面的事件处理中切换音源并调用播放：

private void AudioPlayer_OnMediaEnded(object sender, EventArgs e)
{
    var player = sender as AudioPlayer;
    // 更新BindingContext为新音源Vihar.mp3
    player.BindingContext = new AudioModel { FileName = "Vihar.mp3" };
    // 主动触发播放
    player.StartPlay();
}

关键注意点 #

• 确保音频文件的构建操作设置为Embedded resource，避免加载失败
• 若音源切换后仍无响应，可先调用mediaElement.Stop()重置状态，再设置Source并播放

三、完整组件代码示例 #

public partial class AudioPlayer : ContentView
{
    public event EventHandler MediaEnded;

    public AudioPlayer()
    {
        InitializeComponent();
        mediaElement.MediaEnded += OnMediaElementEnded;
    }

    private void OnMediaElementEnded(object sender, EventArgs e)
    {
        MediaEnded?.Invoke(this, EventArgs.Empty);
    }

    public void StartPlay()
    {
        if (mediaElement.Source != null)
        {
            mediaElement.Play();
        }
    }

    protected override void OnBindingContextChanged()
    {
        base.OnBindingContextChanged();
        if (BindingContext is AudioModel audioModel)
        {
            mediaElement.Source = MediaSource.FromResource(audioModel.FileName);
            mediaElement.MediaOpened += MediaElement_MediaOpened;
        }
    }

    private void MediaElement_MediaOpened(object sender, EventArgs e)
    {
        ((MediaElement)sender).Play();
        ((MediaElement)sender).MediaOpened -= MediaElement_MediaOpened;
    }
}

public class AudioModel
{
    public string FileName { get; set; }
}

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