集成 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 集成(推荐)

  1. (可选)创建新项目。

    您可以参考此步骤创建新项目,若是需要集成到已有的项目中,请忽略该步骤。
    1. 在 DevEco Studio 里,在顶部菜单依次选择 File > New > Create Project 新建工程,再依次选择 Application > Empty Activity,单击 Next
    2. 创建 Harmony 项目 成功后,DevEco Studio 会自动开始同步 hvigor, 您需要等同步成功后再进行下一步操作。
  2. 在工程目录下的 entry 目录,执行 Ohpm 命令

    进入项目根目录,进入 entry 目录下,执行以下命令。

    ohpm install @nertc/nertc_sdk
    
  3. 打开 DevEco studio。DevEco studio 会自动同步(sync)。

手动集成

  1. (可选)创建新项目。

    您可以参考此步骤创建新项目,若是需要集成到已有的项目中,请忽略该步骤。
    1. 在 DevEco Studio 里,在顶部菜单依次选择 File > New > Create Project 新建工程,再依次选择 Application > Empty Activity,单击 Next
    2. 创建 Harmony 项目 成功后,DevEco Studio 会自动开始同步 hvigor, 您需要等同步成功后再进行下一步操作。
  2. 前往 SDK 下载页面 获取当前最新版本 SDK,或 提交工单 联系网易云信技术支持工程师获取对应版本的 SDK。

  3. 解压后将对应的文件拷贝至项目路径中。

    文件/文件夹 项目路径
    nertc_sdk.har /entry/src/main/libs

    image.png

    若无对应文件夹,您需要在对应路径下新建文件夹。

  4. 打开 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 需要的其他设备权限

下一步

参考教程 实现音视频通话

此文档是否对你有帮助?
有帮助
去反馈
  • 开发环境
  • 集成 SDK
  • Ohpm 集成(推荐)
  • 手动集成
  • 添加权限
  • 下一步