跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

设置网络研讨会

最后更新 查看 MarkdownAgent 设置

在 RealtimeKit 网络研讨会中,演示者从舞台发布音频和视频。观众观看,并可以请求加入舞台。

本指南使用默认的网络研讨会预设设置网络研讨会,并用 RealtimeKit UI Kit 渲染。若要改用自定义界面,请将 RealtimeKit Core SDK 与舞台管理一起使用。

网络研讨会角色

每个 RealtimeKit 应用都包含两个用于网络研讨会的默认预设。为每位参与者分配其中一个预设,修改它们,或创建自己的预设以适配你的应用。

角色 默认预设 舞台行为 可以接受舞台请求
演示者 webinar_presenter 可以加入舞台并发布音频和视频 是
观众 webinar_viewer 可以请求加入舞台 否

开始之前

在设置网络研讨会之前,请确保你已具备:

  • 带有 RealtimeKit 应用的 Cloudflare 账户 ↗。
  • 具有 Realtime Admin 权限的 API 令牌。将其保留在服务器端。不要在前端代码中暴露它。
  • 可以调用 RealtimeKit REST API 以创建会议并添加参与者的后端。
  • 已准备好集成 RealtimeKit UI Kit 的前端应用。

如果尚未完成这些要求,请参阅快速入门。

设置网络研讨会

  1. 在 RealtimeKit 仪表板 ↗中,转到 Presets 并查看默认的 webinar_presenter 和 webinar_viewer 预设。两个预设的 Meeting Type 都设置为 Video (WebRTC),并且在 Configuration > Stage & Media 下已打开 Manage Stage (Webinar)。
  2. 使用 Create Meeting API 创建会议。保存返回的会议 id 供下一步使用。
  3. 使用 Add Participant API 将每位演示者和观众添加到会议。将 webinar_presenter 分配给演示者,将 webinar_viewer 分配给观众。
  4. 将每位参与者返回的 authToken 仅交付给该特定用户的前端会话。
  5. 使用参与者的 authToken 初始化 RealtimeKit UI Kit。UI Kit 会根据参与者的预设渲染网络研讨会界面,包括舞台控件。

使用 API 配置预设

如果你以编程方式而不是通过仪表板管理预设,请使用 Create Preset API,并设置以下字段:

  • 将 config.view_type 设置为 WEBINAR。
  • 将两个预设的 permissions.stage_enabled 都设置为 true。
  • 将审核舞台请求的参与者的 permissions.can_accept_production_requests 设置为 true。

根据你想要的舞台行为,将 permissions.stage_access、permissions.media.audio.can_produce、permissions.media.video.can_produce 和 permissions.media.screenshare.can_produce 设置为相同的值:

舞台行为 适用于 值
允许加入 演示者 ALLOWED
可以请求加入 可以请求加入舞台的观众 CAN_REQUEST
仅可观看 仅观看观众 NOT_ALLOWED

有关完整请求架构,请参阅 Presets。

管理舞台请求

预设 Behaviour 设置为 Can request to join 的观众可以从 UI Kit 界面请求舞台访问权限。预设已打开 Accept Requests 的演示者会收到请求,并可以接受或拒绝。

一旦被接受,观众就会加入舞台,并可以像演示者一样发布音频和视频。RealtimeKit UI Kit 默认处理此流程。若要构建自定义界面,请使用 Stage Management 中的舞台管理 API 实现相同行为。

验证网络研讨会

  1. 以演示者身份加入会议,并确认你可以发布音频和视频。
  2. 以观众身份加入会议,并确认默认情况下你无法发布音频或视频。
  3. 作为观众,请求加入舞台。
  4. 作为演示者,接受请求并确认观众现在可以发布音频和视频。

定价

演示者和观众均按 Audio/Video Participants 计费。有关详细定价信息,请参阅定价。

后续步骤

这篇文档对您有帮助吗?