集成 SDK
更新时间: 2025/06/11 16:45:39
本文介绍了在 Harmony 工程中集成网易云信 NERTC SDK 的集成步骤,属于实现实时音视频通话功能的准备工作。
开发环境
在开始配置工程之前,请您准备以下开发环境:
- 华为 DevEco Studio 5.0.3.900 或以上版本。
- Harmony SDK API 等级 12 或以上。
- Harmony 系统 5.0.0.102 或以上版本的移动设备。
- Hvigor 5.8.5 以及以上版本。
集成 SDK
Ohpm 集成(推荐)
-
(可选)创建新项目。
您可以参考此步骤创建新项目,若是需要集成到已有的项目中,请忽略该步骤。
- 在 DevEco Studio 里,在顶部菜单依次选择 File > New > Create Project 新建工程,再依次选择 Application > Empty Activity,单击 Next。
- 创建 Harmony 项目 成功后,DevEco Studio 会自动开始同步 hvigor, 您需要等同步成功后再进行下一步操作。
-
在工程目录下的 entry 目录,执行 Ohpm 命令
进入项目根目录,进入 entry 目录下,执行以下命令。
ohpm install @nertc/nertc_sdk
-
打开 DevEco studio。DevEco studio 会自动同步(sync)。
手动集成
-
(可选)创建新项目。
您可以参考此步骤创建新项目,若是需要集成到已有的项目中,请忽略该步骤。
- 在 DevEco Studio 里,在顶部菜单依次选择 File > New > Create Project 新建工程,再依次选择 Application > Empty Activity,单击 Next。
- 创建 Harmony 项目 成功后,DevEco Studio 会自动开始同步 hvigor, 您需要等同步成功后再进行下一步操作。
-
解压后将对应的文件拷贝至项目路径中。
文件/文件夹 项目路径 nertc_sdk.har /entry/src/main/libs 若无对应文件夹,您需要在对应路径下新建文件夹。
-
打开 DevEco studio 在 entry/oh-package.json5 文件中设置 dependencies 路径。
json
"dependencies": { '@nertc/nertc_sdk': "file:./src/main/libs/nertc_sdk.har" }
之后可以在工程文件中调用 SDK 中的相关函数。
添加权限
打开 entry/src/main/module.json5
文件,添加必要的设备权限。
权限说明如下表所示:
必要性 | 获取的权限 | 使用目的 |
---|---|---|
必要权限 | 访问网络权限(INTERNET) | SDK 基本功能都需要在联网的情况下才可以使用 |
网络连接状态(GET_NETWORK_INFO) | 获取网络的类型、拥有的能力等 | |
麦克风(MICROPHONE) | 音视频通话时,用于采集声音 | |
照相机(CAMERA) | 音视频通话时,用于采集视频 |
配置文件示例:
json5"requestPermissions": [
{
"name": "ohos.permission.CAMERA",
"usedScene": {
"abilities": [
"FormAbility"
],
"when":"always"
}
},
{
"name": "ohos.permission.MICROPHONE",
"usedScene": {
"abilities": [
"FormAbility"
],
"when":"always"
}
}
{
"name": "ohos.permission.GET_NETWORK_INFO",
"usedScene": {
"abilities": [
"FormAbility"
],
"when":"always"
}
},
{
"name": "ohos.permission.INTERNET",
"usedScene": {
"abilities": [
"FormAbility"
],
"when":"always"
}
}
]
......//App 需要的其他设备权限
下一步
参考教程 实现音视频通话。
此文档是否对你有帮助?