跳转到内容
搜索文档

参与者

最后更新 查看 MarkdownAgent 设置

在用户可以通过 RealtimeKit SDK 加入会议之前,您的后端必须使用 Add Participant API 将该用户作为参与者添加到该会议中。 在 RealtimeKit 中,**参与者(participant)**代表被允许加入特定会议的用户。

您可以把这想象成学生注册进课堂。会议就是课堂,而添加参与者就是您注册用户以允许他们出席的方式。

当您添加参与者时,您还需要选择应用哪个预设(preset)。预设定义了该参与者的角色、权限和会议体验。

参与者令牌

当您使用 Add Participant API 端点将参与者添加到会议时,它会返回:

  • 标识该参与者在会议中的参与者 id
  • 该参与者的身份验证令牌 token

您的后端应该将其提供给您的前端应用程序。当用户选择加入会议时,前端将该令牌传递给 RealtimeKit SDK。

RealtimeKit 使用令牌对参与者进行身份验证,并确定哪个会议和哪个参与者正在加入。如果没有有效的身份验证令牌,SDK 就无法代表该参与者加入会议。只要参与者拥有有效的身份验证令牌,该参与者就可以随着时间的推移加入同一会议的多个活动会话期(session)。

令牌有效性与刷新

参与者身份验证令牌是有时间限制的,最终会过期。当令牌过期时,您无需在会议中为同一用户创建新的参与者。

相反,您的后端可以调用 Refresh Participant Token API 端点。 该端点会为现有的参与者记录签发一个新的身份验证令牌,并保持参与者 id 和预设等细节不变。

自定义参与者标识符

在添加参与者时,您还可以选择提供一个自定义参与者标识符,称为 custom_participant_id。此值完全由您使用。 RealtimeKit 会存储它并在 API 中返回,但不会使用它来控制访问。它允许您将应用程序的用户映射到 RealtimeKit 参与者,并将 RealtimeKit 会话数据、事件或分析与您系统中的用户信息相关联。

后续步骤

在理解参与者后,您可以探索以下主题:

这篇文档对您有帮助吗?