You need to enable JavaScript to run this app.
文档中心
视频直播

视频直播

请输入
  • 文档首页
    • 视频直播控制台指南应用管理获取 SDK License
复制全文
下载 pdf
我的收藏
应用管理
获取 SDK License
复制全文
下载 pdf
我的收藏
获取 SDK License

要在应用中使用视频直播 SDK，您必须先获取有效的 License。该 License 用于激活 SDK 在您应用中的功能。本文介绍从控制台创建 SDK 应用到获取 License 的整个流程。

注意

仅在使用以下视频直播 SDK 时才需要创建 SDK 应用并获取 License：

  • iOS 拉流 SDK
  • Android 拉流 SDK
  • Flutter 拉流 SDK
  • React Native 拉流 SDK
  • HarmonyOS NEXT 拉流 SDK
  • uni-app 拉流 SDK
  • Web 拉流 SDK（2.11.2 及以上版本）

前提条件

  • 对于 Android、iOS 或 HarmonyOS NEXT（鸿蒙星河版，以下简称 HarmonyOS NEXT）应用，请准备以下信息：
    • Android：您的应用包名，可在项目 app 目录下 build.gradle 文件中的 applicationId 字段中找到。
    • iOS：您的应用 Bundle ID，可在 Xcode 中应用 Target 的 Bundle Identifier 字段中找到。
    • HarmonyOS NEXT：您的应用包名，可在项目的 AppScope/app.json5 文件中的 bundleName 字段中找到。
  • 对于 Web 应用，请准备以下信息：
    • Web（浏览器网页场景）：一个泛域名，例如 *.example.com，该泛域名需覆盖所有嵌入播放器的页面。
    • WebOTT（Web Over-The-Top，指运行在 Tizen 和 webOS 智能电视系统上的 Web 应用场景，仅 Web 拉流 SDK 2.12.0 及以上版本支持）：
      • Tizen：您的应用标识，可在项目的 config.xml 文件中的 applicationId 字段中找到。
      • webOS：您的应用标识，可在项目的 appinfo.json 文件中的 id 字段中找到。

步骤一：创建或绑定 SDK 应用

  1. 登录视频直播控制台。
  2. 左侧导航栏选择应用管理。
  3. 单击创建应用，创建一个 SDK 应用。如果您已在视频点播等火山引擎产品控制台创建过 SDK 应用，则单击绑定已有应用。
  4. 配置基本信息。
    视频直播的 SDK 应用按接入端类型分为 App 和 Web 两类。
    • App 类型应用：用于集成客户端拉流 SDK，包括 iOS、Android、Flutter、React Native、HarmonyOS NEXT 或 uni-app 拉流 SDK。
    • Web 类型应用：用于集成 Web 拉流 SDK。

    说明

    • App 类型应用和 Web 类型应用是两套独立的应用类型，不支持互相转换，也不支持在已有 Web 应用中追加 Android、iOS 或 HarmonyOS NEXT 配置，或在已有 App 应用中追加 Web 配置。
    • 如果您的业务同时包含 Web 端和 App 端接入，需要分别创建或绑定对应类型的 SDK 应用，并获取各自的 App ID 和 License，在对应端的 SDK 初始化配置中填入相关信息即可独立使用。

完成以下步骤。

Image

  • 应用类型：选择 App，用于集成客户端 SDK。
  • 应用名：
    • 如果您在创建应用，请输入一个唯一的名称。名称长度为 1 到 128 个字符，可以包含英文（A-Z、a-z）、数字（0-9）、中文字符和常用符号。
    • 如果您在绑定已有应用，请选择 App ID 或应用名称。您可以在视频点播等火山引擎产品控制台的应用管理页面找到该 ID。
  • 英文名：应用的英文名称。名称长度为 1 到 255 个字符，可以包含英文（A-Z、a-z）、数字（0-9）和常用符号。

    说明

    仅在创建应用时需输入英文名称。

  • 项目：选择该 SDK 应用所属的项目，以实现基于项目的账单查看、子账号授权等功能。
  • PackageName、BundleID 和 HarmonyPackage：分别填写您的 Android 应用包名、iOS 应用的 Bundle ID 以及 HarmonyOS NEXT 应用包名，从而将 SDK License 与您的应用绑定，防止未经授权的使用。根据应用实际发布的平台按需配置。例如，Flutter、React Native 或 uni-app 应用如果同时支持 iOS 和 Android 平台，则需同时填写 PackageName 和 BundleID，如果应用只支持单一平台，则只需填写对应的平台信息。

    注意

    确保填写的 PackageName、BundleID 和 HarmonyPackage 全局唯一。如果提示 PackageName、BundleID 或 HarmonyPackage 已使用，请先检查当前账号下是否已有 SDK 应用使用该信息。如果已被当前账号下的 SDK 应用使用，请修改或删除原 SDK 应用中的对应信息后重试。如果当前账号下未找到，可能已被其他账号下的 SDK 应用占用，请登录对应账号修改或删除原 SDK 应用中的对应信息后重试。如无法确认占用账号或无法操作对应账号，请创建工单处理。

  1. 如果您在创建应用，单击创建应用。如果您在绑定已有应用，单击下一步。
  2. 配置并绑定 License 到 SDK 应用。

    说明

    • 每个 License 只能绑定到一个 SDK 应用。
    • SDK License 的有效期从绑定到 SDK 应用时开始计算。
    • License 用于管理 SDK 及其增值服务的使用权限和使用时长。关于各 License 版本支持的功能，详见客户端 SDK：SDK 概述 和 Web 拉流 SDK：SDK 概述。关于各 License 版本的价格，详见 直播 SDK 计费。
    • 如需集成 2.11.2 之前版本的 Web 拉流 SDK，您无需绑定 License，直接获取 App ID 即可。但建议您升级 Web 拉流 SDK 至 2.11.2 及以上版本，以获取更佳的功能与服务能力。

