跑通示例源码

说明

请联系 ZEGO 商务人员，获取最新的 大饼 AI 变声 示例源码包，并开通相关权限，然后参考本文档跑通源码，体验 AI 变声效果。

准备环境

在运行示例源码前，请确保开发环境满足以下要求（以下说明皆以 macOS 开发电脑为例)：

Android Studio 2020.3.1 或以上版本。
Android SDK 30、Android SDK Platform-Tools 30.x.x 或以上版本。
Android 4.4 或以上版本，且支持音视频的 Android 真机设备，并开启“允许调试”选项。
Android 设备、macOS 开发电脑已经连接到 Internet。

说明

首次编译示例源码时，如果没有对应的依赖库或者构建工具，Android Studio 会自动下载示例源码，可能需要较长时间，请耐心等待。
建议下载特定的 Gradle 及所需的依赖库，请参考 Gradle Services 下载。示例源码中使用的 Gradle 相关版本如下：
- Gradle：6.7.1（在 “project/gradle/wrapper/gradle-wrapper.properties” 文件中查看）。
- Android Gradle 插件：4.2.0（在 “project/build.gradle” 文件中查看）。关于 Android Gradle 插件、Gradle、SDK Tool 之间的版本依赖关系，请查看：Android Gradle 插件版本说明

前提条件

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目管理中的“项目信息”。
已参考控制台 - 云市场 - 大饼 AI 变声，按照页面指引，自助开通 大饼 AI 变声 相关权限。

示例源码目录结构

下面目录结构为 android_java 子目录的文件结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├─ README.md
├─ README_zh.md
├─ VERSION.txt
└─ ZegoExpressExample
       ...
       ├─ AdvancedAudioProcessing    # 音频进阶功能
       ├─ AdvancedStreaming          # 推流、拉流进阶
       ├─ AdvancedVideoProcessing    # 视频进阶
       ├─ CommonFeatures             # 常用功能
       ├─ CommonTools
       ├─ DebugAndConfig             # 调试与配置
       ├─ KeyCenter                  # 在里面的 KeyCenter.java 文件中填写申请的 AppID 和 AppSign
       ├─ Others                     # 其他功能
       ├─ Quickstart                 # 开速开始
       ├─ Scenes                     # 最佳实践
       ├─ build.gradle
       ├─ gradle
       ├─ gradle.properties
       ├─ gradlew
       ├─ gradlew.bat
       ├─ local.properties
       ├─ log
       ├─ main
       │    ├─ .gitignore
       │    ├─ build
       │    ├─ build.gradle
       │    ├─ libs                # ZegoExpressVideo Android SDK 存放目录
       │    ├─ proguard-rules.pro
       │    ├─ src
       │    └─ wrap
       └─ settings.gradle

.
├─ README.md
├─ README_zh.md
├─ VERSION.txt
└─ ZegoExpressExample
       ...
       ├─ AdvancedAudioProcessing    # 音频进阶功能
       ├─ AdvancedStreaming          # 推流、拉流进阶
       ├─ AdvancedVideoProcessing    # 视频进阶
       ├─ CommonFeatures             # 常用功能
       ├─ CommonTools
       ├─ DebugAndConfig             # 调试与配置
       ├─ KeyCenter                  # 在里面的 KeyCenter.java 文件中填写申请的 AppID 和 AppSign
       ├─ Others                     # 其他功能
       ├─ Quickstart                 # 开速开始
       ├─ Scenes                     # 最佳实践
       ├─ build.gradle
       ├─ gradle
       ├─ gradle.properties
       ├─ gradlew
       ├─ gradlew.bat
       ├─ local.properties
       ├─ log
       ├─ main
       │    ├─ .gitignore
       │    ├─ build
       │    ├─ build.gradle
       │    ├─ libs                # ZegoExpressVideo Android SDK 存放目录
       │    ├─ proguard-rules.pro
       │    ├─ src
       │    └─ wrap
       └─ settings.gradle

运行示例源码

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

在开发电脑上安装 Android Studio 的方式

方式 1：登录 Android Studio 官网下载并安装 Android Studio 及其相关的 SDK Tools。由于国内运营商网络限制等原因，开发者需要确保本机能连接该网站，若无法访问建议选择方式 2。
- 方式 2：使用搜索引擎搜索 “Android Studio 下载”、“Android Studio 安装” 和 “Android Studio SDK Tools 安装”，查找可下载的源网站，并安装相关软件和工具。

打开 Android Studio，单击 “Open an Existing Project”。
在解压后的示例源码文件夹中，选择 ZegoExpressExample 文件夹，并单击 “Open” 打开。

修改 “./KeyCenter/src/main/java/im/zego/keycenter” 目录下的 “KeyCenter.java” 文件，填写 SDK 初始化所需的 “appID” 和 “appSign”。

注意
请使用本文前提条件已获取的 AppID 和 AppSign 正确填写，否则示例源码无法正常运行。
将 Android 设备链接到开发电脑，当该设备成功开启“开发者模式”和“USB 调试”功能后，可以看到 Android Studio 上方的 “Running Devices” 选项框由下图：

变为下图：

即 Android Studio 已成功连接到 Android 设备，可以将示例源码运行到该设备上了。

说明

当开发电脑连接 Android 设备后，大部分设备会弹出提示，不同 Android 厂商的提示信息有所不同，可根据情况选择 USB 模式。
当 Android 设备连接开发电脑后，需要根据情况在该设备上开启开发者模式和 USB 调试功能（不同厂商的 Android 设备开启方式不同）。具体开启方式开发者可以需要自行搜索引擎搜索，例如：目前存在一台未开启过开发者模式与 USB 调试功能的某设备，可以在搜索引擎搜索“某设备开启开发者模式”，查看具体的开启教程。

单击 “Run” 按钮，编译并运行示例源码。

常见问题

Android Studio 运行下载的示例源码时报错“错误：非法的表达式开始 :9”，如何处理？

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