Android

本文档将介绍如何快速跑通 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 StudioAGP兼容性

  • 测试设备:Android 5.0(SDK API Level 21)及以上版本的测试设备。

    说明

    推荐使用真机测试,模拟机可能存在功能缺失。

  • 网络环境:需要稳定的网络连接。

  • 应用准备:获取实时音视频应用的AppIDAppKey,详情请参见创建应用

操作步骤

步骤一:获取示例项目

克隆 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

步骤二:配置示例项目

  1. 使用 Android Studio 打开Android/ARTCExample文件夹。

  2. 配置项目的AppIDAppKey:进入Android/ARTCExample/KeyCenter/src/main/java/com/aliyun/artc/api/keycenter/ARTCTokenHelper.java文件将从控制台获取的AppIDAppKey填入

// ARTCTokenHelper.java
// 实时音视频AppID
private static String AppId = "<实时音视频AppID>";
// 实时音视频AppKey
private static String AppKey = "<实时音视频AppKey>";

image

步骤三:编译并运行示例项目

开启 Android 测试设备开发者选项,并将设备连接电脑,在 Android Studio 中选中您的开发设备:

image

  1. 在 Android Studio 中,点击 Sync Project with Gradle Files进行 Gradle 同步。

  2. 同步成功后点击Run 'app'进行编译,编译成功后即可在您的设备中安装ARTCExample应用。

在真机上运行Demo,点击实现音视频通话

image

两设备加入同一频道。

image

开始实时音视频通话。

image