You need to enable JavaScript to run this app. Android VoIP应用锁屏收到来电通知时如何显示自定义Call Activity并处理点击事件
优惠活动
大模型
产品
解决方案
定价
更多

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,避免通话过程中重复创建界面实例
  • 启动时的属性适配
    • 从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
          )
      }
      
  • 厂商ROM兼容处理
    部分国内定制系统会单独拦截第三方应用的锁屏显示权限,需要在权限检测逻辑中增加对应ROM的“锁屏显示”权限检测,引导用户开启,否则就算系统通用权限已授权,界面依然会被拦截在锁屏下层。

二、锁屏界面下的点击交互适配逻辑

  • 触摸事件的基础放行配置
    在Activity初始化阶段添加WindowManager.LayoutParams.FLAG_TOUCHABLE_WHEN_LOCKED标记,允许锁屏状态下的窗口正常接收触摸事件,避免Keyguard系统层拦截按钮点击。移除默认的FLAG_NOT_FOCUSABLE标记,保证输入类控件可以正常获得焦点。
  • 按锁屏状态分支处理交互
    通过KeyguardManager判断当前锁屏状态,分支响应点击逻辑:
    • 非安全锁屏(滑动解锁、无设备锁):所有按钮点击逻辑正常响应,用户点击接听按钮时,直接调用系统接口关闭锁屏,进入完整通话界面
    • 安全锁屏(密码、指纹、面容锁):仅开放两个核心操作的点击响应
      • 挂断按钮:点击后直接触发挂断通话逻辑,无需引导用户解锁
      • 接听按钮:点击后唤起系统生物识别/密码解锁流程,等用户完成解锁后,再开放静音、免提、通话记录入口等次级交互的点击响应,避免锁屏状态下误触
  • 交互规范对齐
    锁屏状态下的通话界面不要展示非核心的操作按钮(比如添加通话、切换网络),这类操作等界面完全进入解锁后的前台状态再展示,避免不符合系统交互规范导致的体验问题。

内容的提问来源于stack exchange,提问作者Tushar Kumar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 08:06:04