集成 SDK

本文介绍如何集成 ZIM Audio SDK。

前提条件

在集成 ZIM Audio SDK 前，请确保：

已注册华为开发者账号并完成实名认证。
获取 DevEco Studio 5.0.0 Release 或以上版本。
获取配套 API Version 12 Release 的 HarmonyOS 5.0.0 Release SDK 或以上版本。
获取配套 API Version 12 Release 的 HarmonyOS 5.0.0 Release 操作系统或以上版本的鸿蒙设备真机或模拟器。
- 如需使用真机，请参考鸿蒙官网文档使用本地真机运行应用/元服务。

集成 SDK

（可选）新建项目

此步骤以如何创建新项目为例，如果是集成到已有项目，可忽略此步。

创建项目

打开 DevEco Studio，选择 “File > New > Create Project” 菜单，新建工程。

选择项目模板

选择项目模版为 “Empty Ability”。

填写信息

填写您项目名称、设备类型等信息。

信息填写完步后，单击 "Finish"，完成工程创建。

导入 SDK

获取 SDK

请在下载获取 ZIM SDK 压缩包。

解压 SDK

解压 SDK 至 “entry/libs” 项目目录下。

说明

如果您的项目中没有 libs 目录，手动新建一个即可。

添加 SDK 引用

打开 entry/oh-package.json5 文件，在 dependencies 节点中引入 “libs” 下的 ZIMAudio.har。

entry/oh-package.json5

{
    "dependencies": {
// !mark
        "zego_zim_audio": "file:./libs/ZIMAudio.har"
    }
}

entry/oh-package.json5

{
    "dependencies": {
// !mark
        "zego_zim_audio": "file:./libs/ZIMAudio.har"
    }
}

添加麦克风权限

进入 “entry/src/main” 目录，打开 “module.json5” 文件，在 “module” 节点中引入 requestPermissions，添加麦克风权限。

entry/src/main/module.json5

{
    "requestPermissions": [
// !mark(1:9)
      {
        "name": "ohos.permission.MICROPHONE",  // 麦克风权限
        "reason": "$string:app_name",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        }
      }
    ]
}

entry/src/main/module.json5

{
    "requestPermissions": [
// !mark(1:9)
      {
        "name": "ohos.permission.MICROPHONE",  // 麦克风权限
        "reason": "$string:app_name",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        }
      }
    ]
}

在合适的时机，向用户申请麦克风权限。

try{
    const atManager = abilityAccessCtrl.createAtManager()
// !mark(1:5)
    atManager.requestPermissionsFromUser(getContext(this), ['ohos.permission.MICROPHONE']).then((res)=>{
        atManager.requestPermissionOnSetting(getContext(this),['ohos.permission.MICROPHONE']);
        const flag = res.authResults.every(item => item === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)
        promptAction.showToast({ message: flag ? '已授权' : '已禁用' })
    });
} catch (e) {
      console.log(e)
}

try{
    const atManager = abilityAccessCtrl.createAtManager()
// !mark(1:5)
    atManager.requestPermissionsFromUser(getContext(this), ['ohos.permission.MICROPHONE']).then((res)=>{
        atManager.requestPermissionOnSetting(getContext(this),['ohos.permission.MICROPHONE']);
        const flag = res.authResults.every(item => item === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)
        promptAction.showToast({ message: flag ? '已授权' : '已禁用' })
    });
} catch (e) {
      console.log(e)
}