在 RealtimeKit 网络研讨会中,演示者从舞台发布音频和视频。观众观看,并可以请求加入舞台。
本指南使用默认的网络研讨会预设设置网络研讨会,并用 RealtimeKit UI Kit 渲染。若要改用自定义界面,请将 RealtimeKit Core SDK 与舞台管理一起使用。
每个 RealtimeKit 应用都包含两个用于网络研讨会的默认预设。为每位参与者分配其中一个预设,修改它们,或创建自己的预设以适配你的应用。
| 角色 | 默认预设 | 舞台行为 | 可以接受舞台请求 |
|---|---|---|---|
| 演示者 | webinar_presenter |
可以加入舞台并发布音频和视频 | 是 |
| 观众 | webinar_viewer |
可以请求加入舞台 | 否 |
在设置网络研讨会之前,请确保你已具备:
- 带有 RealtimeKit 应用的 Cloudflare 账户 ↗。
- 具有 Realtime Admin 权限的 API 令牌。将其保留在服务器端。不要在前端代码中暴露它。
- 可以调用 RealtimeKit REST API 以创建会议并添加参与者的后端。
- 已准备好集成 RealtimeKit UI Kit 的前端应用。
如果尚未完成这些要求,请参阅快速入门。
- 在 RealtimeKit 仪表板 ↗中,转到 Presets 并查看默认的
webinar_presenter和webinar_viewer预设。两个预设的 Meeting Type 都设置为 Video (WebRTC),并且在 Configuration > Stage & Media 下已打开 Manage Stage (Webinar)。 - 使用 Create Meeting API 创建会议。保存返回的会议
id供下一步使用。 - 使用 Add Participant API 将每位演示者和观众添加到会议。将
webinar_presenter分配给演示者,将webinar_viewer分配给观众。 - 将每位参与者返回的
authToken仅交付给该特定用户的前端会话。 - 使用参与者的
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 实现相同行为。
- 以演示者身份加入会议,并确认你可以发布音频和视频。
- 以观众身份加入会议,并确认默认情况下你无法发布音频或视频。
- 作为观众,请求加入舞台。
- 作为演示者,接受请求并确认观众现在可以发布音频和视频。
演示者和观众均按 Audio/Video Participants 计费。有关详细定价信息,请参阅定价。
- 使用自定义控制栏或 UI Kit 附加组件自定义网络研讨会界面。
- 查看面向演示者和观众媒体质量的视频与联播建议。
- 录制网络研讨会并将录制存储到你自己的存储中。
- 使用 webhooks 在后端跟踪网络研讨会生命周期事件。