示例源码运行指引

本文介绍如何快速跑通示例源码，体验基础的音视频通话服务。

准备环境

在开始集成 ZEGO Express SDK 前，请确保开发环境满足以下要求（以下说明皆以 Windows 开发电脑为例）：

• 已联系华为商务人员，签署合作计划，开通相关权限，获取 DevEco Studio 5.0.0 Release 或以上版本。
• 获取配套 API Version 12 Release 的 HarmonyOS 5.0.0 Release SDK 或以上版本。
• 获取配套 API Version 12 Release 的 HarmonyOS 5.0.0 Release 操作系统或以上版本，支持音视频的鸿蒙设备，且已开启“允许调试”选项。
• 鸿蒙设备、Windows 开发电脑已经连接到 Internet。

前提条件

已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理 中的“项目信息”。

运行示例源码

1. 在开发电脑中找到 DevEco Studio 软件图标。

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

   • 方式：登录 DevEco Studio 官网 下载并安装最新版本 DevEco Studio 及其相关的 SDK Tools。

2. 打开 DevEco Studio，单击 “Open Project”。

   

3. 在解压后的示例源码文件夹中，选择 ZegoExpressOHOSDemo 文件夹打开。

   

4. 下载 SDK，并放置到 “ZegoExpressOHOSExample\libs\” 目录下。

5. 找到 “ZegoExpressOHOSDemo\ZegoExpressOHOSExample\src\main\ets\pages\” 目录下的 “KeyCenter.ets” 文件，填写 SDK 初始化所需的 appID 和 appSign 等信息。

   请使用本文 前提条件 已获取的 AppID 和 AppSign 正确填写，否则示例源码无法正常运行。

   

6. 将鸿蒙设备连接到开发电脑，当该设备成功开启“开发者模式”和“USB 调试”功能后，可以看到 DevEco Studio 上方的 “Running Devices” 选项框由下图：

   

   变为下图：

   

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

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

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

   

体验实时音视频功能

在真机中运行项目，运行成功后，可以看到本端视频画面。

为方便体验，ZEGO 提供了一个 Web 端调试示例 ，在该页面下，输入相同的 AppID、RoomID，输入不同的 UserID、以及对应的 Token，即可加入同一房间与真机设备互通。当成功开始音视频通话时，可以听到远端的音频，看到远端的视频画面。

常见问题

1. DevEco Studio 运行下载的示例源码时有如下报错，该如何处理？

   

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