You need to enable JavaScript to run this app.
导航
HarmonyOS NEXT
最近更新时间:2024.12.04 18:05:17首次发布时间:2024.12.04 18:05:17

本章节为您介绍初始化方法,请参考文档提供的示例进行初始化配置。视频直播 SDK 只需要初始化一次。

前提条件

配置 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 配置参数说明如下表所示。

参数类型说明
AppIdStringApp ID,必填,从控制台应用管理获取。
AppNameString必填, App 英文名,从控制台应用管理获取。
AppVersionString必填,App 版本号,使用 BuildProfile.VERSION_NAME,合法版本号应包含大于、等于 2 个分隔符,如:"1.3.2"
AppChannelString必填,渠道号;业务自定义,如:华为应用市场 (huawei) 等。
LicenseUriString | Resource必填,License 路径。

日志上报

线上问题的排查和质量平台的数据展示都依赖 SDK 上报的日志,因此,日志上报功能默认开启。如有特殊的数据保密要求,您可以在配置 SDK 时,设置 VeLivePlayerEnv.setInitAppLog(false),关闭日志上报。