试用版 License 仅供测试使用，有效期为一个月。例如，2026 年 5 月 10 日 10:00 绑定的 License，将于 2026 年 6 月 10 日 10:00 到期。试用版 License 不支持使用相同应用绑定信息重复测试。例如，SDK 应用 A 的试用版 License 已绑定某个 PackageName，即使后续将 SDK 应用 A 的 PackageName 修改为其他值，也不能使用原 PackageName 为 SDK 应用 B 绑定试用版 License。

完成以下步骤，获取试用版 License。

  1. 选择试用版作为 License 版本，单击去领取，即可跳转至 License 购买页面。
    Image
  2. 在购买页面，单击立即领取以获取免费 License。
    Image
  3. 完成免费 License 的结算流程后，返回配置页面。选择获取的试用版 License，单击确认。
    Image

    说明

    如果新的试用版 License 未立即显示在列表中，单击刷新图标更新页面。

    Image

在试用版 License 到期前，或您准备将应用发布到生产环境时，您必须将 License 升级为基础版或高级版。详见升级试用版 License 为基础版或高级版 License。

  1. 创建或绑定应用后，在应用管理页面的应用列表中找到该应用，并获取 App ID，用于集成和初始化 SDK。
    Image

步骤二：获取 License

视频直播 SDK 必须配合 SDK License 使用。您获得的 License 仅对绑定的 SDK 应用有效。

在应用管理页面，找到目标应用。

  • Android、iOS 或 HarmonyOS NEXT 应用：单击下载图标下载 License 文件，即可使用 License 文件集成 SDK。
    Image
  • Web 应用：单击下载图标下载 License 文件，或单击详情获取 License URL，即可用于集成 Web 拉流 SDK。
    Image

说明

确保应用状态为已激活。

相关操作

在应用管理页面，您可以在操作列下完成以下操作。

Image

  • 编辑：单击编辑，可修改应用名、PackageName、BundleID、HarmonyPackage、泛域名或 WebOTT 应用标识。
    • 如果 License 已激活，修改后系统会根据新的应用信息重新生成 License。您需更换 SDK 的 License 文件或 License URL。原 License 会在一段时间内继续有效，新的 License 到期时间与原 License 一致。
    • 如果 License 已过期，修改后，系统会在续签时根据新的应用信息生成 License。您需在续签完成后更换 SDK 的 License 文件或 License URL。
  • 删除：单击删除，删除应用。

    注意

    如果您误删应用，可通过绑定已有应用找回并继续使用原 App ID。绑定时，需重新配置 PackageName、BundleID、HarmonyPackage、泛域名或 WebOTT 应用标识，系统不会保留删除前的配置信息。如果 SDK 应用刚被删除，在绑定已有应用对话框中可能无法搜索到该应用，建议稍后重试。

  • 续签：当您的 License 即将到期或已过期时，单击续签，续签 License。详见续签 License。
  • 转正式版：单击转正式版，升级试用版 License 为基础版或高级版 License。详见升级试用版 License 为基础版或高级版 License。
  • 购买激活：如果 License 尚未绑定到 SDK 应用，单击购买激活，配置并绑定 License。

后续操作

使用您从控制台获取的 License 文件、License URL 和 App ID，集成和初始化 SDK。详见：

最近更新时间：2026.09.09 17:48:43
这个页面对您有帮助吗？
有用
有用
无用
无用