跳到主要内容

导入 CallKit SDK

融云支持使用 DevEco Studio 中自动导入和手动导入两种方式，将 CallKit SDK 导入到您的应用工程中。

环境要求​

  • DevEco Studio NEXT Release(5.0.3.900) 及以上。
  • HarmonyOS SDK API 12 及以上。
  • 手机系统版本号：NEXT.0.0.31

自动导入 SDK​

CallKit 1.6.0 版本开始支持 OpenHarmony三方库中心 获取 SDK

  1. 在当前项目目录（示例 entry）中的 oh-package.json5 中添加 SDK 依赖，然后点击 "Sync Now"。
JSON
// entry 目录中的 oh-package.json5
{
  "name": "entry",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {
    "@rongcloud/callkit" : "x.y.z"
  }
}

注意

  • CallKit SDK 内部依赖 IM 以及 RTC 相关 SDK ，同步后会自动导入 @rongcloud/calllib & @rongcloud/imlib & @rongcloud/imkit
  • 各个 SDK 的最新版本号可能不相同，具体 x.y.z 值可前往 融云官网 SDK 下载页面 或 OpenHarmony三方库中心 查询。

  1. 安装 SDK 成功后，您可以在项目根目录的 oh_modules/.ohpm/ 中找到融云 CallKit SDK。

  2. 查看更多其他融云 SDK。 打开 OpenHarmony三方库中心 ，搜索关键字 rongcloud

手动导入 SDK​

  1. 在导入 SDK 前，您需要前往融云官网 SDK 下载页面，将音视频通话（包含 UI）SDK 下载到本地。
  2. 创建 ./libs 文件夹，将所需 SDK har 包 放入其中。

执行命令行​

  1. 在工程根路径下执行以下命令行：
shell
ohpm install entry/libs/CallKit.har
  1. 执行完后，Studio 根据工程路径在 oh-package.json5 自动添加依赖。

entry 配置文件依赖 SDK​

也可以在 entry 同级目录的 oh-package.json5 手动配置 SDK 依赖。

JSON
// entry 同级目录下的 oh-package.json5 需要手动配置
{
  "name": "testDemo",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {
    "@rongcloud/": "file:./libs/CallKit.har"  // 该配置手动依赖
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.16",
    "@ohos/hamock": "1.0.0"
  }
}

同步项目​

在 entry/oh-package.json5 中点击 Sync Now 同步工程，同步成功之后即可正常使用 CallKit SDK。

提示

如果您同步之后依然无法导入 SDK，这可能是 DevEco Studio 的编译缓存导致的问题。您可以尝试把 DevEco Studio 完全关闭之后重新打开项目工程来解决问题。

添加 SDK 依赖权限​

SDK 需要权限如下：

权限名称权限说明使用目的
ohos.permission.GET_NETWORK_INFO获取网络信息网络变化之后获取网络信息，进行 IM 重连
ohos.permission.INTERNET使用网络连接 IM 、收发消息需要网络连接
ohos.permission.STORE_PERSISTENT_DATA数据存储消息数据库需要本地存储
ohos.permission.MICROPHONE麦克风权限音频通话需要麦克风采集能力
ohos.permission.CAMERA摄像头权限视频通话需要摄像头采集能力
ohos.permission.KEEP_BACKGROUND_RUNNING后台任务后台保活用于音视频通话
ohos.permission.VIBRATE响铃来电提醒
ohos.permission.RUNNING_LOCK熄屏音频通话时附耳熄屏

具体权限配置参考鸿蒙的应用权限管控文档。

最后于 更新