如何在Xamarin.Android中实现耳机插孔插拔事件检测

Xamarin.Android 原生支持有线耳机插入、拔出事件的检测，无需引入第三方依赖，基于系统开放的广播API即可实现。

Android系统在有线耳机插拔时，会全局发送ACTION_HEADSET_PLUG粘性广播，广播内携带当前耳机的连接状态、是否带麦等信息，Xamarin.Android已经对这套原生API做了完整绑定，直接调用即可。

注意：Android 8.0（API 26）及以上版本对隐式广播做了严格限制，ACTION_HEADSET_PLUG属于受限广播，不支持在AndroidManifest.xml中静态注册接收器，必须在代码中动态注册才能正常收到事件。

• 第一步：编写自定义广播接收器
  继承BroadcastReceiver基类，重写OnReceive方法解析广播里的耳机状态，代码示例：

  public class HeadsetPlugReceiver : BroadcastReceiver
  {
      /// <summary>
      /// 耳机状态变化回调，参数true为插入，false为拔出
      /// </summary>
      public Action<bool> HeadsetStateChanged;
  
      public override void OnReceive(Context context, Intent intent)
      {
          if (intent.Action != Intent.ActionHeadsetPlug) return;
          
          // state值：0=耳机拔出，1=耳机插入
          int stateValue = intent.GetIntExtra("state", 0);
          bool isPlugged = stateValue == 1;
          
          HeadsetStateChanged?.Invoke(isPlugged);
      }
  }
  

• 第二步：在业务组件生命周期中动态注册/反注册接收器
  以Activity场景为例，在页面回到前台时注册接收器，页面退到后台时反注册避免内存泄漏，代码示例：

  private HeadsetPlugReceiver _headsetReceiver;
  
  protected override void OnResume()
  {
      base.OnResume();
      
      _headsetReceiver = new HeadsetPlugReceiver();
      _headsetReceiver.HeadsetStateChanged = isPlugged =>
      {
          if (isPlugged)
          {
              // 插入后业务逻辑：例如切换音频输出到耳机、恢复播放
              Toast.MakeText(this, "耳机已插入", ToastLength.Short).Show();
          }
          else
          {
              // 拔出后业务逻辑：例如自动暂停播放、切回外放
              Toast.MakeText(this, "耳机已拔出", ToastLength.Short).Show();
          }
      };
  
      // 执行广播注册
      RegisterReceiver(_headsetReceiver, new IntentFilter(Intent.ActionHeadsetPlug));
  }
  
  protected override void OnPause()
  {
      base.OnPause();
      // 必须反注册，防止内存泄漏
      if (_headsetReceiver != null)
      {
          UnregisterReceiver(_headsetReceiver);
          _headsetReceiver.Dispose();
          _headsetReceiver = null;
      }
  }
  

• 第三步：可选，主动获取初始耳机状态
  由于ACTION_HEADSET_PLUG是粘性广播，应用启动时如果耳机已经处于插入状态，不会主动触发广播回调，可以在注册完成后主动查询一次初始状态做初始化：

  Intent stickyPlugIntent = RegisterReceiver(null, new IntentFilter(Intent.ActionHeadsetPlug));
  if (stickyPlugIntent != null)
  {
      int initState = stickyPlugIntent.GetIntExtra("state", 0);
      bool isHeadsetPluggedOnStart = initState == 1;
      // 按初始状态执行对应初始化逻辑
  }
  

• 上述方案仅适用于3.5mm、Type-C等有线耳机的插拔检测，如果需要检测蓝牙耳机的连接状态，需要额外监听蓝牙相关广播，配合蓝牙音频协议判断。
• 不要尝试静态注册该广播，Android 8.0以上系统会直接拦截静态注册的ACTION_HEADSET_PLUG广播，不会触发接收器回调。
• 注册接收器后必须在组件生命周期结束前反注册，否则会引发内存泄漏。

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