← Cloudflare Realtime / realtime / realtimekit / concepts

Участник

Прежде чем пользователь сможет присоединиться к встрече через RealtimeKit SDK, ваш бэкенд должен добавить его как участника этой встречи с помощью Add Participant API. В RealtimeKit участник представляет пользователя, которому разрешено присоединиться к определенной встрече.

Это можно представить как зачисление студента в класс: встреча выступает классом, а добавление участника является тем способом, которым вы регистрируете пользователя, чтобы разрешить ему присутствовать.

Когда вы добавляете участника, вы также выбираете, какие пресет для применения. Пресет определяет роль, права доступа и опыт участника во встрече.

Когда вы добавляете участника во встречу с помощью Add Participant эндпойнт API возвращает:

• Участник id который идентифицирует этого участника в рамках встречи.
• Аутентификационный token для этого участника.

Ваш бэкенд должен передать его вашему фронтенд-приложению. Когда пользователь решает присоединиться к встрече, фронтенд передаёт токен в RealtimeKit SDK.

RealtimeKit использует токен для аутентификации участника и определения того, к какой встрече и от имени какого участника происходит подключение. Без действительного токена аутентификации SDK не может подключить участника ко встрече от его имени. Пока у участника есть действительный токен аутентификации, он может присоединяться к нескольким активным сессиям одной и той же встречи с течением времени.

Токены аутентификации участников действуют ограниченное время и в итоге истекают. После истечения срока действия токена не нужно создавать нового участника для того же пользователя во встрече.

Вместо этого ваш бэкенд может вызвать Обновить токен участника эндпойнт API. Этот эндпойнт выдаёт новый токен аутентификации для существующей записи участника, сохраняя такие данные участника, как id и задать тот же пресет.

При добавлении участника можно по желанию указать пользовательский идентификатор участника, называемый custom_participant_id. Это значение предназначено исключительно для вашего использования. RealtimeKit сохраняет его и возвращает в API, но не использует для контроля доступа. Оно позволяет сопоставить пользователя вашего приложения с участником RealtimeKit и связать данные сессии, события и аналитику RealtimeKit с информацией о пользователе в вашей системе.

После знакомства с участниками вы можете перейти к следующим темам:

• Узнайте, как Пресеты определяют роли и права участников
• Начало работы с RealtimeKit SDK