快速跑通 Sample Code
更新时间: 2025/06/11 16:45:39
本文介绍如何运行网易云信音视频通话适配鸿蒙应用的 Sample Code,方便您体验音视频相关功能,包括音频通话、视频通话以及进阶功能。
开发环境
在开始运行示例项目之前,请确保开发环境满足以下要求:
| 环境要求 | 说明 |
|---|---|
| IDE | DevEco Studio 5.0.3.900 及以上版本。 |
| Harmony API 版本 | Level 为 12 或以上版本。 |
| Harmony SDK 版本 | HarmonyOS 5.0.0 Release 或以上版本。 |
| Hvigor 及依赖库 | 示例项目源码中使用的 Hvigor 版本为 5.8.5。 |
| Harmony 设备 | Harmony 系统 5.0.0.102 及以上版本的真机。 |
准备工作
请确认您已完成以下操作:
-
下载 NERTC 示例项目源码 仓库至您本地工程。
示例项目需要在 RTC 调试模式 下使用,此时无需传入 Token。修改鉴权方式的方法请参考 Token 鉴权。调试模式建议只在集成开发阶段使用,请在应用正式上线前改回安全模式。
Demo 调试
本地工程目录请使用英文路径,不要包含中文字符。
-
使用 DevEco studio 打开示例项目源码仓库。
-
打开
entry/src/main/ets/common/Config.ets文件,修改文件中存储您的账号 App Key,替换为您在准备工作阶段获取的 App Key,如下所示:TypeScriptexport namespace Config{ export const APP_KEY: string = "请填入业务方自己申请的 RTC APP_KEY" export const APP_KEY_DEBUG: string = "请填入业务方自己申请的 RTC APP_KEY" } export default Config
AppKey 前后需要加英文双引号。
-
打开 RTC DEMO 配置签名,路径为 File > Project Structure。进入 Project Structure 页面后,在 Project > Signing Configs 路径下,勾选 Automatically generate signature。
-
运行 Demo。
-
开启设备的 开发者模式 和 USB 调试 功能。将 Harmony 设备连接到开发电脑,在弹出的授予调试权限对话框中,授予调试权限,具体步骤请参考 在硬件设备上运行应用。
请确保 Harmony 设备已开启开发者模式、USB 调试,并允许通过 USB 安装应用。
-
单击 Run 按钮,编译并运行示例源码。
首次编译示例源码时,如果没有对应的依赖库或者构建工具,DevEco Studio 会自动下载示例源码,可能需要较长时间,请耐心等待。
-
-
体验音视频通话。
音视频通话需要获取麦克风等权限,请在 Harmony 设备上单击允许应用获取相应权限。
跑通后的界面类似如下图所示,详细教程请参考 Demo 使用教程
常见问题
1. 编译时提示 ENOENT: no such file or directory, open '/Users/minga/code/ohos_sample/dependencies/hvigor-4.0.2.tgz'。
可能原因
hvigor 文件不匹配。
问题解决
下载对应版本的 hvigor 货件,例如 hvigor-4.0.2.tgz hvigor-ohos-plugin-4.0.2.tgz rollup.tgz。
-
在 DevEco Studio 的菜单栏 中增加 dependencies 将上述文件拷贝到 dependencies 文件夹下。
-
在 hvigor-config.json5 中增加 hvigorVersion 和 dependencies 的描述,如下图。
2. 手机连接电脑后,DevEco Studio 中没有出现对应的手机。
如果 harmony 设备连接电脑后,Deveco Studio 的 Running Devices 中没有出现对应的手机,可能原因如下:
- 您的数据线不支持连接存储。
- Harmony 设备没有开启 开发者模式 和 USB 调试,或者连接手机时,在弹出的授予调试权限对话框中,没有授予权限。




