直播推流SDK/短视频SDK/播放器SDK/美颜特效SDK License常见问题 - 视频点播

Web端播放器License报错

问题现象：使用Web端播放器时，出现License报错。

解决方法：Web播放器SDK2.28.0及之后版本的集成使用需要接入License服务，且新购License订单不兼容旧版Web播放器SDK。为了不影响您的使用请接入2.29.1及以上版本，如果您尚未购买Web播放器SDK License，请通过MediaBox音视频SDK新购License订单，购买后重新进行License绑定。

移动端播放器License报错

问题现象：使用7.0.0及之后版本的移动端播放器时，出现如下类似“License verify premium func:abr”报错。

[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [ResolverManager] :httpdns get ip info timed out
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *|* li_fri * success *|
[7.0.0_43566760] [licenseManager] :license verify premium sdk result is 6, errMsg: Can not found the business data
[7.0.0_43566760] [licenseManager] :
                |--------------------------------- Premium license is invalid!!! ----------------------------------|
                |---------------------- Please provide correct license key before play, -------------------------|
                | you can visit 'https://www.alibabacloud.com/help/zh/apsara-video-sdk/user-guide/license/' for more info.|
[7.0.0_43566760] [] :check premium failed
[7.0.0_43566760] [] :check premium function: ABR

解决方法：移动端播放器SDK7.0.0及之后版本对播放器功能进行了划分，如需要使用高级ABR策略等专业版功能，请购买专业版License并绑定，详情请参见获取播放器SDK License。

如何查看License过期时间并续费

一：查看License有效日期

登录视频点播控制台或视频直播控制台控制台。
在左侧导航栏选择SDK管理 > 我的授权。
选择License管理标签页，找到对应应用下绑定的License订单，并在有效日期栏查看License过期时间。如需续费，单击对应应用操作列的续期按钮。

二：License续期

License续期的详细信息请参见License续期。

重要

如果您收到短信通知的License过期时间与控制台有效日期不符，是由于历史原因后台曾手动延长了有效期。请以控制台有效日期为准，忽略费用与成本中资源续订里的到期提示，并建议关闭自动续订功能。
如果您的历史License订单为多个SDK功能组合套餐，续期时需要对整体License订单进行续期，无法单独进行续费。续期有两种方式：
1. 如果License订单存在实例ID，则可以点击操作栏的续期按钮进行续期。
2. 如果License订单实例ID为空，则无法通过续期按钮进行续期。您需要通过MediaBox音视频SDK新购License订单，购买后重新进行License绑定。

License报错时，如何进行自主排查

当您接入License失败或报错时，可参考如下方法进行自主排查：

检查视频点播或视频直播控制台上创建的License授权配置是否正确
1. 登录视频点播控制台或视频直播控制台控制台。
2. 在左侧导航栏选择SDK管理 > 我的授权。
3. 点击应用管理标签页找到目标应用，单击详情，展示应用基础信息和已绑定License。
4. 检查如下信息是否正确。
  - 应用基础信息：应用标识符（Package Name等）、包签名（建议不绑定包签名）
  - 已绑定License信息：SDK版本、授权类型、有效日期、状态和增值服务
检查接入到项目中的License配置是否正确，与控制台上创建的License信息是否一致
- Web：主要检查初始化播放器时的license字段配置
  - domain：您播放器所在页面的域名是否与申请License时填写的域名一致，或者是填写域名的子域名。
  - key：License Key的值是否与您控制台上展示的一致。
- Android：主要检查AndroidManifest.xml配置
  - LicenseKey：com.aliyun.alivc_license.licensekey的值是否与您控制台上展示的一致。
  - 证书文件：com.aliyun.alivc_license.licensefile的值是否与您证书文件存放的路径一致。
  - 包ID：build.gradle的applicationId是否与您控制台上的Package Name一致。
  - 包签名：如果您在控制台上创建License时已绑定了签名，则需确保项目中配置的签名与控制台上绑定的签名一致。您可以通过如下命令查询您的包签名：keytool -v -list -keystore your.keystore。
- iOS：主要检查Info.plist配置
  - BundleId：CFBundleIdentifier的值是否与您控制台配置的Bundle ID一致。
  - LicenseKey：AlivcLicenseKey的值是否与您控制台上展示的一致。
  - 证书文件：AlivcLicenseFile的值是否与您ipa包内的证书文件路径一致。
- HarmonyOS：主要检查module.json5配置
  - BundleId：app.json5的bundleName是否与您控制台配置的鸿蒙BundleID一致。
  - LicenseKey：com.aliyun.alivc_license.licensekey的值是否与您控制台上展示的一致。
  - 证书文件：com.aliyun.alivc_license.licensefile的值是否与您hap包内的证书文件路径一致。

新购买License并授权后是否需要更新License文件及Key

License文件：推荐更新，续期后License文件的有效期会更新，因此集成更新后的License文件可以提高鉴权成功率；线上已发布App集成了历史License文件一般不影响使用。
License Key：保持不变，License Key与UID一一对应。

如何修改应用ID

如果您的应用信息发生变化，可以在控制台上修改应用信息。

重要

修改应用的标识符（Package Name等）将导致原有标识符对应的应用鉴权失败，需要重新下载License文件证书进行替换，请谨慎操作。

登录视频点播控制台或视频直播控制台控制台。
在左侧导航栏选择SDK管理SDK管理 > 我的授权。
点击应用管理标签页找到目标应用，确认无误后单击编辑。
您可以修改应用名称、平台、Android应用签名MD5值及应用标识符（Package Name等）信息。
确认无误后单击修改，完成License修改。

Android端应用修改签名MD5

集成方需谨慎修改签名MD5，避免线上故障。集成方App使用MediaBox音视频SDK需要配置License文件和Key，如果修改授权配置（例如签名MD5），可能会造成已发布App版本搭载的SDK校验授权不通过，导致功能异常。常见情况如下：

将Android端应用的签名MD5由A修改为B，会造成配置了“签名MD5=A”的App功能异常。此时，推荐单独创建一款应用，采用相同包名+“签名MD5=B”，用于新版本使用。
取消选中绑定签名项目，会造成低版本的SDK无法通过授权校验。如果集成方App曾经使用以下SDK版本，则不建议取消绑定签名：
- MediaBox音视频SDK：v1.6.0及以下版本
- 播放器SDK：v5.5.1.0及以下版本
- 推流SDK：v4.4.8及以下版本
- 短视频SDK：v3.35.0及其以下版本

如何修改授权模块、版本及功能点

目前控制台暂不支持变配，如果您有新增SDK模块、修改原有SDK模块版本或功能点的需求，请提交工单。