环境准备
DevEco Studio 5.0.3.900 及以上版本。
HarmonyOS SDK API Version 17 及以上版本。
已通过授权的华为开发者账号。可在 华为开发者联盟 注册账号。
SDK 下载
腾讯云视立方 HarmonyOS 播放器 SDK 下载地址是 Player HarmonyOS。
腾讯云视立方 HarmonyOS 播放器 Demo 下载地址是 Player HarmonyOS Demo。
快速集成
HAR 包集成
当前仅支持通过 HAR 包本地集成。
1. 放置文件:将下载的 .har 文件,如:LiteAVSDK_Professional_OHOS_x.x.x.x.har("x.x.x.x"对应具体的版本信息),放入项目的 entry/libs/ 目录。
2. 配置依赖:在 oh-package.json5文件中添加依赖声明,如下所示。然后单击 Sync 同步配置。
"dependencies": {"liteavsdk": "file:libs/LiteAVSDK_Professional_OHOS_x.x.x.x.har"}
3. 声明所需权限
在 entry 的 module.json5 的 module 模块中,声明所需权限:
"requestPermissions":[{"name" : "ohos.permission.INTERNET","reason": "$string:internet_reason","usedScene": {"abilities": ["FormAbility"],"when":"always"}},{"name" : "ohos.permission.GET_NETWORK_INFO","reason": "$string:network_info_reason","usedScene": {"abilities": ["FormAbility"],"when":"always"}}]
集成播放器 License


如果没有集成 License,播放过程中可能会出现异常。
import { getV2TXLivePremierShareInstance, V2TXLivePremierObserver } from 'liteavsdk';private observer: V2TXLivePremierObserver = {onLicenceLoaded: (result: number, msg: string) => {if (result === 0) {hilog.info(0x0000, TAG, 'License 加载成功: %{public}s', msg);} else {// License 加载失败,需要重试,检查错误原因hilog.error(0x0000, TAG, 'License 加载失败, code: %{public}d, msg: %{public}s', result, msg);}}}// 建议在 App 启动后,使用播放业务之前配置 LicenseaboutToAppear(): void {getV2TXLivePremierShareInstance(getContext()).setObserver(this.observer)// 参数为产品 License 对应的 licenceURL 和 licenceKey,正式版 License 需购买。getV2TXLivePremierShareInstance(context).setLicence("<licenceURL>", "<licenceKey>");}