快速开始（包含呼叫邀请）

参考此文档，您可以了解并集成呼叫邀请功能。

准备环境

在开始集成音视频 UIKit 前，请确保开发环境满足以下要求：

• Android Studio 2020.3.1 或以上版本。
• Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK Platform-Tools 25.x.x 或以上版本。
• Android 4.4 或以上版本，且支持音视频的 Android 设备。
• Android 设备已经连接到 Internet。

前提条件

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 联系 ZEGO 技术支持，开通 UIKit 相关服务。

UI 实现效果

以下 Gif 为小米设备上的效果，不同设备可能会有不同的结果。

在线通话	在线通话（APP处于后台状态）	离线通话（APP被终止）

集成呼叫邀请功能

添加 ZegoUIKitPrebuiltCall 为依赖项

1. 添加 jitpack 配置。

根据您的 Android Gradle 插件版本，选择对应的实现步骤。

2. 修改您的 app 级别的 build.gradle 文件。

   Untitled

   dependencies {
       ...
       implementation 'com.github.ZEGOCLOUD:zego_uikit_prebuilt_call_android:+'   
   }
   

   1

   Copied!

初始化呼叫邀请服务

在用户登录后，调用init方法，并指定 userID 和 userName 来连接呼音视频通话服务。

我们建议在用户登录您的 App 后立即调用此方法。

1. 用户登录后，需要初始化 ZegoUIKitPrebuiltCallService 以接收呼叫邀请。
2. 用户登出时，需要调用 uninit 以清除先前的登录记录，以免影响下次登录。

Application application = ; // Android 应用程序上下文
long appID = ;   // 您的 AppID
String appSign =;  // 您的 AppSign
String userID =; // 您的 userID，userID应仅包含数字、英文字母和'_'
String userName =;   // 您的 userName

ZegoUIKitPrebuiltCallInvitationConfig callInvitationConfig = new ZegoUIKitPrebuiltCallInvitationConfig();
// 设置语言为中文
callInvitationConfig.translationText = new ZegoTranslationText(ZegoUIKitLanguage.CHS);

ZegoUIKitPrebuiltCallService.init(getApplication(), appID, appSign, userID, userName, callInvitationConfig);

ZegoUIKitPrebuiltCallService 组件属性

添加呼叫邀请按钮

您可以自定义 ZegoSendCallInvitationButton 的位置，传入您想要呼叫的用户的ID。

String targetUserID = ; // 呼叫目标的用户 ID。
String targetUserName = ; // 呼叫目标的用户名。
Context context = ; // Android上下文。

ZegoSendCallInvitationButton button = new ZegoSendCallInvitationButton(context);
button.setIsVideoCall(true);
button.setInvitees(Collections.singletonList(new ZegoUIKitUser(targetUserID,targetUserName)));

ZegoSendCallInvitationButton 属性

如需了解更多参数，请参考 自定义通话。

至此，您可以通过点击此按钮进行呼叫邀请。

运行和测试

至此，您已经完成了所有步骤！

只需在 Android Studio 中点击 Run 即可在设备上运行和测试您的应用程序。

相关指南

资源