本页面概述了 RealtimeKit 中使用的核心概念和关键术语。
App 代表 RealtimeKit 内的一个工作区。它在一个隔离的命名空间下将您的会议、参与者、预设、录制和其他配置分组在一起。
将每个 App 视为特定于环境的容器——大多数团队会创建一个用于预发布(staging)的 App 和另一个用于生产(production)的 App,以避免数据混淆。
会议(Meeting)是一个可重复使用的虚拟房间,您可以随时加入。 每次参与者加入会议时,都会创建一个新的会话期(session)。
在最后一位参与者离开后不久,会话期将被标记为 ENDED。在任何给定时间,一个会议只能有一个活动会话期。
有关会议的更多信息,请参阅会议。
会话期(Session)是会议的活动实例。它在第一个参与者加入会议时创建,在最后一个参与者离开后不久结束。
每个会话期都是独立的,拥有自己的参与者、聊天和录制。它还继承了创建会议时设置的配置——record on start、persist_chat 等。
示例:一个周期性的“每周站会”会议在每次参与者加入时都会生成一个新的会话期。
当您通过 Add participant API 将用户添加到会议时,系统就会创建参与者(Participant)。此 API 调用会返回一个唯一的 authToken,客户端 SDK 会使用该令牌加入会话期并对用户进行身份验证。
注意:请勿为参与者重复使用身份验证令牌。
有关参与者的更多信息,请参阅参与者。
预设(Preset)是一组可重用的权限,它定义了参与者的体验以及 UI 的外观和风格。
在 App 级别创建,它可以应用于该 App 内任何会议的任何参与者。
它定义了用户加入的会议类型——视频通话、语音通话或网络研讨会。同一会议中的参与者可以使用不同的预设来创建灵活的角色。 示例:在大型在线教育课堂中:
- 老师将使用
webinar-host预设加入,允许他们共享其媒体并提供主持人控制功能。 - 学生将使用
webinar-participant预设加入,这限制了他们共享媒体,但允许他们使用聊天等功能。 - 助教将使用
group-call-host预设加入,允许他们共享其媒体,但不拥有完全控制权。
它还允许您自定义 UI 的外观和风格,包括颜色和主题,使体验符合您应用程序的品牌形象。
有关预设的更多信息,请参阅预设(Preset)。