跑通示例源码

跑通示例源码

1 概览

本文介绍如何快速跑通示例源码，体验数据流录制回放服务。

2 准备环境

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

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

3 前提条件

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理。
• 已下载示例源码，并解压在本地。

4 示例源码结构

以下为 “ZegoRecorderExample” 子目录的文件结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├── app    --------------------------------------------Example主module，包含一些界面展示和API请求的示例逻辑
│   ├── build.gradle
│   ├── proguard-rules.pro
│   └── src
├── build.gradle
├── commonlibs   --------------------------------------Example依赖的SDK库和一些简单的封装，包括Express、文件白板SDK、回放SDK
│   ├── build.gradle
│   ├── libs
│   └── src
├── gradle
│   └── wrapper
├── gradle.properties
├── gradlew
├── gradlew.bat
├── local.properties
├── recordplayer   ------------------------------------对回放SDK的封装，将多媒体流、文件白板流整合成一个可直接复用的回放播放器，提供给Example使用
│   ├── build.gradle
│   └── src
└── settings.gradle

5 运行示例源码

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

   

2. 打开 Android Studio 软件，并单击 “Open an Existing Project”。
   

   

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

   

4. 从 GitHub 下载的示例源码中缺少相关 SDK 包，请参考 下载 SDK 包 获取最新的 SDK 包，解压后将相关文件放入项目的 “app/libs” 目录下。

   

   “本地下载”的示例源码包中已集成 SDK，无需补充，请跳过此步骤。

5. 下载的示例源码中缺少 SDK 初始化所需的 APP_ID 和 APP_SIGN，需要修改 “KeyCenter.java” 文件。位置如下图：

   

   请使用本文 3 前提条件 已获取的 AppID 和 AppSign 正确填写（需要在 AppID 后加字符 “L”），否则示例源码无法正常运行。

   

6. 选择一台已连接到 Internet 的 Android 真机设备（推荐）或模拟器，当该设备成功开启开发者模式和 USB 调试功能后，可以看到 Android Studio 变为下图，说明 Android Studio 软件已成功连接到 Android 设备，可以将示例源码运行到该设备上了。

   

7. 单击 Android Studio 软件上的 “build and run” 按钮，编译并运行示例源码。若运行过程中出现问题，请联系 ZEGO 技术支持。

   

8. 运行成功后会在 Android 设备上看到如下画面，开发者可以输入录制的回放任务 ID 体验录制回放功能。