Harmony

本文档将介绍如何快速跑通 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 操作系统或以上版本,支持音视频的鸿蒙设备,且已开启“允许调试”选项。

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

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

操作步骤

步骤一:获取示例项目

克隆 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文件夹。

    • 配置项目的AppIDAppKey:打开Harmony/ARTCExample/entry/src/main/ets/pages/Index.ets文件将从控制台获取的AppIDAppKey填入。

    // Index.ets
    // 实时音视频AppID
    @Local appId: string = "<实时音视频AppID>";
    // 实时音视频AppKey
    @Local appKey: string = "<实时音视频AppKey>";

    image.png

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

  • 连接鸿蒙开发设备,在 DevEco Studio 中选中您的开发设备,选择 entry 模块。

image.png

  • 为项目设置自动签名。

    依次点击File -> Project Structure -> Signing Configs,在串口中点击 Automatically generate signature。等待自动签名结束后,点击 OK 即可。

    如果之前没有登录,请点击界面提示的Sign In使用您的华为账号登录。

    image.png

  • 在 DevEco Studio 中,点击 Run 进行编译运行,编译成功后即可在您的设备中安装ARTCExample应用。