Android蓝牙按键事件无法获取，Xamarin后台服务GetParcelableExtra返回空

问题根源 #

旧的RegisterMediaButtonEventReceiver API已被废弃，在Android 10+（尤其是Android 13及以上）系统中，后台服务通过广播接收器获取MEDIA_BUTTON事件的机制被严格限制，导致Intent.ExtraKeyEvent返回null。官方推荐使用MediaSessionCompat来接管媒体按键事件处理。

解决方案步骤 #

1. 添加依赖包 #

在项目中安装Xamarin.AndroidX.Media NuGet包，这是处理媒体会话的兼容库。

2. 声明必要权限 #

在AndroidManifest.xml中添加权限：

<!-- Android 13+ 通知权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- 蓝牙连接权限（针对蓝牙设备） -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" android:maxSdkVersion="33" />
<!-- 媒体控制权限 -->
<uses-permission android:name="android.permission.MEDIA_CONTENT_CONTROL" />

3. 重构后台服务代码，使用MediaSessionCompat #

替换原有的广播接收器逻辑，改用MediaSession的回调处理按键事件：

namespace foo
{
    [Service(ForegroundServiceType = ForegroundService.TypeMediaPlayback)]
    class BackgroundService : Service, MediaSessionCompat.IOnMediaButtonListener
    {
        private MediaSessionCompat _mediaSession;
        private const int NotificationId = 1001;

        [return: GeneratedEnum]
        public override StartCommandResult OnStartCommand(Intent intent, [GeneratedEnum] StartCommandFlags flags, int startId)
        {
            // 启动前台服务（Android 8+ 后台服务必须前台化）
            StartForeground(NotificationId, CreateNotification());
            
            // 初始化MediaSession
            InitializeMediaSession();
            
            return StartCommandResult.Sticky;
        }

        private void InitializeMediaSession()
        {
            _mediaSession = new MediaSessionCompat(this, "BackgroundMediaSession");
            _mediaSession.SetFlags(MediaSessionCompat.FlagHandlesMediaButtons | MediaSessionCompat.FlagHandlesTransportControls);
            
            // 设置回调监听媒体按键
            _mediaSession.SetOnMediaButtonListener(this);
            
            // 激活MediaSession
            _mediaSession.Active = true;
        }

        // 实现MediaButtonListener接口，处理按键事件
        public bool OnMediaButtonEvent(Intent mediaButtonIntent)
        {
            var keyEvent = (KeyEvent)mediaButtonIntent.GetParcelableExtra(Intent.ExtraKeyEvent);
            if (keyEvent == null) return false;

            if (keyEvent.KeyCode == Keycode.Headsethook && keyEvent.Action == KeyEventActions.Down)
            {
                // 在这里处理蓝牙按键按下逻辑
                return true;
            }
            return false;
        }

        // 创建前台服务通知（必须）
        private Notification CreateNotification()
        {
            var channelId = "MediaServiceChannel";
            if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
            {
                var channel = new NotificationChannel(channelId, "媒体服务通知", NotificationImportance.Low)
                {
                    Description = "后台媒体按键监听服务"
                };
                var notificationManager = GetSystemService(NotificationService) as NotificationManager;
                notificationManager?.CreateNotificationChannel(channel);
            }

            var notificationBuilder = new NotificationCompat.Builder(this, channelId)
                .SetContentTitle("蓝牙按键监听中")
                .SetSmallIcon(Android.Resource.Drawable.IcMediaPlay)
                .SetPriority(NotificationCompat.PriorityLow);

            return notificationBuilder.Build();
        }

        public override void OnDestroy()
        {
            _mediaSession?.Release();
            base.OnDestroy();
        }

        public override IBinder OnBind(Intent intent) => null;
    }
}

4. 关键注意事项 #

• 前台服务要求：Android 8.0（API 26）及以上，后台服务必须启动为前台服务，否则会被系统杀死，同时需要创建通知渠道。
• MediaSession激活：必须设置_mediaSession.Active = true，否则无法接收媒体按键事件。
• 权限申请：在运行时申请POST_NOTIFICATIONS（Android 13+）和BLUETOOTH_CONNECT（针对蓝牙设备）权限。

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