向离线应用发送呼叫邀请

功能简介

音视频通话 UIKit（Call Kit）支持向离线应用（即在后台被冻结或遭系统或用户杀掉的应用）发送呼叫邀请。

前提条件

在实现“离线推送”功能之前，请确保已集成最新版本的音视频通话 UIKit（Call ），并且完成在线邀请功能。详情请参考快速开始（包含呼叫邀请）。

实现流程

1 接入第三方厂商离线推送通道

集成所需的第三方厂商离线推送 SDK，接入各厂商的离线推送通道，详情请参考：

2 配置第三方推送通道

调用 enableHWPush/enableMiPush/enableVivoPush/enableOppoPush 启用所需的第三方推送，随后调用 ZegoUIKitPrebuiltCallService.init 接口完成初始化。

Untitled

long appID = ; // 您的 ZEGO 项目 appID
String appSign = ; // 您的 ZEGO 项目 appSign
String userID = ; // 由您定义的用户 ID
String userName = ; // 由您定义的用户名称

// 启用华为推送的方法
ZegoUIKitPrebuiltCallService.enableHWPush({hwAppID}); 

// 启用小米推送的方法
ZegoUIKitPrebuiltCallService.enableMiPush({miAppID},{miAppKey}); 

// 启用 vivo 推送的方法
ZegoUIKitPrebuiltCallService.enableVivoPush({vivoAppID}, {vivoAppKey}); 

// 启用 OPPO 推送的方法
ZegoUIKitPrebuiltCallService.enableOppoPush({oppoAppID},{oppoAppKey},{oppoAppSecret}); 

// 初始化
ZegoUIKitPrebuiltCallService.init(getApplication(), appID, appSign, userID, userName, callInvitationConfig);

Copied!

在 ZegoUIKitPrebuiltCallService.init 成功之后，Call Kit 会注册离线推送功能，你可以可以在 Android logcat 控制台中查看验证推送所需要的厂商 deviceToken 和 ZEGO的 pushID。

3 发送呼叫邀请

您可以根据所需效果，从以下方式中选择最适合的实现发送呼叫邀请。

最便捷：使用 ZegoSendCallInvitationButton 来发送呼叫邀请，并使用 setResourceID() 接口传入您在控制台配置的 resourceID 字段的值。
Untitled
ZegoSendCallInvitationButton newVideoCall = ...; newVideoCall.setResourceID(...);
1
Copied!

如需自定义邀请按钮：使用 ZegoUIKitPrebuiltCallService.sendInvitationWithUIChange()来发送呼叫邀请，传入您在控制台配置的 resourceID 字段的值，前者将使用默认的通知标题和正文。

Untitled

Activity activity = ;  //Android 上下文
List<ZegoUIKitUser> invitees =;  // 呼叫邀请的目标用户ID
ZegoInvitationType type =;   // 呼叫邀请类型
String resourceID = ; //离线呼叫邀请需要传入，从控制台获取
PluginCallbackListener callbackListener = ; // 呼叫邀请回调
ZegoUIKitPrebuiltCallService.sendInvitationWithUIChange(activity,invitees,type,resourceID,callbackListener);

Copied!

如需自定义通知的标题和正文：使用 ZegoUIKitPrebuiltCallService.sendInvitationWithUIChange() 来发送呼叫邀请，传入 notificationConfig 的重载方法传入您在控制台配置的 resourceID 字段的。

Untitled

// 如果需要完全的自定义 
Activity activity = ;  //Android 上下文
List<ZegoUIKitUser> invitees =;  // 呼叫邀请的目标用户ID
ZegoInvitationType type =;   // 呼叫邀请类型
String customData =;  // 透传的数据
String title =;  // 通知的标题
String message =;  // 通知的正文
String resourceID = ; //离线呼叫邀请需要传入，从控制台获取
ZegoSignalingPluginNotificationConfig notificationConfig = new ZegoSignalingPluginNotificationConfig();
notificationConfig.setResourceID(resourceID);
notificationConfig.setTitle(title);
notificationConfig.setMessage(message);
PluginCallbackListener callbackListener = ; // 呼叫邀请回调
ZegoUIKitPrebuiltCallService.sendInvitationWithUIChange(activity, invitees, type, customData, notificationConfig,callbackListener)

Copied!