Xamarin Forms媒体播放器播放WAV音频无声问题排查及停止方法

无声问题的排查与修复 #

1. 权限处理不到位 #

你用了Permissions.CheckStatusAsync但没等待异步操作完成，也没处理权限被拒绝的情况，而且Permissions.Media并非播放音频的对应权限。不同平台权限要求：

• Android：SDK33及以上如果后台播放需要POST_NOTIFICATIONS，读取外部存储需READ_EXTERNAL_STORAGE，本地资源播放无需额外权限，但要确保权限请求流程正确
• iOS：无需权限，但要配置音频会话避免静音模式无声

修复代码：

// 把播放逻辑移到OnAppearing事件，而非构造函数
protected override async void OnAppearing()
{
    base.OnAppearing();
    var status = await Permissions.CheckStatusAsync<Permissions.Audio>();
    if (status != PermissionStatus.Granted)
    {
        status = await Permissions.RequestAsync<Permissions.Audio>();
    }
    // 权限通过后再触发播放
    if (status == PermissionStatus.Granted)
    {
        PlayAudio();
    }
}

2. 音频文件路径配置错误 #

直接传"alert.wav"不满足跨平台路径规则，不同平台资源存放和读取方式不同：

• Android：把wav文件放到Resources/raw（文件名小写，无空格），Build Action设为AndroidResource，路径直接写文件名即可
• iOS：把wav文件添加到项目根目录，Build Action设为BundleResource，需要通过NSBundle获取真实路径

修复的路径处理代码：

private void PlayAudio()
{
    string audioPath;
    #if __ANDROID__
    audioPath = "alert.wav";
    #elif __IOS__
    audioPath = NSBundle.MainBundle.PathForResource("alert", "wav");
    #else
    audioPath = System.IO.Path.Combine(System.AppDomain.CurrentDomain.BaseDirectory, "alert.wav");
    #endif
    audioPlayer.Play(audioPath);
}

3. 播放时机不对 #

构造函数里调用Play()时，页面还没完成初始化，音频资源可能未加载，或者系统未准备好播放。移到OnAppearing事件或者按钮点击事件里更稳妥。

4. iOS音频会话配置 #

iOS静音模式下默认会禁止音频播放，需要在App启动时配置音频会话类别：

// 放在iOS项目的AppDelegate.cs的FinishedLaunching方法中
var session = AVAudioSession.SharedInstance();
session.SetCategory(AVAudioSessionCategory.Playback);
session.SetActive(true);

停止音频播放的正确实现 #

你的StopPlay_Clicked方法逻辑没问题，但可以加个状态判断避免无效调用：

private void StopPlay_Clicked(object sender, EventArgs e)
{
    if (audioPlayer != null && audioPlayer.IsPlaying)
    {
        audioPlayer.Stop();
    }
}

完整修正代码 #

using Plugin.AudioRecorder;
using Xamarin.Essentials;
#if __IOS__
using AVFoundation;
#endif

private AudioPlayer audioPlayer = new AudioPlayer();

public NewEvent()
{
    InitializeComponent();
}

protected override async void OnAppearing()
{
    base.OnAppearing();
    #if __IOS__
    // iOS音频会话配置，确保静音模式也能播放
    var session = AVAudioSession.SharedInstance();
    session.SetCategory(AVAudioSessionCategory.Playback);
    session.SetActive(true);
    #endif

    // 权限检查
    var status = await Permissions.CheckStatusAsync<Permissions.Audio>();
    if (status != PermissionStatus.Granted)
    {
        status = await Permissions.RequestAsync<Permissions.Audio>();
    }

    if (status == PermissionStatus.Granted)
    {
        PlayAudio();
    }
}

private void PlayAudio()
{
    string audioPath;
    #if __ANDROID__
    audioPath = "alert.wav";
    #elif __IOS__
    audioPath = NSBundle.MainBundle.PathForResource("alert", "wav");
    #else
    audioPath = System.IO.Path.Combine(System.AppDomain.CurrentDomain.BaseDirectory, "alert.wav");
    #endif
    audioPlayer.Play(audioPath);
}

private void StopPlay_Clicked(object sender, EventArgs e)
{
    if (audioPlayer != null && audioPlayer.IsPlaying)
    {
        audioPlayer.Stop();
    }
}

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