本文介绍如何初始化 HarmonyOS NEXT 拉流 SDK。视频直播 SDK 只需要初始化一次。

前提条件 #

• 已完成集成准备。
• 已获取 App ID 等基础信息。详见获取 SDK License。

配置 SDK #

调用 VeLivePlayerEnv.init 配置 SDK。

VeLivePlayerEnv.init(new VeLivePlayerEnvConfig(this.context)
  .setAppID('填写申请的 AppID')
  .setAppName('填写申请的应用名称')
  .setAppVersion(BuildProfile.VERSION_NAME) // 填写合法的版本号, 合法版本号应大于、等于 2 个分隔符，如："1.3.2"
  .setAppChannel('渠道名称')
  .setAppRegion(VeLivePlayerEnvConstant.AppRegion.CHINA)
  .setLicenseUri($r('app.media.license'))
  .setLicenseLog(true)
  .setLicenseCallback((err: Nullable<BusinessError>, ret: boolean) => {
    if (ret == false || err != undefined) {
      Logger.e(this, "license check failed " + ( err?.message || '') + (err?.code || 0));
    } else {
      Logger.i(this, "license check success");
    }
  })
  .setInitAppLog(true) // 是否初始化埋点上报
  .setAutoStartAppLog(false) // 是否开启埋点上报
  .setAppLogReadyCallback((err: Nullable<BusinessError>, ret: Record<string, Object>) => {
    if (err === undefined) {
      Logger.i(this, "applog init success" + ret);
    } else {
      Logger.e(this, "applog init failed" + err.message);
    }
  })
)
// 如果初始化时配置了 setAutoStartAppLog(false) ，请在合适的时机开启 AppLog，例如：进入首页后，或者开始使用播放器之前。
VeLivePlayerEnv.startAppLog()

SDK 配置参数说明如下表所示。

埋点上报 #

为便于线上问题排查和质量数据分析，埋点上报功能默认开启。如有特殊的数据保密要求，您可以在配置 SDK 时，设置 VeLivePlayerEnv.setInitAppLog(false)，关闭埋点上报。