本章节为您介绍初始化方法,请参考文档提供的示例进行初始化配置。视频直播 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 配置参数说明如下表所示。
参数 | 类型 | 说明 |
---|---|---|
AppId | String | App ID,必填,从控制台应用管理获取。 |
AppName | String | 必填, App 英文名,从控制台应用管理获取。 |
AppVersion | String | 必填,App 版本号,使用 BuildProfile.VERSION_NAME,合法版本号应包含大于、等于 2 个分隔符,如:"1.3.2" |
AppChannel | String | 必填,渠道号;业务自定义,如:华为应用市场 (huawei) 等。 |
LicenseUri | String | Resource | 必填,License 路径。 |
线上问题的排查和质量平台的数据展示都依赖 SDK 上报的日志,因此,日志上报功能默认开启。如有特殊的数据保密要求,您可以在配置 SDK 时,设置 VeLivePlayerEnv.setInitAppLog(false)
,关闭日志上报。