License相关常见问题

通过阅读本文,您可以了解申请、续费、使用或修改License绑定应用信息等过程中的常见问题及解决方案。

Web端播放器License报错

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

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

移动端播放器License报错

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

image

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

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

一:查看License有效日期

  1. 登录视频直播视频点播控制台。

  2. 在左侧导航栏选择SDK管理 > 我的授权

  3. 选择License管理标签页,找到对应应用下绑定的License订单,并在有效日期栏查看License过期时间。image

:License续期

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

重要
  1. 如果您收到短信通知的License过期时间与控制台有效日期不符,是由于历史原因后台曾手动延长了有效期。请以控制台有效日期为准,忽略费用与成本中资源续订里的到期提示,并建议关闭自动续订功能。

  2. 如果您的历史License订单为多个SDK功能组合套餐,续期时需要对整体License订单进行续期,无法单独进行续费。续期有两种方式:

    1. 如果License订单存在实例ID,则可以点击操作栏的续期按钮进行续期。image

    2. 如果License订单实例ID为空,则无法通过续期按钮进行续期。您需要通过音视频终端SDK购买页新购License订单,购买后重新进行License绑定

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

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

  • 检查视频点播或视频直播控制台上创建的License授权配置是否正确

    1. 登录视频直播视频点播控制台。

    2. 在左侧导航栏选择SDK管理 > 我的授权

    3. 点击应用管理标签页找到目标应用,单击详情,展示应用基础信息和已绑定License。

    4. 检查如下信息是否正确。

      • 应用基础信息:应用标识符(Package Name等)、包签名(建议不绑定包签名)

      • 已绑定License信息:SDK版本、授权类型、有效日期、状态和增值服务

      image

  • 检查接入到项目中的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.gradleapplicationId是否与您控制台上的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.json5bundleName是否与您控制台配置的鸿蒙BundleID一致。

      • LicenseKey:com.aliyun.alivc_license.licensekey的值是否与您控制台上展示的一致。

      • 证书文件:com.aliyun.alivc_license.licensefile的值是否与您hap包内的证书文件路径一致。

如何申请赠送SDK License

如果您在一个月内消费或者购买指定订阅包达到一定金额,获赠了相应License授权,需要在已有License授权使用过期之前,将获赠的License授权进行License绑定播放器SDK赠送请访问播放器SDK买赠申请,其他功能可提交宜搭表单申请。

模块

版本

适用产品

赠送标准

播放器SDK

标准版/专业版

不包含任何增值功能点

  • 视频直播

  • 视频点播

  • 智能媒体服务

详情请参见获取播放器SDK License

直播推流SDK

标准版/互动版

视频直播

免费赠送,下单地址音视频终端SDK购买页

短视频SDK

基础版

  • 视频点播

  • 智能媒体服务

任意资源包订单≥1800

短视频SDK

标准版

  • 视频点播

  • 智能媒体服务

任意资源包订单≥30000

美颜特效SDK

基础版

  • 视频直播

  • 视频点播

任意资源包订单≥99

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

  • License文件:推荐更新,续期后License文件的有效期会更新,因此集成更新后的License文件可以提高鉴权成功率;线上已发布App集成了历史License文件一般不影响使用。

  • License Key:保持不变,License KeyUID一一对应。

如何修改应用ID

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

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

  1. 登录视频直播视频点播控制台。

  2. 在左侧导航栏选择SDK管理 > 我的授权

  3. 点击应用管理标签页找到目标应用,确认无误后单击编辑

  4. 您可以修改应用名称、平台、Android应用签名MD5值及应用标识符(Package Name等)信息。

  5. 确认无误后单击更改,完成License修改。

Android端应用修改签名MD5

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

  • Android端应用的签名MD5A修改为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模块版本或功能点的需求,请提交工单

报错“无权限执行该操作”或“您没有权限操作此页面”

使用RAM用户登录控制台时,需要对控制台指引,否则会产生以下报错:

  • 未授予任何权限,在访问视频直播视频点播控制台时会产生如下错误:image.png

  • 未授予在费用中心(BSS)查看订单、支付订单及取消订单的权限,会产生如下报错:image.png