预设(Preset)是一个可重用的配置,它定义了参与者在会议中的体验。 它决定了:
- 他们加入的会议类型(视频、语音或网络研讨会)
- 他们可以执行的操作(权限和控制功能)
- UI 的外观和风格,包括颜色和主题,使体验符合您应用程序'的品牌形象。
预设属于 App,并且它们应用于参与者——而不是应用于会议。
通过 Add Participant API 创建参与者时,您可以将相同的预设分配给多个参与者。同一会议中的参与者可以拥有不同的预设,从而允许每个用户拥有不同的角色和体验。
示例:大型在线教育课堂
- 老师使用
webinar-host预设——他们可以共享媒体并访问主持人控制功能。 - 学生使用
webinar-participant预设——他们不能共享媒体,但可以使用聊天等功能。 - 助教使用
group-call-host预设——他们可以共享媒体,但不拥有完全的主持人特权。
当您通过 Cloudflare 仪表板(Dashboard) ↗创建 app 时,系统会为您创建一组默认预设。
您还可以使用仪表板(Dashboard) ↗或 Create Preset API 创建预设。
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/presets \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"config": {
...<preset-configuration-json>
}'我们在 Cloudflare 仪表板(Dashboard) ↗中提供了一个基于 UI 的编辑器,以创建和管理预设。
权限分为以下几类:
-
主持人控制: 这些权限允许用户控制会议、管理参与者并执行管理操作,例如踢出用户、将他人的视频/音频静音等。
-
舞台管理: 大型会议可以配置虚拟舞台。舞台上的参与者可以共享其音频和视频,而舞台下的参与者可以观看这些媒体,但仍然可以使用聊天、投票和插件等功能。
用户可以申请上台,主持人可以随时将用户添加到舞台或从舞台上移除。 有关舞台管理的更多信息,请参阅会议。
-
聊天: RealtimeKit 允许用户实时发送和接收消息。您还可以发送私信(仅对特定用户可见)。您可以配置谁有权发送和接收各种消息。
-
投票: 允许用户配置谁可以在会议中创建、查看和参与投票。
-
插件: 插件是运行在会议内部的交互式实时应用程序,可使协作更容易。RealtimeKit 允许您构建自己的插件,还提供白板和文档共享等内置选项。
您可以控制允许参与者查看、打开或关闭哪些插件。
-
等候室: 等候室允许参与者在被接纳之前加入会议,从而让主持人能够控制谁在何时进入。它有助于管理准入、减少干扰并确保会议顺利开始。
主持人可以随时接纳或移除参与者,并且您可以配置谁应该自动绕过等候室。 有关等候室的更多信息,请参阅会议。
连接的会议:
连接的会议允许您创建链接到主会议的会议空间,从而进行更小组的讨论或平行会话。参与者可以被授予在会议之间移动或返回父会议的权限。主持人可以创建、更新或删除这些连接的空间。Beta 有关连接会议的更多信息,请参阅会议。
-
其他: “其他”权限允许您对不属于特定类别的参与者体验的其他方面进行微调。
这些选项控制诸如编辑名称、查看参与者列表、同步标签页视图、启用转录以及其他增强用户在会议中互动方式的辅助功能。
在了解会议和会话期后,您可以探索以下后续步骤:
- 向会议添加参与者(Participants) – 管理谁可以加入、他们的角色以及他们继承的访问控制。
- 开启使用 RealtimeKit SDK – 只需几行代码即可将 RealtimeKit 集成到您的 Web 或移动应用中。