Web 观播 SDK 提供观看直播、评论、抽奖等功能；Web 上传 SDK 支持将本地视频上传至企业直播媒资库，以及上传本地图片做为媒资库中视频的封面。由于 Web 观播 SDK 和上传 SDK 的 API 不支持跨域调用，因此在集成 SDK 前，需要将使用的域名 URL 加入白名单，从而保证 SDK 的正常使用。本文介绍如何将域名 URL 加入白名单。

前提条件 #

• 确保您已开通尊享版套餐。详见计费说明。
• 确保您拥有火山引擎主账号或具备超管角色的子账号。有关如何添加子账号，详见子账号管理。

注意事项 #

单个主账号默认最多可配置 10 个 Web SDK 域名。若您想在开发阶段快速体验点播能力，您可以将前端服务端口设置为 80 或 8000，并在本机的 hosts 文件中添加配置：127.0.0.1 dev-live.bytedance.com。

新增 Web SDK 配置 #

1. 登录企业直播控制台。
2. 在顶部导航栏，单击账户中心。
3. 在左侧导航栏，选择开发集成 > Web SDK 配置。
4. 单击新增配置。
   
5. 在弹出的新增 WebSDK 域名配置对话框中，添加域名 URL 并选择生效场景，然后单击保存：
   1. 输入您使用的域名 URL，不包含协议头。例如泛域名 *.example.com 或格式如 www.example.com 的精确域名。您可通过回车键添加多个域名。单次最多支持添加 10 个域名。
      
   2. 选择 URL 生效的场景：
      • 直播：域名 URL 将在直播和上传场景生效。
      • 预告与回放：域名 URL 将在预告与回放场景生效。
        保存后，直播和上传场景的域名配置将在 10 分钟左右生效，预告和回放的域名配置将在 2-3 个工作日生效。

管理 Web SDK 配置 #

1. 登录企业直播控制台。
2. 在顶部导航栏，单击账户中心。
3. 在左侧导航栏，选择开发集成 > Web SDK 配置。
4. 在 Web SDK 配置页面，你可完成以下操作。
   
   • 输入域名 URL 搜索。支持模糊搜索。
   • 在直播/上传配置状态和预告/回放配置状态右侧的筛选下拉框中，按需选择以下状态，完成筛选。
     • 配置中：已添加 Web SDK 配置，但域名尚未加入白名单。
     • 已生效：域名已加入白名单。
     • 已失效：域名白名单已过期或出现异常。
     • 未配置：该场景未添加该域名 URL。
   • 单击编辑，修改域名 URL 的生效场景。若 SDK 正在配置中，则无法修改生效场景。请等待配置生效后再进行修改。
   • 单击删除，删除 Web SDK 配置。删除后，将无法正常使用 Web 观播 或上传 SDK，请谨慎操作。

后续操作 #

在企业直播控制台新增 Web SDK 配置后，您可集成 SDK 体验功能，详见集成 Web 观播 SDK和集成 Web 上传 SDK。