← Cloudflare Realtime / realtime / realtimekit

Основные понятия

На этой странице представлены основные концепции и ключевая терминология, используемые в RealtimeKit.

App представляет рабочая область в RealtimeKit. Она объединяет ваши встречи, участников, пресеты, записи и другие настройки в изолированном пространстве имён.

Относитесь к каждому App как к контейнеру, привязанному к конкретному окружению. Большинство команд создают один App для staging и ещё один для production, чтобы не смешивать данные.

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

Сессия помечается как ENDED вскоре после того, как последний участник покидает встречу. Встреча может иметь только одна активная сессия в любой конкретный момент времени.

Дополнительную информацию о встречах см. в Встречи.

Session представляет собой активный экземпляр встречи. Она создаётся, когда первый участник присоединяется к встрече, и завершается вскоре после того, как уходит последний участник.

Каждая сессия независима: у неё свои участники, чат и записи. Она также наследует настройки, заданные при создании встречи: record on start, persist_chat, и многое другое.

Пример: повторяющаяся встреча «Weekly Standup» встреча создаст новую сессию каждый раз при присоединении участников.

A Участник создаётся при добавлении пользователя во встречу через API добавления участника. Этот вызов API возвращает уникальный authToken который клиентский SDK использует для подключения к сессии и аутентификации пользователя.

Примечание: Не используйте повторно токены аутентификации участников.

Дополнительную информацию об участниках см. в Участники.

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

Создаётся на уровне App и может применяться к любому участнику в любой встрече в рамках этого App.

Это также определяет тип встречи, к которой присоединяется пользователь: видеозвонок, аудиозвонок или вебинар. Участники одной встречи могут использовать разные пресеты для гибкого распределения ролей. Пример: в крупном классе на edtech-платформе:

• Преподаватель присоединится с webinar-host preset, что позволяет им делиться своими медиа и дает доступ к элементам управления организатора.
• Студенты присоединится с webinar-participant preset, который запрещает им делиться медиа, но позволяет использовать такие функции, как чат.
• Ассистент преподавателя присоединится с group-call-host preset, что позволяет им делиться своими медиа, но без полного контроля.

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

Дополнительную информацию о пресетах см. в Пресеты.