You need to enable JavaScript to run this app.
导航
License 管理
最近更新时间:2025.05.21 16:13:41首次发布时间:2021.02.23 10:42:41
我的收藏
有用
有用
无用
无用

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。每个 License 都有唯一的 License ID,需要与应用进行绑定。License 分为基础版、高级版和企业版,每个版本支持不同的功能。本文为您介绍如何在视频点播控制台获取 License 并将其与应用进行绑定。

说明

License 包:默认情况下,一个 License 包仅包含一个 License,仅支持绑定一个应用。如果您的公司开发多款 App,希望一个 License 包绑定多个应用,可联系商务咨询。同一个包下的 Lincese 具有相同的权限和有效期。

使用流程

您可按照下图流程使用 License:
Image

流程

说明

参考文档

创建应用

在视频点播控制台创建一个应用,并配置应用的中英文名称、Package Name、Bundle ID 和描述等基本信息。

创建应用

申请测试 License

根据自身业务需求申请不同版本的测试 License,有效期为 30 天。

申请免费测试 License

绑定 License 与应用

将您创建的应用与您申请的测试 License 绑定并将 License 文件下载至本地。

绑定 License 与应用

集成 SDK

参考文档在您的项目中集成播放器 SDK 并设置 License 文件路径。

升级至正式 License

SDK 功能测试完毕后,升级至正式 License。

升级至正式 License

注意事项
  • 若您同时开发 Android、iOS、Flutter、HarmonyOS NEXT 等多端项目,仅需购买一次 License。
  • 自 2024 年 7 月 30 日起,购买 License 时不再支持选择 H.265 硬解优化、蒙版弹幕和外挂字幕增值服务。这些增值服务自播放器 SDK 1.36.1 版本起有以下调整:
    • H.265 硬解优化功能由增值服务调整为:基础版支持标准 H.265 播放能力,高级版支持使用 H.265 的大数据机型黑名单和硬解优化。
    • 蒙版弹幕和外挂字幕功能由单独的增值服务调整至高级版。
      因此,若您先前购买的 License 包含这些增值服务,续期 License 时,增值服务的有效期也将延长,与 License 到期时间保持一致。若您先前没有购买过这些增值服务但当下有需求,请务必升级至播放器 SDK 1.36.1 或以上版本,并购买高级版即可。

前提条件

在创建应用前,请获取您的 Android、iOS 和 HarmonyOS NEXT 项目的包名:

  • 对于 Android 项目,包名是 build.gradle 文件中 applicationId 的值,例如 com.example.myapplicationtest
  • 对于 iOS 项目,包名是 Xcode 中 TARGETS 下 Bundle Identifier 的值。
  • 对于 HarmonyOS NEXT 项目,包名是 AppScope/app.json5 文件中 bundleName 的值。

创建应用

视频点播控制台应用管理页面提供覆盖 Android、iOS、Web、Flutter 和 HarmonyOS NEXT 多端的统一应用授权管理。本节为您介绍如何创建应用并配置应用的基本信息。

  1. 登录视频点播控制台

  2. 单击左侧导航栏 SDK 管理 > 应用管理

  3. 单击创建应用按钮。

  4. 根据提示填写应用信息。详细的参数说明如下表所示。

    参数

    说明

    地域

    支持以下选项:

    • 国内
    • 海外

    注意

    海外亚太东南(柔佛)地域邀测中,仅针对企业用户开放。如您有相关需求,请联系您的商务经理申请开通。开通后,支持将数据上报到海外地域。

    应用中文名称

    应用的中文名称,长度不超过 64 个字符。支持中文、英文、数字、._-

    应用英文名称

    应用的英文名称。长度为 4~30 个字符。支持小写英文字母、数字和下划线 _

    注意

    应用创建后,英文名称不可更改。

    应用类型

    支持以下选项:

    • App
    • Web/H5

    Android 包名

    应用类型App 时显示。填写您的 Android 项目包名,即 build.gradle 文件中 applicationId 的值,例如 com.example.myapplicationtest。长度不超过 128 个字符。支持中文、英文、数字、._-

    iOS 包名

    应用类型App 时显示。填写您的 iOS 项目包名,即 Xcode 中 TARGETS 下 Bundle Identifier 的值。长度不超过 64 个字符。支持中文、英文、数字、._-

    HarmonyOS Next 包名

    应用类型App 时显示。您的 HarmonyOS Next 项目包名,即 AppScope/app.json5 文件中 bundleName 的值。长度不超过 128 个字符。支持英文、数字、._

    域名

    应用类型Web/H5 时显示。填写您的网站域名。支持泛域名。

    描述

    应用描述,用于标识应用的用途。长度不超过 140 个字符。

  5. 单击确认。应用创建成功后,系统将自动生成一个唯一的应用 ID(App ID)。在后续集成客户端 SDK 时,您将需要使用这个 App ID。
    Image

