Agora Chat Callkit：APP关闭时如何发送原生呼叫邀请？

Agora是否自行处理VoIP通知？ #

Agora CallKit 不直接处理Android平台的VoIP推送通知——因为Android没有原生的系统级VoIP推送通道，离线呼叫唤醒依赖第三方推送服务（如FCM、小米推送、华为推送等）完成。Agora仅负责在呼叫发起时，将呼叫指令通过你配置的第三方推送通道下发给被叫方，具体的通知展示、APP唤醒需要开发者结合推送SDK自行实现。

APP关闭时实现呼叫邀请界面的流程 #

1. 配置第三方推送服务

   • 在目标推送平台完成应用注册，获取推送凭证（如Server Key），并在Agora控制台的对应项目中配置这些凭证，确保Agora服务器能通过推送平台下发呼叫通知。
   • 在Android项目中集成对应推送SDK，实现推送消息的监听与接收逻辑。

2. 处理离线呼叫通知

   • 当APP进程被关闭时，Agora会通过第三方推送平台向被叫方发送呼叫邀请的推送消息。
   • 推送SDK收到消息后，在系统通知栏生成呼叫提示；用户点击通知时，需启动一个专用的呼叫界面Activity（可设为透明过渡页避免闪屏），同时初始化Agora Chat和CallKit实例，重新登录并恢复呼叫连接。

3. 构建呼叫邀请界面

   • 若要实现类似图中的悬浮呼叫界面：
     • Android 10及以下可申请SYSTEM_ALERT_WINDOW权限，通过自定义悬浮窗展示接听/挂断按钮及呼叫方信息；
     • Android 11及以上系统对后台弹窗限制严格，建议通过通知栏跳转至全屏呼叫界面，或适配Android Telecom框架的InCallService，实现符合系统规范的通话界面。

4. 同步呼叫状态

   • 拉起APP后，需重新登录Agora Chat，调用CallKit的状态同步接口，确保本地状态与Agora服务器一致，避免出现呼叫状态异常。

内容的提问来源于stack exchange，提问作者J. Doe