Android VoIP应用锁屏收到来电通知时如何显示自定义Call Activity并处理点击事件
锁屏下自定义VoIP通话Activity的唤起与交互适配方案
一、锁屏状态下唤起自定义Call Activity的实现步骤
- 前置合规配置(针对高版本Android的后台启动限制)
- 按照Android官方规范将VoIP通话能力绑定到
ConnectionService,不要直接依赖后台服务/推送接收器手动调用startActivity拉起通话页——高版本Android(12+)对后台启动Activity有严格限制,只有通过系统通话通路触发的界面启动,才能在锁屏、后台场景下获得系统级的启动权限,这也是WhatsApp等合规应用的实现逻辑。 - 按目标版本声明必要权限:
- Android 10(API 29)及以上需声明
SYSTEM_ALERT_WINDOW悬浮窗权限,提前在应用首次启动流程中引导用户开启,不要等来电触发时才申请 - Android 13(API 33)及以上需申请
POST_NOTIFICATIONS通知权限,保证来电通知的正常触达 - Manifest中将自定义Call Activity的
launchMode设置为singleTop,避免通话过程中重复创建界面实例
- Android 10(API 29)及以上需声明
- 按照Android官方规范将VoIP通话能力绑定到
- 启动时的属性适配
- 从Service/系统通路启动Call Activity时,必须添加
Intent.FLAG_ACTIVITY_NEW_TASK、Intent.FLAG_ACTIVITY_CLEAR_TOP、Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS,否则会因为无关联任务栈导致启动失败 - 在Call Activity的
onCreate方法、视图初始化之前,按系统版本适配Window的锁屏显示属性:if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O_MR1) { // 点亮屏幕 setTurnScreenOn(true) // 允许界面显示在锁屏之上 setShowWhenLocked(true) // 关联Keyguard管理器,处理后续解锁逻辑 val keyguardManager = getSystemService(KeyguardManager::class.java) keyguardManager?.requestDismissKeyguard(this, null) } else { // 低版本兼容的Window flags window.addFlags( WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED or WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON or WindowManager.LayoutParams.FLAG_DISMISS_KEYGUARD or WindowManager.LayoutParams.FLAG_TOUCHABLE_WHEN_LOCKED ) }
- 从Service/系统通路启动Call Activity时,必须添加
- 厂商ROM兼容处理
部分国内定制系统会单独拦截第三方应用的锁屏显示权限,需要在权限检测逻辑中增加对应ROM的“锁屏显示”权限检测,引导用户开启,否则就算系统通用权限已授权,界面依然会被拦截在锁屏下层。
二、锁屏界面下的点击交互适配逻辑
- 触摸事件的基础放行配置
在Activity初始化阶段添加WindowManager.LayoutParams.FLAG_TOUCHABLE_WHEN_LOCKED标记,允许锁屏状态下的窗口正常接收触摸事件,避免Keyguard系统层拦截按钮点击。移除默认的FLAG_NOT_FOCUSABLE标记,保证输入类控件可以正常获得焦点。 - 按锁屏状态分支处理交互
通过KeyguardManager判断当前锁屏状态,分支响应点击逻辑:- 非安全锁屏(滑动解锁、无设备锁):所有按钮点击逻辑正常响应,用户点击接听按钮时,直接调用系统接口关闭锁屏,进入完整通话界面
- 安全锁屏(密码、指纹、面容锁):仅开放两个核心操作的点击响应
- 挂断按钮:点击后直接触发挂断通话逻辑,无需引导用户解锁
- 接听按钮:点击后唤起系统生物识别/密码解锁流程,等用户完成解锁后,再开放静音、免提、通话记录入口等次级交互的点击响应,避免锁屏状态下误触
- 交互规范对齐
锁屏状态下的通话界面不要展示非核心的操作按钮(比如添加通话、切换网络),这类操作等界面完全进入解锁后的前台状态再展示,避免不符合系统交互规范导致的体验问题。
内容的提问来源于stack exchange,提问作者Tushar Kumar
相关产品推荐
相关产品推荐

