Zarządzaj obiektami klientów

Na tej stronie opisujemy, jak zarządzać obiektami klienta, których dodatek potrzebuje do komunikacji z Google Meet.

Najpierw dodatek musi utworzyć 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 w przypadku dodatku działającego na głównym etapie, które 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 zostanie pobrany nieprawidłowy klient, pakiet SDK dodatków do Google Meet zgłosi wyjątek. Aby sprawdzić, w której ramce iframe (głównej czy w panelu bocznym) działa dodatek, użyj metody getFrameType().

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

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

Zastąp CLOUD_PROJECT_NUMBER numerem projektu Cloud.

Wspólne funkcje

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

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

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

Funkcje specyficzne dla klienta

Funkcje dostępne tylko w obiekcie MeetMainStageClient:

• Metoda notifySidePanel() wysyła wiadomość do panelu bocznego. Wiadomość można otrzymać, subskrybując frameToFrameMessagewywołanie zwrotne 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. Stan dodatku nie jest zachowywany w Meet, gdy wywoływana jest ta metoda. Dodatek musi zachować stan przed wywołaniem tej metody.

Funkcje dostępne tylko w obiekcie MeetSidePanelClient:

• Metoda notifyMainStage() wysyła wiadomość do mainStage. Wiadomość można odebrać, subskrybując właściwość frameToFrameMessage callback na głównej scenie.