AndroidSDK31电话结束监听方法

Android 12（SDK 31）起，传统 `TelephonyManager.listen()` 已被彻底弃用，开发者必须迁移到更安全、异步且主线程友好的 `registerTelephonyCallback()` + `TelephonyCallback.CallStateListener` 新机制，才能精准捕获通话挂断（`CALL_STATE_IDLE`）等关键状态变化；本文手把手详解权限配置、监听器实现、生命周期安全注册/注销全流程，并提醒延迟特性与内存泄漏风险，助你快速适配新API，稳定支撑通话日志、UI更新、资源释放等核心业务场景。

在 Android 12（SDK 31）及以上版本中，TelephonyManager.listen() 已被弃用，需改用 registerTelephonyCallback() 配合 TelephonyCallback.CallStateListener 实时监听通话状态变化，从而准确捕获呼叫挂断（CALL_STATE_IDLE）事件。

在 Android 12（SDK 31）及以上版本中，`TelephonyManager.listen()` 已被弃用，需改用 `registerTelephonyCallback()` 配合 `TelephonyCallback.CallStateListener` 实时监听通话状态变化，从而准确捕获呼叫挂断（`CALL_STATE_IDLE`）事件。

Android 应用在通过 Intent.ACTION_CALL 发起外拨后，常需感知通话生命周期（如用户主动挂断、对方拒接或网络中断），以便执行后续逻辑（如更新 UI、上传通话记录、触发回调等）。但自 Android 12 起，传统基于 PhoneStateListener 的监听方式已被彻底废弃，取而代之的是更安全、更轻量的 TelephonyCallback 机制——它采用 Executor 驱动异步回调，避免主线程阻塞，且无需动态权限声明（但仍需 READ_PHONE_STATE 或 READ_CALL_LOG 等必要权限，具体取决于目标 API 级别和使用场景）。

✅ 正确实现步骤

1. 声明必要权限（AndroidManifest.xml）：

   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   <!-- 若 targeting SDK ≥ 33，还需声明 -->
   <uses-permission android:name="android.permission.READ_CALL_LOG" />

2. 创建自定义监听器类，继承 TelephonyCallback 并实现 CallStateListener：

   public class MyCallStateListener extends TelephonyCallback 
           implements TelephonyCallback.CallStateListener {
   
       private static final String TAG = "MyCallStateListener";
   
       @Override
       public void onCallStateChanged(@TelephonyManager.CallState int state) {
           switch (state) {
               case TelephonyManager.CALL_STATE_IDLE:
                   Log.i(TAG, "✅ 通话已结束（空闲状态）");
                   // ? 在此处插入你的业务逻辑：如关闭悬浮窗、提交通话日志、恢复麦克风等
                   break;
               case TelephonyManager.CALL_STATE_OFFHOOK:
                   Log.i(TAG, "? 通话已接通（正在通话中）");
                   break;
               case TelephonyManager.CALL_STATE_RINGING:
                   Log.i(TAG, "? 来电振铃中");
                   break;
               default:
                   Log.d(TAG, "未知通话状态: " + state);
           }
       }
   }

3. 注册与注销回调（务必成对管理生命周期）：

   private TelephonyCallback mCallStateCallback;
   private TelephonyManager mTelephonyManager;
   
   // 注册（建议在 Activity.onResume() 或 Fragment.onStart() 中）
   private void registerCallStateListener() {
       mTelephonyManager = getSystemService(TelephonyManager.class);
       mCallStateCallback = new MyCallStateListener();
       mTelephonyManager.registerTelephonyCallback(
               getMainExecutor(),  // 使用主线程 Executor（推荐）
               mCallStateCallback
       );
   }
   
   // 注销（必须在 Activity.onPause() 或 Fragment.onStop() 中调用，防止内存泄漏）
   private void unregisterCallStateListener() {
       if (mCallStateCallback != null && mTelephonyManager != null) {
           mTelephonyManager.unregisterTelephonyCallback(mCallStateCallback);
           mCallStateCallback = null;
       }
   }

⚠️ 关键注意事项

• 状态非实时触发：CALL_STATE_IDLE 表示系统确认通话会话已完全终止（包括 VoIP 和 PSTN），但存在一定延迟（通常 <500ms），不可用于毫秒级精确计时。
• 权限适配差异：
  • SDK ≤ 30：仅需 READ_PHONE_STATE；
  • SDK ≥ 31（尤其 ≥ 33）：若应用未声明 READ_CALL_LOG，部分设备可能无法收到 CALL_STATE_IDLE 回调（尤其厂商定制 ROM），建议按需申请并处理运行时授权。
• 后台限制：Android 8.0+ 对后台服务严格限制，TelephonyCallback 在前台 Activity/Service 中注册才可靠；切勿在 BroadcastReceiver 或后台线程中长期持有。
• 多 SIM 卡支持：如需监听特定卡槽，应使用 getTelephonyManager(int slotIndex)（API 22+），而非全局 getSystemService()。

? 总结

registerTelephonyCallback() 是 Android 12+ 监听通话状态的唯一官方推荐路径。相比旧方案，它更解耦、更可控、更符合现代 Android 架构原则。开发者需重点关注生命周期管理、权限适配与状态语义理解——尤其牢记 CALL_STATE_IDLE 是“通话结束”的可靠信号，但必须配合正确的注册时机与权限配置才能稳定生效。

以上就是《AndroidSDK31电话结束监听方法》的详细内容，更多关于的资料请关注golang学习网公众号！