开发者中心
中文
中文 English
体验APP下载
开发者中心
体验APP下载
控制台
立即注册
登录控制台
中文站 English
实时音频 ▼
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序
示例源码
本地下载
  • 本地下载
  • GitHub下载
说明

1 示例代码运行指引

1.1 准备环境

请确保开发环境满足以下技术要求（以下说明皆以 MacOS 开发电脑为例)：

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

首次编译示例代码时，没有对应的依赖库或者构建工具，Android Studio 会自行下载示例代码，可能需要较长时间，请耐心等待。

建议下载特定的 gradle 及所需的依赖库，请确保开发电脑已经连接到 Internet 且能正常访问 https://services.gradle.org 。

示例代码中使用的gradle相关版本如下：

  • gradle： 4.6（可以在 project/gradle/wrapper/gradle-wrapper.properties 文件中查看）
  • gradle Android 插件： 3.2.1（可以在 project/build.gradle 文件中查看）

1.2 前提条件

请到 即构管理控制台 注册账号并申请初始化 SDK 时需要的 AppID 与 AppSign，申请流程请参考 项目管理。

1.3 运行示例代码

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

    若开发电脑上未安装该软件，可以参照如下方式操作：

    方式1：登录 Android Studio 官网 下载并安装Android Studio及其相关的SDK Tools。由于国内运营商网络限制等原因，开发者需要确保本机能连接该网站，若无法访问建议选择方式2。

    方式2：使用搜索引擎搜索 Android Studio 下载、Android Studio 安装 和 Android Studio SDK Tools 安装，查找可下载的源网站，并安装相关软件和工具。

  2. 打开 Android Studio 软件，并单击 Open an existing Android Studio project。

  3. 选择在本文档开头位置已下载好的示例代码 ./video (Video SDK Demo) 或 ./audio (Audio SDK Demo)，并打开。

  4. （可选）从 Github 下载的示例源码中缺少 SDK 包，需要先从 ZegoExpress Android 下载 SDK 包，并将解压后的 jar 包和 so 拷贝到 ./video/main/libs/ (Video SDK Demo) 或 ./audio/app/libs/ (Audio SDK Demo) 目录下。

    从压缩包下载的示例源码中已包含 SDK 包，请跳过此步骤。

  5. 下载的示例代码中缺少 SDK 初始化所需的 appID 和 appSign，需要修改 ./video/common/src/main/java/im/zego/common/ (Video SDK Demo) 或 ./audio/common/src/main/java/im/zego/common/ (Audio SDK Demo) 目录下的 GetAppIdConfig.java 文件。请使用本文“前提条件”已获取的 AppID 和 AppSign正确填写（注意：需要在 AppID 后加 L），否则示例代码无法正常运行。

  6. 选择一台已连接到Internet的Android真机设备（推荐）或模拟器，当该设备成功开启开发者模式和 USB 调试功能后，可以看到 Android Studio 由下图：

    变为下图：

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

当开发电脑连接 Android 设备后，大部分设备会弹出提示，不同 Android 厂商的提示信息有所不同，可根据情况选择 USB 模式。

当 Android 设备连接开发电脑后，需要根据情况在该设备上开启开发者模式和 USB 调试功能（不同厂商的 Android 设备开启方式不同）。具体开启方式可以使用搜索引擎搜索。 例如：目前存在一台未开启过开发者模式与 USB 调试功能的 魅族 Pro 5 设备，可以在搜索引擎搜索 魅族 Pro 5 开启开发者模式，查看具体的开启教程。

  1. 单击 Android Studio 软件上的 build and run 按钮，编译并运行示例代码。

    若运行过程中出现问题，请联系即构技术支持工程师。

2 常见问题

  1. Android Studio 运行下载的示例代码时报 非法的表达式怎么办？

 由于下载的示例源码中，AppID 和 AppSign 没有具体的值，请参考本文“运行示例代码”章节中的步骤5进行处理。

  1. Android Studio 运行下载的示例源码时报 程序包im.zego.zegoexpress不存在 怎么办？

 由于在中国大陆访问 GitHub 较慢，从 Github 下载 的示例源码中并不包含 ZegoExpressEngine SDK，所以会报指定程序包不存在的问题，请参考本文“运行示例代码”章节中的步骤4进行处理。

  • 免费试用

  • 联系我们