Zarządzaj obiektami klientów

Na tej stronie dowiesz się, jak zarządzać obiektami klienta, które dodatek musi komunikować 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 etapu głównego, 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ć odpowiedni obiekt klienta na potrzeby głównego etapu lub panelu bocznego. Jeśli zostanie pobrany niewłaściwy klient, pakiet SDK Google Meet Add-ons 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 niektóre funkcje dostępne w obu wersjach klientów:

• Metoda getActivityStartingState(), która pobiera informacje o początkowym stanie dodatku, gdy uczestnik zaakceptuje zaproszenie do dołączenia do aktywności.
• Metoda getMeetingInfo() pobierająca szczegółowe informacje o spotkaniu, 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łną listę funkcji obu klientów znajdziesz w opisie obiektu 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 element iframe panelu bocznego. Stan dodatku nie jest zachowywany w Meet, gdy wywoływana jest metoda. To od dodatku zależy, czy zachowa on każdy stan dodatku przed wywołaniem tej metody.

Funkcje dostępne tylko w obiekcie MeetSidePanelClient:

• Metoda notifyMainStage() wysyła komunikat do mainStage. Aby otrzymywać takie wiadomości, zasubskrybuj w mainstage usługę frameToFrameMessage callback property.