Android/Xamarin中捕获蓝牙耳机通话按键按压事件的问题排查

1. 缺失必要权限 #

Android系统需要明确权限才能监听蓝牙设备事件和媒体按键，需在AndroidManifest.xml中添加以下权限：

<!-- 基础蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!-- Android 12+ 蓝牙连接权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" android:maxSdkVersion="31" />
<!-- 监听通话状态与处理来电权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ANSWER_PHONE_CALLS" />
<!-- Android 8.0+ 后台监听需前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

同时要在代码中动态请求危险权限（如BLUETOOTH_CONNECT、READ_PHONE_STATE），确保应用获得授权。

2. Android 7.0+ 需主动注册媒体按键接收者 #

从API 24开始，系统不会自动将MEDIA_BUTTON事件发给普通广播接收器，必须通过AudioManager主动抢占接收优先级。修改MainActivity的RegisterReceiver方法：

private void RegisterReceiver()
{
    var receiver = new BleInterceptorReceiver();
    // 注册媒体按键广播
    IntentFilter filter = new IntentFilter(Intent.ActionMediaButton);
    filter.Priority = 10000;
    RegisterReceiver(receiver, filter);

    // Android 7.0+ 主动注册为媒体按键接收者
    if (Build.VERSION.SdkInt >= BuildVersionCodes.N)
    {
        AudioManager audioManager = (AudioManager)GetSystemService(Context.AudioService);
        ComponentName receiverComponent = new ComponentName(PackageName, Java.Lang.Class.FromType(typeof(BleInterceptorReceiver)).Name);
        audioManager.RegisterMediaButtonEventReceiver(receiverComponent);
    }
}

还要在应用销毁时取消注册，避免内存泄漏：

protected override void OnDestroy()
{
    base.OnDestroy();
    try
    {
        UnregisterReceiver(new BleInterceptorReceiver());
        if (Build.VERSION.SdkInt >= BuildVersionCodes.N)
        {
            AudioManager audioManager = (AudioManager)GetSystemService(Context.AudioService);
            ComponentName receiverComponent = new ComponentName(PackageName, Java.Lang.Class.FromType(typeof(BleInterceptorReceiver)).Name);
            audioManager.UnregisterMediaButtonEventReceiver(receiverComponent);
        }
    }
    catch (Exception)
    {
        // 忽略未注册的异常
    }
}

3. 正确识别耳机通话按键的KeyEvent #

蓝牙耳机的通话按键对应Keycode.Headsethook，需在接收器中明确判断按键码，同时区分短按/长按逻辑：
修改BleInterceptorReceiver的OnReceive方法：

public override void OnReceive(Context context, Intent intent)
{
    var intentAction = intent.Action;
    if (!string.IsNullOrWhiteSpace(intentAction))
        Toast.MakeText(context, intentAction, ToastLength.Long).Show();

    switch (intentAction)
    {
        case Intent.ActionMediaButton:
            var evt = (KeyEvent)intent.GetParcelableExtra(Intent.ExtraKeyEvent);
            if (evt == null)
                return;

            // 匹配通话按键
            if (evt.KeyCode == Keycode.Headsethook)
            {
                if (evt.Action == KeyEventActions.Down)
                {
                    // 短按：接听/挂断；长按：拒接（不同耳机逻辑可能有差异）
                    Toast.MakeText(context, "通话按键按下", ToastLength.Long).Show();
                    // 在此添加你的接听/拒接来电逻辑
                }
                else if (evt.Action == KeyEventActions.Up)
                {
                    Toast.MakeText(context, "通话按键松开", ToastLength.Long).Show();
                }
            }
            break;
        case BluetoothHeadset.ActionVendorSpecificHeadsetEvent:
            // 处理厂商自定义按键事件
            var command = intent.GetStringExtra(BluetoothHeadset.ExtraVendorSpecificHeadsetEvent);
            if (!string.IsNullOrEmpty(command))
            {
                Toast.MakeText(context, $"厂商特定事件：{command}", ToastLength.Long).Show();
            }
            break;
    }
}

4. 后台运行适配 #

Android 8.0+对后台应用的广播接收有严格限制，若应用退后台后无法接收事件，需启动前台服务保持广播接收器存活，将广播接收器注册到服务中而非Activity。

测试注意事项 #

• 确保蓝牙耳机与设备正常连接，且按键在系统电话应用中可正常工作。
• 测试时关闭其他前台媒体应用，避免抢占媒体按键事件。
• 确认应用已获得所有必要权限，可在系统设置中检查权限状态。

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