秀场直播
  • 概述
  • 体验 App
  • 跑通示例源码
  • SDK 集成指引
  • 实现流程
  • API 文档
  • 常见错误码

Android

更新时间:2022-08-03 18:50

Android
示例源码
本地下载

源码为 GoEnjoy Android 客户端源码,包含 3 个应用场景:秀场直播、在线KTV、互动播客。下文介绍如何运行源码:

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

1 准备环境

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

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

2 前提条件

为了有更好的直播体验,在申请秀场直播的 AppID 和 AppSign 时需要配置 L3(低延迟直播),如有疑问请联系 ZEGO 技术支持。

3 运行源码

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

    /Pics/GoEnjoy/online_KTV/SampleCodes/Android_Studio_icon.png

  2. 打开 Android Studio,单击 “Open an existing project”。

  3. 选择在本文档开头位置已下载好的源码并打开。

  4. 下载的源码中缺少相关 SDK 包,请参考 在线KTV - 下载 获取最新版本的 SDK,解压后将相关文件放入项目的 “app/libs” 目录下。

  5. 下载的源码中缺少 SDK 初始化所需的 APP_ID 和 APP_SIGN,需要修改 “ktv/src/main/java/im/zego/ktv”(实时合唱 KTV), “goChat/src/main/java/im/zego/gochat”(互动播客)和“Liveshow/src/main/java/im/zego/liveshow”(秀场直播)目录下的 “AuthConstants.java” 文件。

    请使用本文 2 前提条件 已获取的 AppID 和 AppSign 正确填写(注意:需要在 AppID 后加 “L”),否则源码无法正常运行。

    GoEnjoy 中包含 “在线KTV(实时合唱)”,“互动播客”和“秀场直播”三个项目,需要分别填写 AppID 和 AppSign。

    开发者可以使用同一个 APP_ID 和 APP_SIGN,将不做项目区分。如果无法从控制台获取 AppSign,请联系 ZEGO 技术支持获取。

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

    同时需要将业务后台地址配置在 “BackendApiConstants.java” 的对应字段中。业务后台地址请联系 ZEGO 技术支持获取。
    注意:ZEGO 技术支持提供的业务后台地址仅用于跑通示例源码,切勿用于正式产品上线。若您需要上线正式产品,请自行编写后台代码,同时搭建自己的业务后台。

    /**
     * 业务后台地址请联系技术支持获取
     */
    public class BackendApiConstants {
        // 业务后台地址
        public final static String BACKEND_API_URL = "";  
    }
  1. 选择一台 Android 真机设备链接到开发电脑,当该设备成功开启“开发者模式”和“USB 调试功能”后,可以看到 Android Studio 由下图:

    变为下图:

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

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