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

前提条件 #

• 对于 Android、iOS 或 HarmonyOS NEXT（鸿蒙星河版，以下简称 HarmonyOS NEXT）应用，请准备以下信息：
  • Android：您的应用包名，可在项目的 build.gradle 文件中的 applicationId 字段中找到。
  • iOS：您的应用 Bundle ID，可在 Xcode 中应用 Target 的 Bundle Identifier 字段中找到。
  • HarmonyOS NEXT：您的应用包名，可在项目的 AppScope/app.json5 文件中的 bundleName 字段中找到。
• 对于 Web 应用，请提供一个泛域名，例如 *.example.com，该泛域名需覆盖所有嵌入播放器的页面。

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

1. 登录视频直播控制台。

2. 左侧导航栏选择应用管理。

3. 单击创建应用，创建一个 SDK 应用。如果您已在视频点播等火山引擎产品控制台创建过 SDK 应用，则单击绑定已有应用。

4. 配置基本信息。

   Android、iOS 或 HarmonyOS NEXT 应用

   Web 应用

   完成以下步骤。
   

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

     说明

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

   • 项目：选择该 SDK 应用所属的项目，从而确保只有被授权访问该项目的子账号才能管理该应用。
   • PackageName、BundleID 和 HarmonyPackage：分别填写您的 Android 应用包名、iOS 应用的 Bundle ID 以及 HarmonyOS NEXT 应用包名，从而将 SDK License 与您的应用绑定，防止未经授权的使用。根据应用支持的平台，按需配置。例如，如果应用同时支持 iOS 和 Android 平台，则需同时填写 PackageName 和 BundleID，如果应用只支持单一平台，则只需填写对应的平台信息。

     注意

     • 确保 PackageName、BundleID 和 HarmonyPackage 全局唯一。
     • 创建应用或绑定已有应用后，您无法修改 PackageName、BundleID 或 HarmonyPackage。确保输入正确的取值。

   完成以下步骤。
   

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

     说明

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

   • 项目：选择该 SDK 应用所属的项目，从而确保只有被授权访问该项目的子账号才能管理该应用。
   • 泛域名：输入一个泛域名以授权播放。该泛域名需覆盖所有嵌入播放器的页面，以确保播放器能在匹配的一级子域名上运行。
     示例：如果您输入 *.example.com：
     • 匹配：a.example.com、b.example.com
     • 不匹配：a.b.example.com（多级子域名）、example.com（根域名）
       规则：
     • 该值必须以星号 (*) 开头，且长度不超过 128 个字符。
     • 通配符（*）只能用于您拥有的域名，不能用于公共后缀或顶级域名。
       • 正确示例：*.example.com（因为 example.com 是您拥有的具体域名）
       • 错误示例：*.com 或 *.com.cn（因为 .com 是顶级域名，.com.cn 是公共后缀，均不属于您拥有的域名）

     注意

     • 确保泛域名全局唯一。
     • 创建应用或绑定已有应用后，您无法修改泛域名。确保输入正确的取值。
     • 如需在电视端集成 Web 拉流 SDK，请联系视频直播技术支持团队获取帮助。

5. 如果您在创建应用，单击创建应用。如果您在绑定已有应用，单击下一步。

6. 配置并绑定 License 到 SDK 应用。

   说明

   • 每个 License 只能绑定到一个 SDK 应用。
   • SDK License 的有效期从绑定到 SDK 应用时开始计算。
   • License 用于管理 SDK 及其增值服务的使用权限和使用时长。关于各 License 版本支持的功能，详见客户端 SDK：SDK 概述 和 Web 拉流 SDK：SDK 概述。关于各 License 版本的价格，详见 直播 SDK 费用。
   试用版 License

   基础版 License

   高级版 License

   试用版 License 仅供测试使用，有效期为一个月。例如，2026 年 5 月 10 日 10:00 绑定的 License，将于 2026 年 6 月 10 日 10:00 到期。
   完成以下步骤，获取试用版 License。

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

      说明

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

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

   基础版 License 适用于生产环境，有效期为一年。例如，2026 年 5 月 10 日 10:00 绑定的 License，将于 2027 年 5 月 10 日 10:00 到期。基础版 License 可随时续签，详见续签 License。
   选择基础版作为 License 版本，并选择以下任一方式获取基础版 License。

   • 直接购买：
     1. 单击去购买。
        
     2. 购买完成后，返回配置页面。选择基础版 License，单击确认。
        

        说明

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

   • 绑定流量包：购买 100 TB 或以上规格的直播流量包，即可免费获得一年的基础版 License。更多有关直播流量包的信息，详见预付费资源包。

     说明

     该方式仅适用于 App 类型应用。

     • 如果您已有符合条件的流量包：从列表中选择流量包，并单击确认。
     • 如果您尚未拥有符合条件的流量包：
       1. 单击去购买，购买流量包。
          
       2. 购买完成后，返回配置页面。选择流量包，单击确认。

          说明

          如果新购买的流量包未立即显示在列表中，单击刷新图标更新页面。
          

   高级版 License 适用于生产环境，有效期为一年。例如，2026 年 5 月 10 日 10:00 绑定的 License，将于 2027 年 5 月 10 日 10:00 到期。高级版 License 可随时续签，详见续签 License。
   完成以下步骤，获取高级版 License。

   1. 选择高级版作为 License 版本。
   2. 单击去购买。
      
   3. 购买完成后，返回配置页面。选择高级版 License，单击确认。
      

      说明

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

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

步骤二：获取 License 文件 #

视频直播 SDK 必须配合 SDK License 使用。您获得的 License 仅对绑定的 SDK 应用有效。
在应用管理页面，找到目标应用，单击下载图标下载 License 文件，即可使用 License 文件集成 SDK。

如果是 Web 应用，您也可以单击详情获取 License URL，用于集成 Web 拉流 SDK。

相关操作 #

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

• 编辑：单击编辑修改应用名。
• 删除：单击删除，删除应用。

  注意

  删除应用后无法恢复，请谨慎操作。

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

后续操作 #

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

• iOS：集成 iOS SDK 和 初始化 iOS SDK
• Android：集成 Android SDK 和 初始化 Android SDK
• Flutter：集成 Flutter SDK 和 初始化 Flutter SDK
• React Native：集成 React Native SDK 和 初始化 React Native SDK
• HarmonyOS NEXT：集成 HarmonyOS NEXT SDK 和 初始化 HarmonyOS NEXT SDK
• uni-app：集成 uni-app SDK 和 初始化 uni-app SDK
• Web 拉流 SDK：集成 Web 拉流 SDK