


请确保开发环境满足以下技术要求(以下说明皆以 MacOS 开发电脑为例):
首次编译示例代码时,没有对应的依赖库或者构建工具,
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
文件中查看)
请到 即构管理控制台 注册账号并申请初始化 SDK 时需要的 AppID 与 AppSign,申请流程请参考 项目管理。
在开发电脑中找到 Android Studio 软件图标。
若开发电脑上未安装该软件,可以参照如下方式操作:
方式1:登录 Android Studio 官网 下载并安装Android Studio及其相关的SDK Tools。由于国内运营商网络限制等原因,开发者需要确保本机能连接该网站,若无法访问建议选择方式2。
方式2:使用搜索引擎搜索
Android Studio 下载
、Android Studio 安装
和Android Studio SDK Tools 安装
,查找可下载的源网站,并安装相关软件和工具。
打开 Android Studio
软件,并单击 Open an existing Android Studio project
。
选择在本文档开头位置已下载好的示例代码 ./video
(Video SDK Demo) 或 ./audio
(Audio SDK Demo),并打开。
(可选)从 Github 下载的示例源码中缺少 SDK 包,需要先 下载 SDK 包 ,并将解压后的 jar 包和 so 拷贝到 ./video/main/libs/
(Video SDK Demo) 或 ./audio/app/libs/
(Audio SDK Demo) 目录下。
从压缩包下载的示例源码中已包含 SDK 包,请跳过此步骤。
下载的示例代码中缺少 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),否则示例代码无法正常运行。
选择一台已连接到Internet的Android真机设备(推荐)或模拟器,当该设备成功开启开发者模式和 USB 调试功能后,可以看到 Android Studio 由下图:
变为下图:
说明 Android Studio 软件已成功连接到 Android 设备,可以将示例代码运行到该设备上了。
当开发电脑连接 Android 设备后,大部分设备会弹出提示,不同 Android 厂商的提示信息有所不同,可根据情况选择 USB 模式。
当 Android 设备连接开发电脑后,需要根据情况在该设备上开启开发者模式和 USB 调试功能(不同厂商的 Android 设备开启方式不同)。具体开启方式可以使用搜索引擎搜索。 例如:目前存在一台未开启过开发者模式与 USB 调试功能的
魅族 Pro 5
设备,可以在搜索引擎搜索魅族 Pro 5 开启开发者模式
,查看具体的开启教程。
单击 Android Studio 软件上的 build and run 按钮,编译并运行示例代码。
若运行过程中出现问题,请联系即构技术支持工程师。
Android Studio 运行下载的示例代码时报 非法的表达式
怎么办?
由于下载的示例源码中,AppID 和 AppSign 没有具体的值,请参考本文“运行示例代码”章节中的步骤5进行处理。
Android Studio 运行下载的示例源码时报 程序包im.zego.zegoexpress不存在
怎么办?
由于在中国大陆访问 GitHub 较慢,从 Github 下载 的示例源码中并不包含 ZegoExpressEngine
SDK,所以会报指定程序包不存在的问题,请参考本文“运行示例代码”章节中的步骤4进行处理。
免费试用
联系我们