集成SDK
开发环境准备
在开始集成 SDK 前,请确保开发环境满足以下要求:
- 已通过授权的华为开发者账号。可在华为开发者联盟注册账号。
- 华为 DevEco Studio 5.0.3.200 或以上版本
- HarmonyOS NEXT Developer Beta1 或以上版本的操作系统的真机或模拟器,且已开启“允许调试”选项。
- 已注册SDK开发者账号,并获取到AppID和AppSecret。
集成到已有项目
OHPM方式(推荐)
- 使用命令行窗口进入工程目录,执行以下命令安装 SDK。
cd entry
ohpm install @cloudroom/harmony_rtcsdk
手动方式
- 前往SDK下载页面,下载HarmonyOS SDK。
- 将har文件拷贝到工程目录
entry/libs文件夹下。 - 使用命令行窗口进入工程目录,执行以下命令安装 SDK。
cd entry
ohpm install ./libs/harmony_rtcsdk.har
添加权限
打开工程目录下entry/src/main/module.json5文件,添加必要的权限声明。
{
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
},
{
"name": "ohos.permission.MICROPHONE",
"usedScene": {
"abilities": [
"EntryAbility"
],
"when": "always"
},
"reason": "$string:permissionReason"
},
{
"name": "ohos.permission.CAMERA",
"usedScene": {
"abilities": [
"EntryAbility"
],
"when": "always"
},
"reason": "$string:permissionReason"
},
... //其他APP权限
]
}
在entry/src/main/resources/base/element/string.json中,添加变量
{
"string": [
{
"name": "permissionReason",
"value": "用于音视频通话"
}
]
}
开始使用
import { CRVideoSDKEx } from "@cloudroom/harmony_rtcsdk";
console.log(`SDK版本号: ${CRVideoSDKEx.getSDKVersion()}`) //输出版本号
const cacheDir = getContext().getApplicationContext().cacheDir; // SDK工作目录
let sdk_engine = CRVideoSDKEx.create(cacheDir, '{}'); //创建SDK实例
至此,集成工作已经完成,可以开始实现音视频通话了。