Android VoIP应用中如何接收蓝牙耳机播放/暂停按键事件？

核心问题分析 #

蓝牙耳机的播放/暂停按键在VoIP场景下，实际对应HFP（免提配置文件）的接听/挂断指令，同时系统会优先将媒体按键事件分配给活跃的MediaSession。你当前的问题大概率是未抢占媒体会话控制权，或未监听HFP专属按键事件导致。

分步解决方案 #

1. 抢占媒体按键控制权（MediaSession） #

Android系统会把媒体按键事件发送给当前活跃的MediaSession，因此VoIP应用需要初始化并激活MediaSession，确保优先级最高：

private lateinit var mediaSession: MediaSessionCompat

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 初始化MediaSession，指定唯一标识
    mediaSession = MediaSessionCompat(this, "VoIP_MEDIA_SESSION")
    
    // 设置按键事件回调
    mediaSession.setCallback(object : MediaSessionCompat.Callback() {
        override fun onMediaButtonEvent(mediaButtonEvent: Intent?): Boolean {
            mediaButtonEvent?.getParcelableExtra<KeyEvent>(Intent.EXTRA_KEY_EVENT)?.let { keyEvent ->
                // 只处理按下事件（避免重复触发）
                if (keyEvent.action == KeyEvent.ACTION_DOWN) {
                    when (keyEvent.keyCode) {
                        KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE -> {
                            // 映射到接听/挂断逻辑：根据当前通话状态处理
                            if (isCallIncoming()) acceptCall()
                            else if (isCallActive()) endCall()
                            return true // 消费事件，避免传递给其他应用
                        }
                    }
                }
            }
            return super.onMediaButtonEvent(mediaButtonEvent)
        }
    })
    
    // 激活MediaSession，抢占控制权
    mediaSession.isActive = true
}

override fun onDestroy() {
    super.onDestroy()
    mediaSession.isActive = false
    mediaSession.release()
}

2. 修正MediaButtonReceiver注册 #

确保Manifest中的静态注册设置最高优先级，避免事件被其他应用拦截：

<receiver 
    android:name="androidx.media.session.MediaButtonReceiver"
    android:exported="true">
    <intent-filter android:priority="1000">
        <action android:name="android.intent.action.MEDIA_BUTTON" />
    </intent-filter>
</receiver>

注：动态注册时无需重复注册MediaButtonReceiver，依赖MediaSession即可捕获事件。

3. 监听HFP专属按键事件（针对颈挂式蓝牙耳机） #

部分蓝牙耳机的接听/挂断按键会触发HFP协议的厂商自定义事件，需单独监听：

步骤1：获取BluetoothHeadset代理

private var bluetoothHeadset: BluetoothHeadset? = null
private val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()

private val headsetServiceListener = object : BluetoothProfile.ServiceListener {
    override fun onServiceConnected(profile: Int, proxy: BluetoothProfile?) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = proxy as BluetoothHeadset
        }
    }

    override fun onServiceDisconnected(profile: Int) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = null
        }
    }
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 绑定HFP代理
    bluetoothAdapter.getProfileProxy(this, headsetServiceListener, BluetoothProfile.HEADSET)
}

override fun onDestroy() {
    super.onDestroy()
    // 解绑代理
    bluetoothAdapter.closeProfileProxy(BluetoothProfile.HEADSET, bluetoothHeadset)
}

步骤2：注册广播监听HFP事件

private val hfpKeyReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        intent?.let {
            if (it.action == BluetoothHeadset.ACTION_VENDOR_SPECIFIC_HEADSET_EVENT) {
                val cmd = it.getStringExtra(BluetoothHeadset.EXTRA_VENDOR_SPECIFIC_HEADSET_EVENT_CMD)
                cmd?.let { command ->
                    // 不同耳机的AT指令可能有差异，需测试适配
                    when {
                        command.contains("AT+CKPD=1") -> acceptCall() // 接听
                        command.contains("AT+CKPD=2") -> endCall()   // 挂断
                        command.contains("AT+CKPD=0") -> toggleCall() // 切换（部分耳机）
                    }
                }
            }
        }
    }
}

override fun onResume() {
    super.onResume()
    val filter = IntentFilter(BluetoothHeadset.ACTION_VENDOR_SPECIFIC_HEADSET_EVENT)
    registerReceiver(hfpKeyReceiver, filter)
}

override fun onPause() {
    super.onPause()
    unregisterReceiver(hfpKeyReceiver)
}

4. 权限与系统限制处理 #

• 权限检查：确保已动态申请BLUETOOTH_CONNECT权限（Android 12+），静态权限需包含：

  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  

• 前台运行：若应用在后台需接收事件，需启动前台服务（Android 10+后台广播限制），避免系统拦截广播。
• 避免冲突：关闭后台运行的其他媒体应用（如音乐APP），确保你的MediaSession是当前活跃状态。

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