Android使用media2/media3时Bluetooth Headset媒体按钮失效问题

核心问题原因 #

蓝牙耳机的媒体按钮事件分发逻辑和有线耳机存在差异：Android 5.0+ 中，蓝牙媒体事件优先通过活跃的MediaSession分发，而非直接发送给广播接收器。如果应用未创建并激活MediaSession，就无法捕获蓝牙设备的媒体按钮事件。

分步实现方案 #

1. 配置Manifest权限与组件

在AndroidManifest.xml中添加必要权限、广播接收器和前台服务：

<!-- 权限配置 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 必需 -->

<!-- 媒体按钮广播接收器 -->
<receiver android:name=".MediaButtonReceiver">
    <intent-filter android:priority="1000"> <!-- 高优先级确保优先接收事件 -->
        <action android:name="android.intent.action.MEDIA_BUTTON" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</receiver>

<!-- 前台媒体服务 -->
<service android:name=".MediaButtonService"
         android:foregroundServiceType="mediaPlayback" />

2. 实现媒体按钮广播接收器

创建自定义广播接收器，处理媒体按钮的KEYCODE_MEDIA_PLAY_PAUSE等事件：

public class MediaButtonReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_MEDIA_BUTTON.equals(intent.getAction())) {
            KeyEvent keyEvent = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
            // 仅处理按键抬起事件，避免重复触发
            if (keyEvent != null && keyEvent.getAction() == KeyEvent.ACTION_UP) {
                switch (keyEvent.getKeyCode()) {
                    case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
                        // 替换为你的音频菜单触发逻辑
                        Toast.makeText(context, "蓝牙耳机播放/暂停键触发", Toast.LENGTH_SHORT).show();
                        break;
                    // 可扩展处理其他媒体按钮：上一曲、下一曲等
                }
            }
        }
    }
}

3. 创建并激活MediaSession（关键步骤）

通过前台服务初始化MediaSessionCompat，这是捕获蓝牙媒体事件的核心：

public class MediaButtonService extends Service {
    private MediaSessionCompat mediaSession;

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化MediaSession
        mediaSession = new MediaSessionCompat(this, "MediaButtonServiceTag");
        // 标记支持媒体按钮和传输控制
        mediaSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS 
                | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
        
        // 设置MediaSession回调，也可在此处理媒体事件（和广播接收器二选一即可）
        mediaSession.setCallback(new MediaSessionCompat.Callback() {
            @Override
            public boolean onMediaButtonEvent(Intent mediaButtonIntent) {
                KeyEvent keyEvent = mediaButtonIntent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
                if (keyEvent != null && keyEvent.getAction() == KeyEvent.ACTION_UP) {
                    if (keyEvent.getKeyCode() == KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE) {
                        Toast.makeText(MediaButtonService.this, "MediaSession触发播放/暂停", Toast.LENGTH_SHORT).show();
                        return true;
                    }
                }
                return super.onMediaButtonEvent(mediaButtonIntent);
            }
        });

        // 激活MediaSession，这一步必须执行！
        mediaSession.setActive(true);

        // 启动前台服务，必须显示通知（Android 8.0+ 要求）
        NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, "MediaButtonChannel")
                .setSmallIcon(R.drawable.ic_notification)
                .setContentTitle("媒体按钮监听中")
                .setContentText("已连接蓝牙耳机")
                .setPriority(NotificationCompat.PRIORITY_LOW);
        
        startForeground(1001, notificationBuilder.build());
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        // 销毁时释放MediaSession
        mediaSession.setActive(false);
        mediaSession.release();
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

4. 启动前台服务

在Activity中请求必要权限并启动服务：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // 请求Android 13+的通知权限
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS) 
                != PackageManager.PERMISSION_GRANTED) {
            requestPermissions(new String[]{Manifest.permission.POST_NOTIFICATIONS}, 100);
        }
    }

    // 启动前台服务
    startForegroundService(new Intent(this, MediaButtonService.class));
}

关键注意事项 #

• MediaSession必须激活：蓝牙设备只会将媒体事件发送给拥有活跃MediaSession的应用，这是有线耳机和蓝牙耳机事件分发的核心差异。
• 广播接收器优先级：设置足够高的优先级（如1000），确保你的应用优先捕获事件。
• 前台服务必要性：蓝牙设备通常优先将事件发送给前台运行的媒体类应用，使用前台服务能提升事件接收优先级。

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