实时音频
  • 平台类型
  • 框架 / 引擎

运行示例代码

更新时间:2020-06-02 14:06

1 下载示例代码

下载示例代码
下载

快速开始请参考 src/ZegoExpressExample/quickstart/ 文件夹下的代码,实现了最简单的推拉流功能。

2 示例代码运行指引

2.1 准备环境

请确保开发环境满足以下技术要求(以下说明皆以 MacOS 为例):

  • Android Studio 2.1 或以上版本
  • 已经下载好 Android SDK 28、Android SDK Platform-Tools 28..
  • Android 版本不低于 4.0.3 且支持音视频的 Android 设备或模拟器(推荐使用真机),如果是真机,请开启“允许调试”选项。
  • Android 设备已经连接到 Internet

注意

首次编译项目时,可能需要下载特定的 gradle 及需要的依赖库,所以请确保开发电脑已经连接到 Internet 且能正常访问 https://services.gradle.org ,示例代码中使用的 gradle版本 是 4.6(可在 project/gradle/wrapper/gradle-wrapper.properties 文件中查看),gradle Android 插件版本 是 3.2.1(可在 project/build.gradle 文件中查看)。

2.2 运行示例代码

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

    若未开发电脑上未下载,需要从 Android Studio 官网 下载该软件, 由于运营商网络限制等原因,开发者需要确保本机能连上该网站下载,或者可以自行使用搜索引擎搜索 Android Studio 下载 以找到可下载的源网站。

    Android Studio 的安装链接 参考 ,由于国内网络限制等原因,开发者需要确保本机能连上该网站下载,或者可以自行使用搜索引擎搜索 Android Studio 安装 以参考安装教程。

    Android StudioSDK Tools 安装与更新 参考 ,由于运营商网络限制等原因,开发者需要确保本机能连上该网站下载,或者可以自行使用搜索引擎搜索 Android Studio SDK Tools 安装 以参考安装教程。

  2. 选中并打开 Android Studio 软件,并点击 Open an existing Android Studio project

  3. 选择在本文档开头的地方下载好的示例代码 .../zego-express-example-topics-android/src/ZegoExpressExample,此过程由于首次打开,没有对应的依赖库或者构建工具,Android Studio 会自行下载,可能会比较久。

  4. 从 Github 下载的示例源码中缺少 SDK 包(从码云下载的示例源码中已经包含 SDK 包),需要先从 ZegoExpress Android 下载 SDK 包,并将解压后的 jar 包和 so 拷贝到 /ZegoExpressExample/main/libs/ 目录下,如下图所示:

  5. 下载的示例代码中缺少 SDK 初始化必须的 AppID 和 AppSign,首先请到 ZEGO 管理控制台 注册账号并申请 appID 与 appSign,请参考 获取 appID 和 appSign 指引 获取 AppID 和 AppSign。如果没有填写正确的 AppID 和 AppSign,源码无法正常跑起来,所以需要修改 /ZegoExpressExample/common/src/main/java/im/zego/common/ 目录下的 GetAppIdConfig.java,补充正确的 AppID 和 AppSign。注意:需要在 AppID 后加 L,需要补充的地方请参考下图:

  6. 选择一台已连接的真机设备(推荐)或者虚拟机

    在开发电脑连接 Android 设备之后,一般情况,大部分安卓设备会弹出提示,提示会跟具体 Android 厂商不同而不同,可根据情况选择 USB 模式。

    在 Android 设备连接开发电脑之后,需要根据情况在 Android 设备上开启开发者模式,并开启 USB 调试的功能。由于 Android 设备厂商开启开发者模式与 USB 调试功能的方式并不一样,可以使用搜索引擎搜索具体 Android 设备开启开发者模式与 USB 调试模式的功能。
    例如:目前存在一台未开启过开发者模式与 USB 调试功能的 魅族 Pro 5 的 Android 设备,可以在搜索引擎搜索 魅族 Pro 5 开启开发者模式,可以看到具体开启的教程。

    当 Android 设备成功开启开发者模式与 USB 调试功能之后,可以看到 Android Studio 由下图:

    变为下图:

    说明 Android Studio 软件已连上 Android 设备,可以将 ZegoExpressExample 工程运行到设备上了。

  7. 点击 build and run 按钮进行编译并运行。

    若运行过程中出现问题,请联系 ZEGO 技术人员:

    电话/微信:189-3893-7493
    QQ:3485426954

3 FAQ

Q1: Android Studio 运行下载的 ZegoExpressExample 工程的时候报错,报非法的表达式怎么办?

  答:由于 ZegoExpressExample 工程的 appID、appSign 在一开始下载下来的时候并没有具体值,开发者需要到 ZEGO 管理控制台 注册账号并申请 appID 与 appSign,请参考 获取 appID 和 appSign 指引 获取 AppID 和 AppSign 。

Q2: Android Studio 运行下载的 ZegoExpressExample 工程的时候报错,报 错误: 程序包im.zego.zegoexpress不存在 怎么办?

  答:由于 GitHub 网站对国内网络情况不友好,从 Github 下载 到的 ZegoExpressExample 工程并不包含 ZegoExpressEngine 的 SDK,所以会报指定 程序包不存在的问题,需要先从 ZegoExpress Android 下载 SDK 包,并将解压后的 jar 包和 so 拷贝到 /ZegoExpressExample/main/libs/ 目录下,参考本文档 2.2 部分