Xamarin Forms iOS端音量按钮无响应问题（依赖服务已初始化）

问题描述 #

已通过DependencyService实现iOS端音量按钮监听服务，服务初始化完成，但按下音量按钮无任何响应。现有代码如下：

iOS端服务代码 #

[assembly: Dependency(typeof(VolumeButtonService))]

namespace AVAT.iOS.Service
{
public class VolumeButtonService : IVolumeButtonService
{
private readonly AVAudioSession _audioSession;

    public event EventHandler<int> VolumeButtonPressed;

    public VolumeButtonService()
    {
        _audioSession = AVAudioSession.SharedInstance();
        _audioSession.SetCategory(AVAudioSessionCategory.Playback);
        _audioSession.SetActive(true);

        NSNotificationCenter.DefaultCenter.AddObserver(new NSString("AVSystemController_SystemVolumeDidChangeNotification"), OnSystemVolumeChanged);
    }

    private void OnSystemVolumeChanged(NSNotification notification)
    {
        var volume = (int)(_audioSession.OutputVolume * 100);

        VolumeButtonPressed?.Invoke(this, volume);
    }
}
}

Xamarin Forms端订阅代码 #

构造函数中调用SubscribeToVolumeButton()：

private void SubscribeToVolumeButton()
{
    var volumeButtonService = DependencyService.Get<IVolumeButtonService>();

    if (volumeButtonService != null)
    {
        volumeButtonService.VolumeButtonPressed += OnVolumeButtonPressed;
    }
}

问题排查与修复 #

1. 修复AVAudioSession初始化错误 #

现有代码未处理音频会话初始化的错误，且iOS 10+版本需指定分类选项，否则可能导致会话激活失败。修改初始化逻辑：

public VolumeButtonService()
{
    _audioSession = AVAudioSession.SharedInstance();
    NSError error = null;
    
    // 适配iOS版本设置音频会话分类
    if (UIDevice.CurrentDevice.CheckSystemVersion(10, 0))
    {
        _audioSession.SetCategory(AVAudioSessionCategory.Playback, AVAudioSessionCategoryOptions.MixWithOthers, out error);
    }
    else
    {
        _audioSession.SetCategory(AVAudioSessionCategory.Playback, out error);
    }
    
    if (error != null)
    {
        Console.WriteLine($"音频会话分类设置失败: {error.LocalizedDescription}");
        return;
    }
    
    _audioSession.SetActive(true, out error);
    if (error != null)
    {
        Console.WriteLine($"音频会话激活失败: {error.LocalizedDescription}");
        return;
    }

    // 指定主队列触发通知回调，避免跨线程问题
    NSNotificationCenter.DefaultCenter.AddObserver(
        new NSString("AVSystemController_SystemVolumeDidChangeNotification"),
        OnSystemVolumeChanged,
        null,
        NSNotificationSchedulingOptions.MainThread);
}

2. 调整Xamarin Forms端订阅时机 #

避免在构造函数中订阅，改为在页面生命周期方法中处理，同时添加取消订阅逻辑防止内存泄漏：

private IVolumeButtonService _volumeButtonService;

protected override void OnAppearing()
{
    base.OnAppearing();
    SubscribeToVolumeButton();
}

protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (_volumeButtonService != null)
    {
        _volumeButtonService.VolumeButtonPressed -= OnVolumeButtonPressed;
    }
}

private void SubscribeToVolumeButton()
{
    _volumeButtonService = DependencyService.Get<IVolumeButtonService>();

    if (_volumeButtonService != null)
    {
        _volumeButtonService.VolumeButtonPressed += OnVolumeButtonPressed;
    }
}

3. 可选：阻止系统音量条弹出 #

若不需要显示系统默认音量调节条，可在通知回调中添加以下代码：

private void OnSystemVolumeChanged(NSNotification notification)
{
    var volume = (int)(_audioSession.OutputVolume * 100);
    
    // 隐藏系统音量条
    var volumeView = new MPVolumeView();
    volumeView.ShowsRouteButton = false;
    volumeView.ShowsVolumeSlider = false;
    UIApplication.SharedApplication.KeyWindow.AddSubview(volumeView);
    volumeView.RemoveFromSuperview();

    VolumeButtonPressed?.Invoke(this, volume);
}

需添加命名空间引用：using MediaPlayer;

注意事项 #

• 确保共享项目中IVolumeButtonService接口定义正确，iOS端实现类正确继承该接口
• 必须使用真实iOS设备测试，模拟器音量按钮无法触发系统通知
• AVSystemController_SystemVolumeDidChangeNotification为系统私有通知，当前可用但需注意后续iOS版本兼容性

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