语聊房
  • iOS
  • Android : Java
  • 概述
  • 体验 App
  • 体验 App 源码运行指引
  • 实现流程
  • API 文档
  • 常见错误码

体验 App 源码运行指引

更新时间:2022-10-13 18:29

Android
体验 App 源码
CodeStore 下载

源码为 Android 客户端体验 App 源码。下文介绍如何运行体验 App 源码。

  • 该源码仅供开发者接入时参考,ZEGO 不负责维护因修改源码而产生的问题。
  • 若开发者计划将该源码用于生产环境,请确保发布前进行充分测试,避免发生潜在问题造成损失。
  • 更多源码,请前往 CodeStore 获取。

准备环境

在运行体验 App 源码前,请确保开发环境满足以下要求(以下说明以 macOS 开发电脑为例):

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

前提条件

运行体验 App 源码

  1. 下载并解压体验 App 源码,得到 "GoChatHouse_Android_Sourcecode" 文件夹。

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

    /Pics/GoEnjoy/online_KTV/SampleCodes/AS_icon.png

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

  4. 打开体验 App 源码。

  5. 体验 App 源码中缺少 SDK 初始化所需的 APP_ID 和 APP_SIGN。
    按照文件路径 “/chathouse/src/main/java/im/zego/chathouse” 找到 “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";
    
    }
  • 由于体验 App 源码提供的业务后台地址对房间数量有所限制,同一个 AppID 同时创建的房间数量上限为 10。所以此后台地址仅限用于跑通体验 App 源码,请勿用于正式产品上线。
  • 若您需要上线正式产品,请自行搭建业务后台。
  1. 选择一台 Android 真机设备链接到开发电脑,当该设备成功开启“开发者模式”和“USB 调试功能”后,可以看到 Android Studio 由下图:

    /Pics/GoEnjoy/chathouse/Android/before_link_devices_Android_chat_house.png

    变为下图:

    /Pics/GoEnjoy/chathouse/Android/after_link_devices_Andriod_chat_house.png

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

  2. 单击 Android Studio 软件上的 “build and run” 按钮,编译并运行体验 App 源码。

    /Pics/GoEnjoy/chathouse/Android/demo_build_Andriod_chat_house.png