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，不包含协议头。例如泛域名 *.example.com 或格式如 www.example.com 的精确域名，并单击保存。
   
   完成配置后，配置状态将显示为配置中，表示已添加 Web SDK 配置，但域名尚未加入白名单。请等待配置生效：
   • 直播和上传：保存域名 URL 后，配置将在 10 分钟左右生效。
   • 点播：保存域名 URL 后，配置将在 2-3 个工作日内生效。

管理 Web SDK 配置

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

后续操作

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