为将应用发布至生产环境或防止因 License 过期导致服务中断,您需要有效管理 SDK License。本文介绍如何将试用版 License 升级为基础版或高级版 License,以及如何续签基础版或高级版 License。
前提条件
您已获取 SDK License。详见获取 SDK License。
升级试用版 License 为基础版或高级版 License
试用版 License 仅用于测试,不能用于生产环境。在试用版 License 到期前或应用发布到生产环境前,请将试用版 License 升级为基础版或高级版 License。
- 登录视频直播控制台。
- 左侧导航栏选择应用管理。
- 单击试用版 License 操作列下的转正式版。

- 选择基础版或高级版作为 License 版本。
基础版 License 适用于生产环境,有效期为一年。
选择以下任一方式,将试用版 License 升级为基础版 License。
- 直接购买:
- 单击去购买。

- 购买完成后,返回配置页面。选择基础版 License,单击确认。

说明
如果新购买的 License 未立即显示在列表中,单击刷新图标更新页面。

- 绑定流量包:购买 100 TB 或以上规格的直播流量包,即可免费获得一年的基础版 License。更多有关直播流量包的信息,详见预付费资源包。
说明
- 该方式仅适用于 App 类型应用。
- 绑定基础版 License 后,您无法自行换绑到其他 SDK 应用,因此请谨慎操作。如需改绑其他 SDK 应用,请创建工单处理。
- 如果您已有符合条件的流量包:从列表中选择流量包,并单击确认。
- 如果您尚未拥有符合条件的流量包:
- 单击去购买,购买流量包。

- 购买完成后,返回配置页面。选择流量包,单击确认。
说明
如果新购买的流量包未立即显示在列表中,单击刷新图标更新页面。

高级版 License 适用于生产环境,有效期为一年。
完成以下步骤,将试用版 License 升级为高级版 License。
- 单击去购买。

- 购买完成后,返回配置页面。选择高级版 License,单击确认。

说明
如果新购买的 License 未立即显示在列表中,单击刷新图标更新页面。

随后,您必须参考步骤二:获取 License在应用管理页面下载基础版或高级版 License 文件,或获取 License URL。然后,将用于 SDK 集成的试用版 License 替换为新的 License。
续签 License
当您的基础版或高级版 License 即将或已经到期时,应用管理页面会显示即将到期或已到期的提醒。请及时续签,以免影响线上业务。
- 登录视频直播控制台。
- 左侧导航栏选择应用管理。
- 单击操作列下的续签。

- 续签 License。
说明
仅支持将基础版 License 续签为基础版 License,高级版 License 续签为高级版 License。
选择基础版作为 License 版本,并选择以下任一方式续签为基础版 License。
- 直接购买:
- 单击去购买。

- 购买完成后,返回配置页面。选择基础版 License,单击确认。

说明
如果新购买的 License 未立即显示在列表中,单击刷新图标更新页面。

- 绑定流量包:购买 100 TB 或以上规格的直播流量包,即可免费获得一年的基础版 License。更多有关直播流量包的信息,详见预付费资源包。
说明
- 该方式仅适用于 App 类型应用。
- 绑定基础版 License 后,您无法自行换绑到其他 SDK 应用,因此请谨慎操作。如需改绑其他 SDK 应用,请创建工单处理。
- 如果您已有符合条件的流量包:从列表中选择流量包,并单击确认。
- 如果您尚未拥有符合条件的流量包:
- 单击去购买,购买流量包。

- 购买完成后,返回配置页面。选择流量包,单击确认。
说明
如果新购买的流量包未立即显示在列表中,单击刷新图标更新页面。

完成以下步骤,续签为高级版 License。
- 选择高级版作为 License 版本。
- 单击去购买。

- 购买完成后,返回配置页面。选择高级版 License,单击确认。

说明
如果新购买的 License 未立即显示在列表中,单击刷新图标更新页面。

在应用管理页面,您可以通过以下任一方式,验证 License 是否续签成功。
- 单击详情,查看 License 的到期时间是否已在原基础上延长一年。

- 确认创建时间列下,即将到期或已到期的提醒已消失。

常见问题
License 续签后,应用是否需要发版?
- Android、iOS 或 HarmonyOS NEXT 应用:License 续签后,SDK 会自动检测并更新 License 的有效时长。但为避免因网络问题导致自动更新失败,建议下载新的 License 文件,替换当前应用版本中旧的 License 文件,然后根据最近的迭代计划发版。
- Web 应用:这取决于您在集成 Web 拉流 SDK 时如何配置 License。
- 如果您设置了 License URL:无需任何操作,SDK 会在您续签 License 后自动更新为最新的 License 版本。
- 如果您未设置 License URL:您必须手动更新 License 文件,并发布应用的新版本。
修改应用的 PackageName、BundleID、HarmonyPackage、泛域名或 WebOTT 应用标识后,是否需要更换 License?
- 如果 License 已激活,修改后系统会根据新的应用信息重新生成 License。您需更换 SDK 的 License 文件或 License URL。原 License 会在一段时间内继续有效,新的 License 到期时间与原 License 一致。
- 如果 License 已过期,修改后,系统会在续签时根据新的应用信息生成 License。您需在续签完成后更换 SDK 的 License 文件或 License URL。
替换 License 后,我还需要做什么?
替换 License 后,您必须发布应用的新版本。发布后,对观众的影响如下:
- Android、iOS 或 HarmonyOS NEXT 应用:观众必须将应用更新到您发布的最新版本,才能正常使用服务。
- Web 应用:观众在下次访问或刷新页面时,浏览器会自动加载新资源,因此观众无需任何操作。
续签或升级后,如何计算 License 的新有效期?
计算方式取决于具体操作。
- 续签:有效期在当前 License 的原始到期时间基础上延长一年。例如,若 License 到期时间为 2026 年 5 月 10 日,您续签一年后,新到期时间为 2027 年 5 月 10 日,无论您何时续签。
- 升级:新的一年有效期从升级当天开始计算。
详见有效期计算规则。
License 过期后怎么办?
License 过期会导致服务中断。为避免对业务造成影响,请务必及时续费 License。
如何将基础版 License 升级为高级版?
当前不支持直接升级。您必须创建一个新的 SDK 应用,并为其绑定高级版 License。详见步骤一:创建或绑定 SDK 应用。
新的 SDK 应用使用的 PackageName、BundleID、HarmonyPackage、泛域名或 WebOTT 应用标识仍需全局唯一。如需复用原应用的绑定信息,请先确认原应用不再使用该信息,并修改或删除原应用后再创建新应用。