申请免费测试 License

在项目测试阶段,您可以在视频点播控制台申请免费的测试 License。测试 License 有效期为 30 天。申请步骤如下:

  1. 登录视频点播控制台

  2. 单击左侧导航栏 SDK 管理 > 播放器 License

  3. 单击立即购买

  4. 根据您自身业务需求选择应用类型、License 版本、类型和时长:
    Image
    详细的参数说明如下表所示。

    参数

    说明

    应用类型

    支持以下选项:

    • App:集成至 Android/iOS/HarmonyOS 项目中
    • Web/H5:集成至 Web/H5 浏览器中

    版本

    • 应用类型App 时,支持以下选项:
      • 基础版:支持基础播放能力,适用于简单播放场景。
      • 高级版:支持更丰富的播放能力,接入后可达到“零首帧”的播放效果。同时提供技术支持、质量优化等专家服务。您还可按需选择增值服务。
      • 企业版:包含高级版全部功能,并支持客户端超分和自适应码率增值服务。
    • 应用类型Web/H5 时,支持以下选项:
      • 基础版:支持基础播放能力,适用于简单播放场景。
      • 高级版:支持更丰富的播放能力,接入后可达到“零首帧”的播放效果。同时提供技术支持、质量优化等专家服务。您还可按需选择增值服务。

    说明

    如需详细了解不同版本的功能,请见功能详情

    类型

    选择测试版

    时长

    测试 License 时长仅支持 1 个月。不支持续期和变更,到期后需重新申请。

  5. 单击提交订单

  6. 确认订单信息后,再单击下一步。您可以看到如下界面,表示测试 License 已成功开通。
    Image

绑定 License 与应用

成功申请 License 后,您需要将其与应用进行绑定,步骤如下:

  1. 登录视频点播控制台
  2. 单击左侧导航栏 SDK 管理 > 播放器 License
  3. 找到目标 License,单击详情
  4. 绑定应用区域,单击页面下方的新增应用按钮。

    说明

    默认情况下,一个 License 包仅包含一个 License,仅支持绑定一个应用,覆盖 Android、iOS、Flutter 和 HarmonyOS NEXT 多端。如果您的公司开发多款 App,希望一个 License 包绑定多个应用,可联系商务咨询。

  5. 在抽屉框中选中应用,再单击应用。您可看到如下界面,表示 License 已与应用成功绑定。
    Image
  6. 绑定完成后,单击下载按钮,将 License 文件下载至本地。在后续集成 SDK 时您需要设置 License 文件的路径。

升级至正式 License

测试 License 的有效期为 30 天。您需要在测试 License 到期前升级至正式 License,步骤如下:

  1. 登录视频点播控制台

  2. 单击左侧导航栏 SDK 管理 > 播放器 License

  3. 找到目标 License,单击升级正式版按钮。
    Image

  4. 根据您自身业务需求选择 License 时长,支持购买 1 年、2 年或按月购买。

  5. 单击提交订单按钮。

    说明

    如果您的业务场景无法通过标准购买流程完成,可单击申请人工开通

  6. 确认订单信息后,单击下一步,跳转到支付页面。
    Image

  7. 支付成功后,单击去控制台按钮,跳转至播放器 License 页面。License 列表的详细说明如下所示。

    参数

    说明

    License 包 ID

    License 包的唯一 ID。

    版本

    • 基础版
    • 高级版
    • 企业版

    应用类型

    • App
    • Web/H5

    License 类型

    • 正式版
    • 测试版

    状态

    审核状态:

    • 审核中:License 申请正在审核中。

      说明

      续期或变更审核过程中,线上业务不会中断。

    • 审核通过:License 审核完成。
    • 申请已撤回:撤回审核中的申请。

    生效时间

    License 生效时间。

    到期时间

    License 到期时间。

