体验 App 源码运行指引

更新时间：2023-04-27 17:44

Android

体验 App 源码

CodeStore 下载

该源码仅供开发者接入时参考，ZEGO 不负责源码的后续维护。若开发者计划将该源码用于生产环境，请确保发布前进行充分测试，避免发生潜在问题造成损失。
该源码中提供的业务后台地址仅用于跑通示例源码，如果您需要上线正式产品，请自行编写、搭建自己的业务后台。
更多相关源码，请参考 CodeStore。

源码为虚拟直播体验 App Android 客户端源码。下文介绍如何运行源码：

1 准备环境

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

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

2 前提条件

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

3 运行源码

从本文档开头下载源码，在本地解压缩后，得到 “GoMetaLive_Android_Sourcecode” 文件夹。
在开发电脑中找到 Android Studio 软件图标。
打开 Android Studio，单击 “Open”。
选择并打开 “GoMetaLive_Android_Sourcecode”。
修改源码的 “/app/build.gradle” 文件中的 applicationId 为你的项目的包名。

下载的源码中缺少 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";
}

由于体验 App 源码提供的业务后台地址对房间数量有所限制，同一个 AppID 同时创建的房间数量上限为 10。所以此后台地址仅限用于跑通体验 App 源码，请勿用于正式产品上线。
若您需要上线正式产品，请自行搭建业务后台。

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

说明 Android Studio 软件已成功连接到 Android 设备，可以将源码运行到该设备上了。
单击 Android Studio 软件上的 “build and run” 按钮，编译并运行源码。