三星系统更新后ACTION_MEDIA_BUTTON的Extras返回null该如何处理？

核心原因 #

三星One UI基于Android 12及以上的版本对媒体按钮广播做了定制化权限收紧，原有静态注册的广播接收器不再默认能获取完整的Intent附加数据，属于厂商特性调整，不是代码bug。

代码调整项 #

1. 权限适配更新 #

原有BLUETOOTH权限在Android 12+已经拆分，需要在AndroidManifest.xml新增权限声明：

<!-- Android 12+ 蓝牙连接必备权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<!-- 三星系统会绑定通知权限和媒体按钮事件接收权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

2. 广播注册方式调整 #

放弃原有静态注册方式，改为动态注册广播接收器（官方Android 12开始就不推荐静态注册媒体按钮广播，三星进一步限制了静态注册的权限）：

// 在你需要接收事件的Activity/Service中注册
IntentFilter mediaFilter = new IntentFilter(Intent.ACTION_MEDIA_BUTTON);
mediaFilter.setPriority(999);
// 注意Android 13+动态注册广播必须显式声明RECEIVER_EXPORTED
registerReceiver(remoteControlReceiver, mediaFilter, Context.RECEIVER_EXPORTED);

// 页面销毁/不需要接收时记得注销
// unregisterReceiver(remoteControlReceiver);

3. 显式注册媒体按钮事件接收 #

调用系统音频服务主动绑定你的接收器，让系统优先把事件分发到你的应用：

AudioManager audioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);
ComponentName receiverComp = new ComponentName(context, RemoteControlReceiver.class);
// 注册媒体按钮接收
audioManager.registerMediaButtonEventReceiver(receiverComp);
// 不需要时注销
// audioManager.unregisterMediaButtonEventReceiver(receiverComp);

排查建议 #

• 先打印收到的Intent的所有附加字段，确认是否有厂商自定义的Key替代了原有Intent.EXTRA_KEY_EVENT：

Bundle extras = intent.getExtras();
if (extras != null) {
    for (String key : extras.keySet()) {
        Log.d("MEDIA_DEBUG", "key:" + key + " value:" + extras.get(key));
    }
}

• 确认你的应用当前有活跃的音频播放会话，三星系统默认只会把媒体按钮事件分发给当前正在播放音频的应用，后台无播放的应用不会收到有效事件。
• 排查是否有其他高优先级的应用抢占了媒体按钮事件，比如系统自带音乐app、第三方音乐播放器。

系统权限设置要求 #

必须引导用户在系统设置中开启以下权限：

1. 蓝牙相关权限：Android 12+需开启「附近的设备」权限，低版本需开启「蓝牙」权限
2. 通知权限：三星系统限制没有通知权限的应用无法接收媒体按钮广播
3. 部分One UI版本需要在「特殊应用权限-媒体控制」中给你的应用开启权限

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