Совместная работа с помощью дополнения Meet

Участники собрания могут совместно работать над надстройкой Google Meet. Когда начинается совместная деятельность, все участники собрания получают уведомление о том, что деятельность продолжается.

Это уведомление адаптировано к доступности и статусу установки дополнения:

  • Если у участника установлено дополнение : он может присоединиться к занятию.

  • Если у участника не установлено дополнение : ему будет предложено установить дополнение.

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

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

Начать деятельность

Действие запускается вызовом метода startActivity() , который использует интерфейс ActivityStartingState .

Шаг 1 (необязательно). Надстройка устанавливает состояние начала действия.

Метод setActivityStartingState() устанавливает или обновляет информацию о начальном состоянии надстройки, которая используется, когда участник принимает приглашение присоединиться к действию.

Надстройка может установить ActivityStartingState с помощью SDK надстроек Meet в любое время до или во время действия. После запуска действия надстройки другие участники собрания используют ActivityStartingState для инициализации своей надстройки.

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

Шаг 2. Надстройка запускает действие.

Действие начинается, когда надстройка вызывает метод startActivity() в MeetSidePanelClient .

Обязательно вызовите метод startActivity() в вашей надстройке, как только пользователь завершит выбор контента и будет готов начать действие.

В следующем примере кода показано, как вызвать метод startActivity() :

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

При вызове метода startActivity() Meet выполняет следующие действия:

  • Для других участников : Meet отображает уведомление о том, что действие продолжается.

  • Для инициатора : если в ActivityStartingState указан URL-адрес основной сцены, Meet открывает основную сцену, используя URL-адрес из ActivityStartingState .

Поделиться состоянием дополнения в действии

Когда пользователь присоединяется к действию, он загружает ваше дополнение на главную сцену или боковую панель в зависимости от ActivityStartingState .

С помощью свойства additionalData вы можете делиться исходными данными (также называемыми состоянием) с пользователями, присоединяющимися к действию. Вы также можете поделиться состоянием между пользователями, пока они взаимодействуют с вашим дополнением.

Вы можете поделиться состоянием несколькими способами:

  • Справьтесь с этим самостоятельно, создав собственный сервер синхронизации.
  • Используйте Co-Doing API , который представляет собой удобный и быстрый способ обмена произвольными данными между пользователями.