获取短视频SDK License

更新时间:
复制 MD 格式

短视频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天,滚动计算。

版本

获取方式

相关说明

基础版

  • 方式一:通过点播控制台SDK管理 > 我的授权创建应用并绑定License,申请基础版短视频SDK试用版(有效期1个月)或购买基础版短视频SDK正式版(有效期1年),详细操作,请参见管理License。

  • 方式二:购买流量包、存储包、转码包、智能审核包,T-30至T天的时间范围内(最近31天)内订单总金额超过1900元时,可获赠基础版短视频SDK正式版(有效期1年),满足条件后,您需要填写表单提交申请,后续我们将通过邮件方式将申请结果发送给您。

通过方式一获取License时,每个订单可授权一个应用(包括iOS和Android)。

标准版

  • 方式一:通过点播控制台SDK管理 > 我的授权 创建应用并绑定License,申请标准版短视频SDK试用版(有效期1个月)或购买标准版短视频SDK正式版(有效期1年),详细操作,请参见管理License。

  • 方式二:购买流量包、存储包、转码包、智能审核包,T-30至T天的时间范围内(最近31天)内订单总金额超过3万元时,可获赠标准版短视频SDK正式版(有效期1年),满足条件后,您需要填写表单提交申请,后续我们将通过邮件方式将申请结果发送给您。

通过方式一获取License时,每个订单可授权一个应用(包括iOS和Android)。

专业版

  • 方式一:通过点播控制台SDK管理 > 我的授权创建应用并绑定License,申请专业版短视频SDK试用版(有效期1个月)或购买专业版短视频SDK正式版(有效期1年)。详细操作,请参见管理License。

  • 专业版短视频SDK具备高级美颜、智能抠图和手势识别等功能,由阿里云美颜特效SDK或第三方SDK提供,需单独收费。美颜特效SDK的购买请参见获取美颜特效SDK License;第三方SDK,可联系第三方商务人员获得折扣及其他信息。

License授权

步骤一:创建应用

  1. 进入点播控制台我的授权,选择应用管理标签页,点击创建应用。

  2. 编辑应用信息,应用按端类型分为Web端和移动端。

    1. 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。

    2. 移动端:选择平台,填入应用名称,并填入相对应的安卓包名、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并绑定应用后即可使用专业版功能。

  1. 返回我的授权页面,选择订单实例标签页,点击License购买。

  2. 进入音视频终端SDK购买页,根据业务需求选择SDK和对应的功能模块,确认无误后进行购买。

    重要

    购买短视频SDK License请确保所选平台与应用端类型相匹配,端类型不符将导致License绑定失败。在音视频终端SDK购买页面,选择所需的SDK(如短视频),然后在平台行选择移动端,配置SDK版本(如移动端标准版、移动端专业版),确认应付费用后单击立即购买。

  3. 支付成功后返回订单实例标签页,您可以看到新购买的订单实例。

步骤三:绑定License

  1. 返回我的授权页面,选择License管理标签页,单击License绑定。

  2. 进入License绑定页面,选择您需要绑定的应用和对应的SDK License订单,确认信息无误后,单击绑定。

    说明

    每个License订单最多绑定一款应用。

    在授权平台中勾选需要授权的平台(如 Android)。移动端 License 仅能授权给移动端应用。

  3. 绑定成功后返回License管理标签页,您可以看到绑定成功的应用名称和对应的授权信息。

步骤四:获取授权信息

  1. 在License管理标签页,找到目标应用。在License管理页签中,页面顶部显示License Key,可单击旁边的复制按钮进行复制;应用列表中每个应用名称下方提供下载证书链接。

  2. 确认授权信息无误后,单击下载证书,将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管理页面续费

  1. 进入点播控制台我的授权。

  2. 选择License管理标签页,找到对应应用下绑定的实例ID,点击操作栏的续期按钮。

    重要
    1. 如果实例ID为空或者续期时控制台出现报错,则需要通过方式三:新购License并绑定应用或阿里云技术工单进行续费。

    2. 续费针对License订单,如果您的License订单中包含多个SDK权益,续费将会对所有SDK进行整体续费,暂不支持变配。如有疑问,请提交阿里云技术工单咨询。

  3. 进入续费管理界面,点击操作栏的续订按钮。跳转至费用与成本 > 资源续订页面,在手动续订标签页中找到目标音视频终端SDK实例,单击操作列的续订。

  4. 进入音视频终端SDK续费页面。确认您的当前配置和购买时长无误后,点击立即购买完成续费(建议您勾选到期自动续费,以避免过期)。

方式二:资源包买赠

如果您在一个月内消费或者购买指定订阅包达到一定金额,获赠了相应License授权。需要在已有License授权使用过期之前,将获赠的License授权进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。

SDK

买赠金额

申请地址

播放器SDK

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

播放器SDK买赠申请

短视频SDK

买赠详情请参见获取短视频SDK License。

提交宜搭表单申请

直播推流SDK

免费使用

无需申请

方式三:新购License并绑定应用

如果您购买了SDK License且对应订单实例ID为空或者续期时控制台出现报错,需要在License授权过期之前在音视频终端SDK购买页下单购买,购买后进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。

订单实例ID为空:License管理页面中对应订单的实例ID列显示为空。

续期时控制台报错:

续费页面底部显示红色错误提示订单配置参数不符合校验条件,请重新选配商品!,导致无法通过立即购买完成续费。遇到此报错时,请通过方式三:新购 License 并绑定应用或提交阿里云技术工单进行续费。

试用基础版到期后能否购买标准版?是否需要重新创建应用?

试用的基础版License到期后,您可以直接购买标准版License并继续使用原有应用,无需重新创建应用:

  1. 进入音视频终端SDK购买页,选择短视频,在平台行选择移动端,SDK版本选择标准版,确认应付费用后单击立即购买。

  2. 返回我的授权页面,选择License管理标签页,单击License绑定,选择原有应用与新购的标准版License订单,单击绑定。

  3. 绑定成功后,在License管理标签页单击目标应用下的下载证书,用新下载的License证书文件替换工程中原有的证书文件,即可完成切换。

说明

短视频SDK标准版与专业版共用同一SDK包,通过License类型区分可用功能,因此应用的标识符(安卓包名、iOS BundleID)与License Key均保持不变,工程中的SDK依赖无需更换。