通过阅读本文,您可以了解申请、续费、使用或修改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”报错。
解决方法:移动端播放器SDK7.0.0及之后版本对播放器功能进行了划分,如需要使用高级ABR策略等专业版功能,请购买专业版License并绑定,详情请参见获取播放器SDK License。
如何查看License过期时间并续费
一:查看License有效日期
二:License续期
License续期的详细信息请参见License续期。
如果您收到短信通知的License过期时间与控制台有效日期不符,是由于历史原因后台曾手动延长了有效期。请以控制台有效日期为准,忽略费用与成本中资源续订里的到期提示,并建议关闭自动续订功能。
如果您的历史License订单为多个SDK功能组合套餐,续期时需要对整体License订单进行续期,无法单独进行续费。续期有两种方式:
如果License订单存在实例ID,则可以点击操作栏的续期按钮进行续期。
如果License订单实例ID为空,则无法通过续期按钮进行续期。您需要通过音视频终端SDK购买页新购License订单,购买后重新进行License绑定。
License报错时,如何进行自主排查
当您接入License失败或报错时,可参考如下方法进行自主排查:
检查视频点播或视频直播控制台上创建的License授权配置是否正确
检查接入到项目中的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
包内的证书文件路径一致。
如何申请赠送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 Key与UID一一对应。
如何修改应用ID
如果您的应用信息发生变化,可以在控制台上修改应用信息。
修改应用的标识符(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模块版本或功能点的需求,请提交工单。
报错“无权限执行该操作”或“您没有权限操作此页面”
使用RAM用户登录控制台时,需要对控制台指引,否则会产生以下报错: