在 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 级别和使用场景）。
✅ 正确实现步骤
-
声明必要权限（AndroidManifest.xml）：
<uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 若 targeting SDK ≥ 33，还需声明 --> <uses-permission android:name="android.permission.READ_CALL_LOG" />
-
创建自定义监听器类，继承 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); } } } -
注册与注销回调（务必成对管理生命周期）：
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），但存在一定延迟（通常
-
权限适配差异：
- 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 是“通话结束”的可靠信号，但必须配合正确的注册时机与权限配置才能稳定生效。