续期和变更正式 License

正式 License 支持续期或变更。

  • 续期是指延长 License 的可用时间。您可以选择续期 1 年或 2 年。
  • 变更是指升级 License 版本或购买增值服务。
    • 如果当前为基础版,可变更为高级版,并勾选高级版下的增值服务。
    • 如果当前为高级版,不支持变更为基础版,仅支持添加增值服务。
    • 如果当前为企业版,不支持变更。

说明

新增增值服务的到期时间与其所属 License 保持一致。例如,License 有效时间为 1 月 1 日至 12 月 31 日,在 6 月 1 日购买客户端超分增值服务,则增值服务有效时间为 6 月 1 日 至 12 月 31 日。

您可参考以下步骤在视频点播控制台申请续期和变更 License:

  1. 登录视频点播控制台
  2. 单击左侧导航栏 SDK 管理 > 播放器 License
  3. 单击 License 操作列的续期/变更按钮。
    Image
  4. 在对话框中根据提示勾选后,单击提交订单,然后根据页面提示完成支付。
    Image

常见问题

License 变更后,应用是否需要发版 ?

  • Android/iOS/HarmonyOS 应用:License 变更后,应用需要发版。License 续期或变更后,License 文件会发生变化,但 License ID 保持不变。您需要下载新的 License 文件,替换当前 App 版本中的旧 License 文件,然后根据最近的迭代计划发版。历史版本应用中的 License 会自动更新。当 License 续期后,播放器 SDK 会在检测到 License 文件有变化后自动更新 License 的有效时长。
  • Web/H5 应用:如集成 Web 播放器 SDK 时已通过 license.mainUrl 参数设置了 License 文件的在线地址,则 License 升级或续期后,SDK 会自动更新至最新 License 版本,无需您手动更新。

替换 License 文件后是否需要更新播放器 SDK?

无需更新 SDK。

License 未及时续期,到期后会发生什么?

一般情况下,我们建议您至少提前一个月对 License 进行续期。

Android/iOS 播放器 SDK

License 过期对播放体验的影响视播放器 SDK 版本而定。

  • 播放器 SDK 版本号 >= 1.36.1:
    • 如果您当前使用的是高级版或企业版 License,到期后会降级至基础版,高级版 SDK 功能和增值服务(例如预渲染、超分)将无法使用。
    • 如果您当前使用的是基础版 License,到期后会降级至系统播放器,会出现指标劣化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。

    说明

    1.36.1 版本对增值服务有以下调整:

    • H.265 硬解功能由增值服务调整为:基础版支持标准 H.265 播放能力,高级版支持使用 H.265 的大数据机型黑名单和硬解优化。
    • 蒙版弹幕和外挂字幕功能由增值服务调整至高级版。
  • 1.36.1 > 播放器 SDK 版本号 >= 1.31.2:
    • 如果您当前使用的是高级版或企业版 License,到期后会降级至基础版,高级版 SDK 功能和增值服务(例如预渲染、H.265 硬解)将无法使用。
    • 如果您当前使用的是基础版 License,到期后会降级至系统播放器,会出现指标裂化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。
  • 播放器 SDK 版本号 < 1.31.2:不区分使用的 SDK 版本,License 到期后均降级至系统播放器,可能会出现指标裂化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。

Web 播放器 SDK

License 过期后,Web 播放器 SDK 仍会支持基础播控能力,但会增加水印,显示火山引擎 logo。