短视频SDK使用License进行授权,本文为您介绍短视频SDK License的获取方式以及使用方式。
License升级说明
短视频SDK从3.29.0版本开始,接入一体化License服务即音视频终端SDK License,音视频终端SDK License包含直播推流、短视频、播放器、美颜特性等SDK的授权。License与应用绑定,每一个License最多可以绑定一款Android应用和iOS应用。服务升级的同时,短视频SDK的集成方式也有所变化。详情如下:
短视频SDK版本 | 集成方式 |
新接入 | 使用3.29.0及以上版本的新用户,按照官网帮助文档集成最新版本使用。 |
SDK版本升级 | 如果您已接入低于3.29.0版本,在License有效期内,可以继续使用老版本SDK。如果您想升级到3.29.0及以后版本,集成时需要调用注册接口把LicenseKey和LicenseFile集成到SDK内。 |
License授权
步骤一:创建应用
进入点播控制台我的授权,选择应用管理标签页,点击创建应用。
编辑应用信息,应用按端类型分为Web端和移动端。
Web端:依次填入应用名称和对应的Web域名,完成应用创建。
Web域名填写注意事项
标准填写示例:aliyun.com。
重要当需要同时覆盖多个子域名时(例如pc.aliyun.com和mobile.aliyun.com),只需填写主域名“aliyun.com”即可。
错误填写示例(请勿填写以下形式):
包含协议头:http://aliyun.com或 https://aliyun.com。
包含路径或子页面:aliyun.com/index或aliyun.com/login。
使用泛域名:*.aliyun.com或.aliyun.com。
移动端:依次填入应用名称,并填入相对应的安卓包名、iOS BundleID及HarmonyOS BundleID,完成应用创建。
绑定Android应用签名
说明如果平台选择了Android,且勾选了绑定签名,则此项必填。
绑定签名后会提高安全性,可以避免License被同Package Name的应用盗用。
新版本SDK支持免绑定签名,包含:MediaBox音视频SDK v1.7.0及以上版本、播放器SDK v5.5.2及以上版本、直播推流SDK v4.4.9及以上版本、短视频SDK v3.36.0及以上版本。
获取Android应用签名MD5值,您可以通过以下两种方式:
通过命令获取:执行
keytool -v -list -keystore your.keystore
查看相应签名的MD5值。通过AndroidStudio获取:单击右侧侧边栏的Gradle,找到对应App的Tasks > android > signingReport获取。通过此方式获取到的MD5值,需要将字母转换为小写且去掉分号。
步骤二:购买License
如果您已购买License,请直接通过步骤三:绑定License完成License绑定。
返回我的授权页面,选择订单实例标签页,点击License购买。
进入音视频终端SDK购买页,根据业务需求选择SDK和对应的功能模块(SDK权益无法组合购买),确认无误后进行购买。
重要如图所示,SDK权益仅支持单独购买,例如可单独购买播放器SDK标准版。
支付成功后返回订单实例标签页,您可以看到新购买的订单实例。
步骤三:绑定License
返回我的授权页面,选择License管理标签页,点击License绑定。
进入License绑定页面,选择您需要绑定的应用和对应的SDK License订单,确认信息无误后,单击绑定。
说明每个License订单最多绑定一款应用,覆盖Web端或者移动端。
绑定成功后返回License管理标签页,您可以看到绑定成功的应用名称和对应的授权信息。
步骤四:获取授权信息
在License管理标签页,找到目标应用。
确认授权信息无误后,单击下载证书,将License证书文件下载到本地,并保存License Key,在后续接入应用时使用。配置License文件的步骤请参见接入License。
续费License
License过期判断
短视频SDK License有使用期限,以3.29.0版本为界,License过期的判断标准不同。详情如下:
3.29.0以前版本:
接口返回值为
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)
。日志显示以下任一信息:
30天无网络,License已禁用,请续期或重新获取授权。
License已禁用,请续期或重新获取授权。
License非法(包名和签名/BundleID没有在短视频SDK官网注册),超过7天试用,已经禁用。
3.29.0及以后版本:
接口返回值为
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)
。日志显示以下任一信息:
License已过期,请续期或重新获取授权。
License未初始化,请参考初始化SDK(Android)或初始化SDK(iOS)进行接入。
License非法(包名和签名/BundleID没有在短视频SDK官网注册),请重新获取授权。
使用增值服务:xxx已过期,请续期或重新获取授权。(其中xxx指的是具体的增值服务。)
使用增值服务:xxx非法,请获取相应增值服务的License授权后再使用。(其中xxx指的是具体的增值服务。)
License续费方式
方式一:License管理页面续费
进入点播控制台我的授权。
选择License管理标签页,找到对应应用下绑定的实例ID,点击操作栏的续期按钮。
重要如果实例ID为空或者续期时控制台出现报错,则需要通过方式二:新购License并绑定应用或阿里云技术工单进行续费。
续费针对License订单,如果您的License订单中包含多个SDK权益,续费将会对所有SDK进行整体续费,暂不支持变配。如有疑问,请提交阿里云技术工单咨询。
进入续费管理界面,点击操作栏的续费按钮。
进入音视频终端SDK续费页面。确认您的当前配置和购买时长无误后,点击立即购买完成续费(建议您勾选到期自动续费,以避免过期)。
方式二:新购License并绑定应用
如果您购买了SDK License且对应订单实例ID为空或者续期时控制台出现报错,需要在License授权过期之前在MediaBox音视频SDK下单购买,购买后进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。