虚拟直播Demo(体验APP源码)运行指引

虚拟直播场景为元宇宙社交娱乐模式下的全新直播方式，虚拟形象替代真人出镜，打造不一样的直播体验，支持表情随动、手势识别触发特效等多种玩法；同时场景支持多位虚拟形象视频连麦互动，更容易吸引用户参与连麦互动，提升用户的消费意愿及粘性。

本文分享源码为虚拟直播体验 App Android 客户端源码，下载地址：https://codestore.zego.im/project/6

准备环境

在运行源码前，请确保开发环境满足以下要求（以下说明以 macOS 开发电脑为例）：

Android Studio Arctic Fox (2020.3.1) 或以上版本。
已下载 Android SDK 30 和 Android SDK Platform-Tools 30。
建议使用 Android 9.0 或以上版本，且支持音视频的 Android 设备，请开启“允许调试”选项。
Android 设备、macOS 开发电脑已经连接到 Internet。

前提条件

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 – 项目管理 – 项目信息。
已在 ZEGO 控制台开通即时通讯服务，详情请参考控制台 – 项目管理 – 服务配置 – 即时通讯。
已联系 ZEGO 技术支持，提供申请到的 AppID，以及自己项目的包名 applicationId，以开通 Avatar 服务。

运行源码

3.1 从本文档开头下载源码，在本地解压缩后，得到 “GoMetaLive_Android_Sourcecode” 文件夹。

3.2 在开发电脑中找到 Android Studio 软件图标。

3.3 打开 Android Studio，单击 “Open”。

3.4 选择并打开 “GoMetaLive_Android_Sourcecode”。

3.5 修改源码的 “/app/build.gradle” 文件中的 applicationId 为你的项目的包名。

3.6 下载的源码中缺少 SDK 初始化所需的 APP_ID 和 APP_SIGN。

按照文件路径 “/MetaLive/src/main/java/im/zego/metalive”，找到 “KeyCenter.java” 文件。

使用本文 2 前提条件已获取的 AppID 和 AppSign 正确填入（注意：需要在 AppID 后加 “L”），否则源码将无法正常运行。

/**
 * 当您从 ZEGO 控制台申请到 APP_ID 和 APP_SIGN 之后，我们强烈建议您将其通过服务器下发到APP，而不是保存在代码当中，或者使用更安全的 Token 鉴权
 * 这里将其保存在代码当中，只是为了执行体验 App
 */
public class KeyCenter {
    // APP_ID：从 ZEGO 控制台申请
    // 使用 Avatar 虚拟形象时，需要和 applicationId 做绑定
    // 建议在 AppID 数字后面添加大写的L，避免编译错误
    public static final long APP_ID = YOUR_APP_ID;

    // APP_SIGN：从 ZEGO 控制台申请
    public static final String APP_SIGN = YOUR_APP_SIGN;

    // BACKEND_API_URL: ZEGO 提供的业务后台地址
    // 仅用于跑通示例源码，请勿用于正式产品上线，若您需要上线正式产品，请自行搭建业务后台
    public static final String BACKEND_API_URL = "https://demo-server-sh.imzego.com";
}

3.7 选择一台 Android 真机设备连接到开发电脑，当该设备成功开启“开发者模式”和“USB 调试功能”后，可以看到 Android Studio 界面已检测到该设备，如下图所示：