← Cloudflare Realtime / realtime / realtimekit / concepts

Preset

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

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

Пресеты принадлежат App и применяются к участникам, а не к встречам.

Один и тот же пресет можно назначить нескольким участникам при их создании через Add Participant API. Участники одной Meeting могут иметь разные пресеты, что дает каждому пользователю свою роль и опыт.

Пример: крупный виртуальный класс EdTech

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

Набор пресетов по умолчанию создаётся автоматически при создании приложения через Панель управления Cloudflare ↗.

Пресет также можно создать с помощью панель управления ↗ или API создания пресета.

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/presets \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "config": {
            ...<preset-configuration-json>
        }'

Мы предоставляем редактор с графическим интерфейсом для создания и управления пресетами в Панель управления Cloudflare ↗.

Разрешения делятся на следующие категории:

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

• Управление сценой: Крупные встречи можно настроить с виртуальной сценой. Участники на сцене могут транслировать звук и видео, а участники вне сцены видят эти медиаданные и по-прежнему могут пользоваться чатом, опросами и плагинами.

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

• Чат: RealtimeKit позволяет пользователям отправлять и получать сообщения в реальном времени. Вы также можете отправлять личные сообщения (видимые только определённому пользователю). Вы можете настроить, у кого есть доступ к отправке и получению разных видов сообщений.

• Опросы: Позволяет пользователю настраивать, кто может создавать опросы во встрече, просматривать их и взаимодействовать с ними.

• Плагины: Плагины представляют собой интерактивные приложения реального времени, которые запускаются внутри встречи и упрощают совместную работу. RealtimeKit позволяет создавать собственные плагины, а также предлагает встроенные варианты, такие как Whiteboard и Document Sharing.

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

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

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

• Connected Meetings: Connected Meetings позволяют разделить основную встречу на связанные пространства для небольших групповых обсуждений или параллельных сессий. Права доступа определяют, могут ли участники перемещаться между связанными встречами, возвращаться в родительскую встречу, а также создавать, обновлять и удалять эти встречи.

  Подробнее о Connected Meetings см. в Встречи.

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

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

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

• Добавить Участники ко встрече: управляйте тем, кто может присоединиться, их ролями и правами доступа, которые они наследуют.
• Начало работы с RealtimeKit SDKs : Интегрируйте RealtimeKit в веб- или мобильное приложение всего за несколько строк кода.