Zarządzaj obiektami klientów

Z tej strony dowiesz się, jak zarządzać obiektami klienta, których dodatek potrzebuje do komunikacji z Google Meet.

Najpierw dodatek musi nawiązać sesję:

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

Zastąp CLOUD_PROJECT_NUMBER numerem projektu Google Cloud.

W ramach sesji można utworzyć 2 obiekty klienta:

• MeetMainStageClient dla dodatku działającego na głównym etapie, który można pobrać za pomocą await session.createMainStageClient().

• MeetSidePanelClient dla dodatku działającego w panelu bocznym, który można pobrać za pomocą await session.createSidePanelClient().

Ważne jest, aby pobrać prawidłowy obiekt klienta dla głównego etapu lub panelu bocznego. Jeśli pobrany zostanie nieprawidłowy klient, pakiet SDK dodatków Google Meet zgłosi wyjątek. Aby sprawdzić, w którym elemencie iframe (główny etap czy panel boczny) działa dodatek, użyj getFrameType() metody.

Poniższy przykładowy kod pokazuje, jak utworzyć instancję obiektu klienta głównego etapu:

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

Zastąp CLOUD_PROJECT_NUMBER numerem projektu w chmurze.

Wspólne funkcje

Niektóre funkcje są dostępne zarówno w obiekcie MeetMainStageClient, jak i MeetSidePanelClient, a inne są specyficzne dla danego klienta.

Oto przykłady funkcji dostępnych w obu klientach:

• Metoda getActivityStartingState() , która pobiera informacje o stanie początkowym dodatku, gdy uczestnik zaakceptuje zaproszenie do dołączenia do aktywności.
• Metoda getMeetingInfo() , która pobiera szczegóły spotkania, w którym działa dodatek.
• Metoda setActivityStartingState() która ustawia stan początkowy dodatku gdy uczestnik zaakceptuje zaproszenie do dołączenia do aktywności.
• Pełną listę funkcji dostępnych w obu klientach znajdziesz w MeetAddonClient obiekcie.

Funkcje specyficzne dla klienta

Funkcje dostępne tylko w obiekcie MeetMainStageClient:

• Metoda notifySidePanel() wysyła wiadomość do panelu bocznego. Wiadomość można odebrać, subskrybując wywołanie zwrotne frameToFrameMessage w panelu bocznym.

• Metoda loadSidePanel() otwiera element iframe panelu bocznego. Źródło elementu iframe jest ustawione na adres URL panelu bocznego z pliku manifestu.

• Metoda unloadSidePanel() zamyka element iframe panelu bocznego. Po wywołaniu tej metody stan dodatku nie jest zachowywany w Meet. Przed wywołaniem tej metody dodatek musi zachować swój stan.

Funkcje dostępne tylko w MeetSidePanelClient obiekcie:

• Metoda notifyMainStage() wysyła wiadomość do głównego etapu. Wiadomość można odebrać, subskrybując właściwość wywołania zwrotnego frameToFrameMessage w głównym etapie.