本文档将介绍如何快速跑通 ARTC 示例项目,体验实时音视频功能。
示例源码下载
阿里云提供了开源示例项目,用于演示 ARTC SDK 的 API 使用方法,帮助开发者更直观地理解和集成 SDK 的各项功能,Harmony示例项目仓库。
前提条件
在运行示例项目之前,请确保开发环境满足以下要求:
开发工具:DevEco Studio 5.0.3.900 Release 或以上版本;获取配套 API Version 12的 HarmonyOS NEXT SDK 或以上版本。
测试设备:获取配套 API Version 12的 HarmonyOS NEXT 5.0.0.102 操作系统或以上版本,支持音视频的鸿蒙设备,且已开启“允许调试”选项。
网络环境:需要稳定的网络连接。
应用准备:获取实时音视频应用的AppID和AppKey,详情请参见创建应用。
操作步骤
步骤一:获取示例项目
克隆 ARTC 示例项目到本地:
git clone https://github.com/MediaBox-Demos/amdemos-artc注意:该仓库包含 ARTC SDK 的多个 Native 平台的示例项目,其中 Harmony 平台示例项目位于Harmony/ARTCExample目录下。
示例项目中包含了在客户端生成 Token 的相关代码以帮助您进行测试。
下面将介绍Harmony/ARTCExample项目的文件结构。
├── Harmony // 鸿蒙平台工程结构跟目录
│ ├── ARTCExample // API Example工程目录
│ | ├── entry // Demo入口
│ | ├── Commmon // 实现通用功能
│ | ├── KeyCenter // AppId/AppKey等信息
│ | | ├── ARTCTokenHelper.ets // 设置AppId/AppKey等信息
│ | ├── QuickStart // 快速开始模块
│ | | ├── TokenGenerate.ets // Token生成及入会
│ | | ├── VideoCall.ets // 快速实现音视频通话
│ | | ├── VoiceChat.ets // 快速实现语聊房步骤二:配置示例项目
使用 DevEco Studio 打开
Harmony/ARTCExample文件夹。配置项目的AppID和AppKey:打开
Harmony/ARTCExample/entry/src/main/ets/pages/Index.ets文件将从控制台获取的AppID和AppKey填入。
// Index.ets // 实时音视频AppID @Local appId: string = "<实时音视频AppID>"; // 实时音视频AppKey @Local appKey: string = "<实时音视频AppKey>";
步骤三:编译并运行示例项目
连接鸿蒙开发设备,在 DevEco Studio 中选中您的开发设备,选择 entry 模块。

为项目设置自动签名。
依次点击
File -> Project Structure -> Signing Configs,在串口中点击Automatically generate signature。等待自动签名结束后,点击 OK 即可。如果之前没有登录,请点击界面提示的
Sign In使用您的华为账号登录。
在 DevEco Studio 中,点击 Run 进行编译运行,编译成功后即可在您的设备中安装
ARTCExample应用。