如何在.NET MAUI（iOS和Android）中监听音量按键按压事件？

由于MAUI目前没有跨平台的音量键检测API，我们可以通过平台特定实现结合依赖注入完成需求，以下是Android和iOS的具体实现代码：

1. 定义跨平台接口 #

创建共享接口统一平台间的事件回调：

public interface IVolumeKeyListener
{
    event EventHandler VolumeUpPressed;
    event EventHandler VolumeDownPressed;
}

2. Android平台实现 #

2.1 实现监听类 #

在Android项目中创建监听类，通过依赖注入标记暴露给共享代码：

using Android.App;
using Microsoft.Maui.Controls;

[assembly: Dependency(typeof(VolumeKeyListener_Android))]
namespace YourAppName.Platforms.Android
{
    public class VolumeKeyListener_Android : IVolumeKeyListener
    {
        public event EventHandler? VolumeUpPressed;
        public event EventHandler? VolumeDownPressed;

        internal void TriggerVolumeUp() => VolumeUpPressed?.Invoke(this, EventArgs.Empty);
        internal void TriggerVolumeDown() => VolumeDownPressed?.Invoke(this, EventArgs.Empty);
    }
}

2.2 在MainActivity中处理按键事件 #

重写MainActivity的OnKeyDown方法，检测音量键并触发事件：

using Android.App;
using Android.Content.PM;
using Android.OS;
using Android.Views;

namespace YourAppName.Platforms.Android
{
    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
    public class MainActivity : MauiAppCompatActivity
    {
        private VolumeKeyListener_Android? _volumeListener;

        protected override void OnCreate(Bundle? savedInstanceState)
        {
            base.OnCreate(savedInstanceState);
            _volumeListener = DependencyService.Get<IVolumeKeyListener>() as VolumeKeyListener_Android;
        }

        public override bool OnKeyDown(Keycode keyCode, KeyEvent? e)
        {
            if (keyCode == Keycode.VolumeUp)
            {
                _volumeListener?.TriggerVolumeUp();
                // 返回false，让系统继续处理原生音量调节逻辑
                return false;
            }
            else if (keyCode == Keycode.VolumeDown)
            {
                _volumeListener?.TriggerVolumeDown();
                return false;
            }
            return base.OnKeyDown(keyCode, e);
        }
    }
}

3. iOS平台实现 #

iOS无直接监听硬件音量键的API，通过监听音量变化间接检测按键操作：

3.1 实现监听类 #

在iOS项目中创建监听类，依赖注入标记：

using Foundation;
using Microsoft.Maui.Controls;
using AVFoundation;

[assembly: Dependency(typeof(VolumeKeyListener_iOS))]
namespace YourAppName.Platforms.iOS
{
    public class VolumeKeyListener_iOS : IVolumeKeyListener, IDisposable
    {
        public event EventHandler? VolumeUpPressed;
        public event EventHandler? VolumeDownPressed;

        private float _lastVolume;
        private NSObject? _volumeObserver;

        public VolumeKeyListener_iOS()
        {
            var audioSession = AVAudioSession.SharedInstance();
            _lastVolume = audioSession.OutputVolume;

            // 注册音量变化通知
            _volumeObserver = NSNotificationCenter.DefaultCenter.AddObserver(
                AVAudioSession.OutputVolumeDidChangeNotification,
                HandleVolumeChange);

            // 激活音频会话以接收通知
            try
            {
                audioSession.SetActive(true, AVAudioSessionSetActiveOptions.NotifyOthersOnDeactivation);
            }
            catch (Exception ex)
            {
                Console.WriteLine($"激活音频会话失败: {ex.Message}");
            }
        }

        private void HandleVolumeChange(NSNotification notification)
        {
            var audioSession = AVAudioSession.SharedInstance();
            float currentVolume = audioSession.OutputVolume;

            if (currentVolume > _lastVolume)
            {
                VolumeUpPressed?.Invoke(this, EventArgs.Empty);
            }
            else if (currentVolume < _lastVolume)
            {
                VolumeDownPressed?.Invoke(this, EventArgs.Empty);
            }

            _lastVolume = currentVolume;
        }

        public void Dispose()
        {
            if (_volumeObserver != null)
            {
                NSNotificationCenter.DefaultCenter.RemoveObserver(_volumeObserver);
                _volumeObserver.Dispose();
                _volumeObserver = null;
            }

            var audioSession = AVAudioSession.SharedInstance();
            try
            {
                audioSession.SetActive(false);
            }
            catch { }
        }
    }
}

4. 注册服务并使用 #

4.1 在MauiProgram中注册服务 #

using Microsoft.Extensions.Logging;

namespace YourAppName
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureFonts(fonts =>
                {
                    fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                    fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
                });

#if DEBUG
    		builder.Logging.AddDebug();
#endif

            // 注册音量键监听服务
            builder.Services.AddSingleton<IVolumeKeyListener>();

            return builder.Build();
        }
    }
}

4.2 在页面中使用 #

在页面（或ViewModel）中注入服务并订阅事件：

using Microsoft.Maui.Controls;

namespace YourAppName
{
    public partial class MainPage : ContentPage
    {
        private readonly IVolumeKeyListener _volumeKeyListener;

        public MainPage(IVolumeKeyListener volumeKeyListener)
        {
            InitializeComponent();
            _volumeKeyListener = volumeKeyListener;
            _volumeKeyListener.VolumeUpPressed += OnVolumeUpPressed;
            _volumeKeyListener.VolumeDownPressed += OnVolumeDownPressed;
        }

        private void OnVolumeUpPressed(object? sender, EventArgs e)
        {
            // 执行自定义逻辑
            MainThread.BeginInvokeOnMainThread(() =>
            {
                DisplayAlert("提示", "音量加按键被按下", "确定");
            });
        }

        private void OnVolumeDownPressed(object? sender, EventArgs e)
        {
            // 执行自定义逻辑
            MainThread.BeginInvokeOnMainThread(() =>
            {
                DisplayAlert("提示", "音量减按键被按下", "确定");
            });
        }

        protected override void OnDisappearing()
        {
            base.OnDisappearing();
            // 取消订阅避免内存泄漏
            _volumeKeyListener.VolumeUpPressed -= OnVolumeUpPressed;
            _volumeKeyListener.VolumeDownPressed -= OnVolumeDownPressed;
        }
    }
}

注意事项 #

• Android：返回false确保系统正常处理音量调节，不会拦截原生行为。
• iOS：通过音量变化间接检测按键，若用户通过系统设置修改音量也会触发事件；无需额外权限，但需激活音频会话。

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