在用户可以通过 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 会话数据、事件或分析与您系统中的用户信息相关联。
在理解参与者后,您可以探索以下主题:
- 了解预设(Presets)如何为参与者定义角色和权限
- 开启使用 RealtimeKit SDK