体验 App 源码运行指引

源码为虚拟直播体验 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 运行源码

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

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

   

3. 打开 Android Studio，单击 “Open”。

   

4. 选择并打开 “GoMetaLive_Android_Sourcecode”。

   

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

   

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";
   }

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

   
   说明 Android Studio 软件已成功连接到 Android 设备，可以将源码运行到该设备上了。

8. 单击 Android Studio 软件上的 “build and run” 按钮，编译并运行源码。

   

常见问题

Android 示例源码运行时，如果报错 “Unrecognized option: --add-opens=java.base/java.io=ALL-UNNAMED”，该如何处理？

有两种解决方案：

• 升级 Android Studio 至最新版本，重新运行即可。

• 找到项目的 gradle.properties 文件，删除 --add-opens=java.base/java.io=ALL-UNNAMED 并保存，重新运行即可。