Pobieranie obiektu klienta

Wersja przedpremierowa dla programistów: dostępna w ramach Programu podglądu Google Workspace dla programistów, który zapewnia wcześniejszy dostęp do niektórych funkcji.

Na tej stronie dowiesz się, jak uzyskać obiekt kliencki, którego dodatek potrzebuje, aby komunikować się z Google Meet.

Najpierw dodatek musi ustanowić sesję:

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

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

• MeetMainStageClient dla dodatku uruchomionego w głównej fazie, który można pobrać za pomocą await session.createMainStageClient().

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

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

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

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

Udostępnione funkcje

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

Na przykład niektóre funkcje dostępne w obu klientach obejmują:

• Metoda MeetAddonClient.getCollaborationStartingState, która uzyskuje informacje o początkowym stanie dodatku po zaakceptowaniu przez uczestnika zaproszenia do współpracy.
• Metoda MeetAddonClient.getMeetingInfo, która uzyskuje szczegółowe informacje o spotkaniu, na którym jest uruchomiony dodatek.
• Metoda MeetAddonClient.getMeetPlatformInfo, która uzyskuje szczegółowe informacje o platformie spotkań, na której działa dodatek.
• MeetAddonClient.setCollaborationStartingState, który określa początkowy stan dodatku po zaakceptowaniu zaproszenia do współpracy przez uczestnika.
• Pełną listę funkcji obu klientów znajdziesz w obiekcie MeetAddonClient.

Funkcje dostosowane do potrzeb klienta

Funkcje dostępne tylko w MeetMainStageClient:

• MeetMainStageClient.notifySidePanel wyśle wiadomość do panelu bocznego. Wiadomość można odebrać, subskrybując wywołanie zwrotneframeToFrameMessage w panelu bocznym.

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

• Metoda MeetMainStageClient.unloadSidePanel zamyka element iframe panelu bocznego. Stan dodatku nie jest zachowywany w Meet po wywołaniu metody. Zachowywanie stanu dodatku przed wywołaniem tej metody zależy od jego dostępności.

Funkcje dostępne tylko w MeetSidePanelClient:

• MeetSidePanelClient.notifyMainStage wysyła wiadomość do głównego etapu. Wiadomość można odebrać, subskrybując wywołanie zwrotne frameToFrameMessage na etapie głównym.