本文档将介绍如何快速跑通 ARTC 示例项目,体验实时音视频功能。
示例源码下载
阿里云提供了开源示例项目,用于演示 ARTC SDK 的 API 使用方法,帮助开发者更直观地理解和集成 SDK 的各项功能,Android示例项目仓库。
前提条件
在运行示例项目之前,请确保开发环境满足以下要求:
开发工具:Android Studio 2020.3.1 及以上版本。
推荐配置:Androd Studio版本2024.1.2以上;Android Gradle 插件版本8.6.0;Gradle 版本推荐 8.7;使用 JDK 17。
说明使用低版本的Android Studio可能存在与AGP兼容性问题,如果遇到编译失败等问题,需要对应降低AGP、Gradle、JDK版本等。请参见Android Studio与AGP兼容性。
测试设备:Android 5.0(SDK API Level 21)及以上版本的测试设备。
说明推荐使用真机测试,模拟机可能存在功能缺失。
网络环境:需要稳定的网络连接。
应用准备:获取实时音视频应用的AppID和AppKey,详情请参见创建应用。
操作步骤
步骤一:获取示例项目
克隆 ARTC 示例项目到本地:
git clone https://github.com/MediaBox-Demos/amdemos-artc
该仓库包含 ARTC SDK 的多个 Native 平台的示例项目,其中 Android 平台示例项目位于Android/ARTCExample
目录下。
示例项目中包含了在客户端生成 Token 的相关代码以帮助您进行测试,
下面将介绍Android/ARTCExample
项目的文件结构。
├── Android //Android平台工程结构跟目录
│ ├── ARTCExample //API Example工程目录
│ ├── app //Demo入口
│ ├── KeyCenter //AppId/AppKey等信息
│ ├── keycenter //设置AppId/AppKey等信息
│ ├── QuickStart //快速开发模块
│ ├── TokenGenerate //Token生成及入会
│ ├── VideoCall //快速实现音视频通话
│ ├── VoiceChat //快速实现语聊房
│ ├── build.gradle
│ └── settings.gradle
步骤二:配置示例项目
使用 Android Studio 打开
Android/ARTCExample
文件夹。配置项目的AppID和AppKey:进入
Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java
文件将从控制台获取的AppID和AppKey填入
// ARTCTokenHelper.java
// 实时音视频AppID
private static String AppId = "<实时音视频AppID>";
// 实时音视频AppKey
private static String AppKey = "<实时音视频AppKey>";
步骤三:编译并运行示例项目
开启 Android 测试设备开发者选项,并将设备连接电脑,在 Android Studio 中选中您的开发设备:
在 Android Studio 中,点击 Sync Project with Gradle Files进行 Gradle 同步。
同步成功后点击Run 'app'进行编译,编译成功后即可在您的设备中安装ARTCExample应用。
在真机上运行Demo,点击实现音视频通话。 | 两设备加入同一频道。 | 开始实时音视频通话。 |