Zarządzaj obiektami klientów

Na tej stronie opisaliśmy, jak zarządzać obiektami klienta, których potrzebuje wtyczka 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.

Na podstawie sesji można utworzyć 2 obiekty klienta:

Ważne jest, aby pobrać odpowiedni obiekt klienta na potrzeby głównego etapu lub panelu bocznego. Jeśli zostanie pobrany niewłaściwy klient, pakiet SDK dodatków Google Meet wyrzuci wyjątek. Aby sprawdzić, w którym iframe (obszar główny czy panel boczny) działa wtyczka, użyj metody getFrameType().

Ten przykładowy kod pokazuje, jak utworzyć instancję obiektu klienta głównej sceny:

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

Zastąp CLOUD_PROJECT_NUMBER numerem projektu w Google Cloud.

Wspólne funkcje

Niektóre funkcje są dostępne zarówno w obiekcie MeetMainStageClient, jak i MeetSidePanelClient, a inne są specyficzne dla konkretnego 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 działalności.
  • Metoda getMeetingInfo(), która pobiera szczegóły spotkania, w którym działa dodatek.
  • setActivityStartingState()Metoda, która ustawia początkowy stan dodatku, gdy uczestnik zaakceptuje zaproszenie do udziału w aktywności.
  • Pełna lista funkcji w obu klientach znajduje się w obiekcie MeetAddonClient.

Funkcje związane z klientami

Funkcje dostępne tylko w obiekcie MeetMainStageClient:

  • Metoda notifySidePanel() wysyła wiadomość do panelu bocznego. Aby otrzymywać te wiadomości, zasubskrybuj frameToFrameMessagecallback 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 iframe panelu bocznego. Stan dodatku nie jest zachowywany w Meet, gdy wywoływana jest metoda. Zapisanie stanu dodatku przed wywołaniem tej metody należy do dodatku.

Funkcje dostępne tylko w obiekcie MeetSidePanelClient: