Управление объектами клиента

На этой странице описывается, как управлять клиентскими объектами, необходимыми надстройке для взаимодействия с Google Meet.

Во-первых, надстройке необходимо установить сеанс:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

Замените CLOUD_PROJECT_NUMBER на номер вашего проекта Google Cloud.

В ходе сеанса можно создать два клиентских объекта:

• MeetMainStageClient для дополнения, работающего на основном этапе , который можно получить с помощью await session.createMainStageClient() .

• MeetSidePanelClient для надстройки, работающей на боковой панели , которую можно получить с помощью await session.createSidePanelClient() .

Важно получить правильный клиентский объект для главной сцены или боковой панели. При получении неправильного клиента SDK дополнений Google Meet выдаёт исключение. Чтобы проверить, в каком iframe (главной сцене или боковой панели) запущено дополнение, используйте метод getFrameType() .

В следующем примере кода показано, как создать экземпляр объекта клиента основного этапа:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Замените CLOUD_PROJECT_NUMBER на номер вашего облачного проекта.

Общие функции

Некоторые функции доступны как в объекте MeetMainStageClient , так и в объекте MeetSidePanelClient , тогда как другие функции специфичны для определенного клиента.

Например, некоторые функции, доступные в обоих клиентах, включают:

• Метод getActivityStartingState() , который получает информацию о начальном состоянии надстройки, когда участник принимает приглашение присоединиться к активности.
• Метод getMeetingInfo() , который получает сведения о встрече, на которой запущено дополнение.
• Метод setActivityStartingState() , который устанавливает начальное состояние надстройки, когда участник принимает приглашение присоединиться к активности.
• Полный список функций обоих клиентов см. в объекте MeetAddonClient .

Клиентоориентированные функции

Функции, доступные только в объекте MeetMainStageClient :

• Метод notifySidePanel() отправляет сообщение боковой панели. Сообщение можно получить, подписавшись на функцию обратного вызова frameToFrameMessage в боковой панели.

• Метод loadSidePanel() открывает iframe боковой панели. В качестве источника iframe используется URL боковой панели из файла манифеста.

• Метод unloadSidePanel() закрывает iframe боковой панели. Состояние дополнения не сохраняется в Meet при вызове этого метода. Дополнение само решает, сохранять ли своё состояние до вызова этого метода.

Функции, доступные только в объекте MeetSidePanelClient :

• Метод notifyMainStage() отправляет сообщение на этап mainStage. Сообщение можно получить, подписавшись на свойство обратного вызова frameToFrameMessage на этапе mainStage.