虚拟语聊房Demo及示例源码运行指引

虚拟语聊房是元宇宙场景里一种新颖的语聊玩法，通过虚拟形象代替真人出镜，进行互动连麦语聊。在延续真人神秘感的同时，增加麦上用户之间的互动性，支持表情随动、声音驱动等多种 AI 驱动模式，满足多种业务场景。

本文将分享即构虚拟语聊房Demo示例源码以及运行指引，供开发者接入时参考。

虚拟语聊房预览图

虚拟语聊房源码下载

本源码为虚拟语聊体验App Android 客户端源码。(iOS端可到即构开发者中心另行下载)

下载地址：https://storage.zego.im/GoEnjoy/Android/sourceCode/GoMetaChat_Android_Sourcecode.zip

虚拟语聊房源码运行指引

准备环境

在运行体验 App 源码前，请确保开发环境满足以下要求（以下说明以 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、AppSign，以及自己项目的包名 applicationId，以开通 Avatar 服务。

运行源码

1、下载并解压体验 App 源码，得到 “GoMetaChat_Android_Sourcecode” 文件夹。

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

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

4、选择并打开 “GoMetaChat_Android_Sourcecode”。

5、修改 “/app/build.gradle” 文件，将 applicationId 修改为你的项目的包名。

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

按照文件路径 “/MetaChat/src/main/java/im/zego/metachat” 找到 “KeyCenter.java” 文件。

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

/**
 * 当您从ZEGO申请到 APP_ID 和 APP_SIGN 之后，我们强烈建议您将其通过服务器下发到APP，而不是保存在代码当中
 * 这里将其保存在代码当中，只是为了执行demo
 *
 * APP_ID，APP_SIGN：从 ZEGO 官网控制台或者技术支持获取
 */
public class KeyCenter {
    // APP_ID：从 ZEGO 官网控制台或者技术支持获取
    public static final long APP_ID = YOUR_APP_ID;

    // APP_SIGN：从 ZEGO 官网控制台或者技术支持获取
    public final static String APP_SIGN = YOUR_APP_SIGN;

    /**
     * BACKEND_API_URL: 后台地址，如果访问错误请联系技术支持
     * 体验 App 源码提供的业务后台地址仅用于跑通体验 App 源码，请勿用于正式产品上线。
     * 若您需要上线正式产品，请自行编写后台代码，同时搭建自己的业务后台。
     */
    public static final String BACKEND_API_URL = "https://demo-server-sh.imzego.com";

}

7、选择一台 Android 真机设备链接到开发电脑，当该设备成功开启“开发者模式”和“USB 调试功能”后，可以看到 Android Studio 由下图：