android 13（api 33）起 `intent.getparcelableextra(string)` 已废弃，需改用带泛型类型参数的新方法，否则 `keyevent` 始终为 null，导致蓝牙耳机/手柄的播放/暂停等按键无法响应。
在 Android 平台中，通过 ACTION_MEDIA_BUTTON 接收蓝牙设备媒体按键事件是实现后台音乐控制的核心机制。然而自 Android 13（API 级别 33）起，Intent.GetParcelableExtra(string) 方法被正式标记为 obsolete，系统不再支持无类型声明的反序列化——这正是您代码中 intent.GetParcelableExtra(Intent.ExtraKeyEvent) 恒返回 null 的根本原因。
✅ 正确做法：使用强类型安全的重载方法
Xamarin.Android 提供了适配新 API 的替代方法：
var keyEvent = intent.GetParcelableExtra(Intent.ExtraKeyEvent);
该方法明确指定目标类型 KeyEvent，确保 Android 运行时能正确解析 Parcelable 数据。请将您的 MyMediaButtonBroadcastReceiver.OnReceive 方法中相关逻辑更新如下：
public override void OnReceive(Context context, Intent intent)
{
if (intent.Action == Intent.ActionMediaButton)
{
// ✅ 正确：使用泛型重载，兼容 API 33+
var keyEvent = intent.GetParcelableExtra(Intent.ExtraKeyEvent);
if (keyEvent == null)
{
Log.Warn("MyReceiver", "KeyEvent is null — check target SDK and manifest permissions");
return;
}
// 处理按键事件（注意：Down 事件才表示真实按下）
if (keyEvent.Action == KeyEventActions.Down)
{
switch (keyEvent.KeyCode)
{
case Keycode.MediaPlayPause:
HandlePlayPause();
break;
case Keycode.MediaNext:
HandleNext();
break;
case Keycode.MediaPrevious:
HandlePrevious();
break;
case Keycode.Headsethook:
// 兼容部分蓝牙设备的单击接听/挂断
HandleHeadsetHook();
break;
default:
Log.Debug("MyReceiver", $"Unhandled key: {keyEvent.KeyCode}");
break;
}
}
}
} ⚠️ 关键注意事项：
- Target SDK 必须 ≥ 33：若项目仍以 targetSdkVersion="32" 编译，虽可临时绕过警告，但无法保证在 Android 13+ 设备上稳定工作；建议升级并适配新行为。
-
BroadcastReceiver 必须显式注册在 AndroidManifest.xml 中（即使使用 [IntentFilter] 特性），尤其当服务在后台运行时：
（注意 android:exported="true" 是 Android 12+ 强制要求）
- 权限与音频焦点：确保已申请 RECORD_AUDIO（部分设备需要）并调用 AudioManager.RequestAudioFocus()（非必需但推荐用于避免冲突）。
- 避免重复注册：OnStartCommand 中每次启动都调用 RegisterMediaButtonEventReceiver 可能引发异常，建议增加是否已注册的状态检查或改用 Application.Context 全局注册一次。
总结：弃用旧 API 不是兼容性倒退，而是强化类型安全与运行时可靠性。只需一行代码替换 + 清晰的 Manifest 配置，即可恢复所有蓝牙媒体按键的精准识别能力。
