短视频SDK使用License进行授权,本文为您介绍短视频SDK License的获取方式以及使用方式。
License升级说明
短视频SDK从3.29.0版本开始,接入一体化License服务即音视频终端SDK License,音视频终端SDK License包含直播推流、短视频、播放器、美颜特性等SDK的授权。License与应用绑定,每一个License最多可以绑定一款应用(包含iOS和Android)。服务升级的同时,短视频SDK的集成方式也有所变化。详情如下:
短视频SDK版本 | 集成方式 |
新接入 | 使用3.29.0及以上版本的新用户,按照官网帮助文档集成最新版本使用。 |
SDK版本升级 | 如果您已接入低于3.29.0版本,在License有效期内,可以继续使用老版本SDK。如果您想升级到3.29.0及以后版本,集成时需要调用注册接口把LicenseKey和LicenseFile集成到SDK内。 重要 LicenseKey和LicenseFile可通过控制台进行授权申请。请通过视频点播控制台SDK管理 > 我的授权开通License授权。具体步骤,请参见我的授权。 |
获取License
短视频SDK由License进行授权控制,不同的License版本价格不一样,支持的功能也不一样。
不同版本的License所支持的功能差异请参见功能列表,短视频SDK各版本License的获取及说明请参见下表:
License与App的BundleId和PackageName强绑定,获取License授权时请确认App信息准确无误。
只要是在同一UID下的同一款App,License文件都是同一份,后申请的内容会包含之前申请的内容,可以使用不同的meta-data。
免费试用
短视频SDK提供免费试用功能,每个用户可以免费试用1个月短视频基础版。申请试用请参见短视频试用申请。短视频SDK试用需要进行License核销,操作指引管理License。
申请后您可以在我的试用中查看所有的试用权益。
购买正式版
T:当前日期(含当天)。
T-30:当前日期往前推30天(含T-30当天)。
统计周期为最近31天,滚动计算。
版本 | 获取方式 | 相关说明 |
基础版 |
| 通过方式一获取License时,每个订单可授权一个应用(包括iOS和Android)。 |
标准版 |
| 通过方式一获取License时,每个订单可授权一个应用(包括iOS和Android)。 |
专业版 |
|
|
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,完成应用创建。
其中,HarmonyOS BundleID 从工程中的
app.json5文件的bundleName字段获取。填写完成后,勾选合规承诺并单击创建。绑定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绑定。
短视频SDK标准版与专业版共用同一SDK包,通过License类型区分可用功能,购买专业版License并绑定应用后即可使用专业版功能。
返回我的授权页面,选择订单实例标签页,点击License购买。
进入音视频终端SDK购买页,根据业务需求选择SDK和对应的功能模块,确认无误后进行购买。
重要购买短视频SDK License请确保所选平台与应用端类型相匹配,端类型不符将导致License绑定失败。在音视频终端SDK购买页面,选择所需的SDK(如短视频),然后在平台行选择移动端,配置SDK版本(如移动端标准版、移动端专业版),确认应付费用后单击立即购买。
支付成功后返回订单实例标签页,您可以看到新购买的订单实例。
步骤三:绑定License
返回我的授权页面,选择License管理标签页,单击License绑定。
进入License绑定页面,选择您需要绑定的应用和对应的SDK License订单,确认信息无误后,单击绑定。
说明每个License订单最多绑定一款应用。
在授权平台中勾选需要授权的平台(如 Android)。移动端 License 仅能授权给移动端应用。
绑定成功后返回License管理标签页,您可以看到绑定成功的应用名称和对应的授权信息。
步骤四:获取授权信息
在License管理标签页,找到目标应用。在License管理页签中,页面顶部显示License Key,可单击旁边的复制按钮进行复制;应用列表中每个应用名称下方提供下载证书链接。
确认授权信息无误后,单击下载证书,将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实例,单击操作列的续订。
进入音视频终端SDK续费页面。确认您的当前配置和购买时长无误后,点击立即购买完成续费(建议您勾选到期自动续费,以避免过期)。
方式二:资源包买赠
如果您在一个月内消费或者购买指定订阅包达到一定金额,获赠了相应License授权。需要在已有License授权使用过期之前,将获赠的License授权进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。
SDK | 买赠金额 | 申请地址 |
播放器SDK | 买赠详情请参见获取播放器SDK License。 | |
短视频SDK | 买赠详情请参见获取短视频SDK License。 | 提交宜搭表单申请 |
直播推流SDK | 免费使用 | 无需申请 |
方式三:新购License并绑定应用
如果您购买了SDK License且对应订单实例ID为空或者续期时控制台出现报错,需要在License授权过期之前在音视频终端SDK购买页下单购买,购买后进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。
订单实例ID为空:License管理页面中对应订单的实例ID列显示为空。
续期时控制台报错:
续费页面底部显示红色错误提示订单配置参数不符合校验条件,请重新选配商品!,导致无法通过立即购买完成续费。遇到此报错时,请通过方式三:新购 License 并绑定应用或提交阿里云技术工单进行续费。
试用基础版到期后能否购买标准版?是否需要重新创建应用?
试用的基础版License到期后,您可以直接购买标准版License并继续使用原有应用,无需重新创建应用:
进入音视频终端SDK购买页,选择短视频,在平台行选择移动端,SDK版本选择标准版,确认应付费用后单击立即购买。
返回我的授权页面,选择License管理标签页,单击License绑定,选择原有应用与新购的标准版License订单,单击绑定。
绑定成功后,在License管理标签页单击目标应用下的下载证书,用新下载的License证书文件替换工程中原有的证书文件,即可完成切换。
短视频SDK标准版与专业版共用同一SDK包,通过License类型区分可用功能,因此应用的标识符(安卓包名、iOS BundleID)与License Key均保持不变,工程中的SDK依赖无需更换。