快速跑通 Sample Code
更新时间: 2024/09/18 16:26:13
本文介绍如何运行网易云信音视频通话适配鸿蒙应用的 Sample Code,方便您体验音视频相关功能,包括音频通话、视频通话以及进阶功能。
开发环境
由于鸿蒙系统版本迭代较快,且 API 的编译环境和运行环境比较依赖 IDE 版本和鸿蒙系统版本。因此,在开始运行示例项目之前,请确保开发环境满足以下要求:
环境要求 | 说明 |
---|---|
IDE | DevEco Studio 5.0.3.200 及以上版本。 |
Harmony API 版本 | Level 为 12 或以上版本。 |
Harmony SDK 版本 | HarmonyOS-NEXT-DP2 或以上版本。 |
Hvigor 及依赖库 | 示例项目源码中使用的 Hvigor 版本为 4.0.2。 |
Harmony 设备 | Harmony 系统 3.0.0.18 及以上版本的真机。 |
准备工作
请确认您已完成以下操作:
-
下载 NERTC 示例项目源码 仓库至您本地工程。
示例项目需要在 RTC 调试模式 下使用,此时无需传入 Token。修改鉴权方式的方法请参考 Token 鉴权。调试模式建议只在集成开发阶段使用,请在应用正式上线前改回安全模式。
Demo 调试
本地工程目录请使用英文路径,不要包含中文字符。
-
使用 DevEco studio 打开示例项目源码仓库。
-
打开
Entry/src/main/ets/common/Config.ets
文件,修改文件中存储您的账号 App Key,替换为您在准备工作阶段获取的 App Key,如下所示:TypeScript
export namespace Config{ export const APPKEY: string ="xxxxx" } 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 设备上单击允许应用获取相应权限。
跑通后的界面类似如下图所示,单击需要体验的功能。
常见问题
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 调试,或者连接手机时,在弹出的授予调试权限对话框中,没有授予权限。