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 swojego Projekt Google Cloud.
W ramach sesji można utworzyć 2 obiekty klienta:
MeetMainStageClient
dla dodatku uruchomionego w głównej etapie, można pobrać za pomocą parametruawait session.createMainStageClient()
.MeetSidePanelClient
dla dodatku uruchomionego z boku , można pobrać za pomocąawait session.createSidePanelClient()
.
Ważne jest pobranie prawidłowego obiektu klienckiego dla każdego etapu głównego
lub panelu bocznym. Jeśli zostanie pobrany niewłaściwy klient, pakiet SDK Google Meet Add-ons wyrzuci wyjątek. Aby sprawdzić, który element iframe (główna scena lub panel boczny) zawiera element
, użyj
getFrameType()
.
Poniższy przykładowy kod pokazuje, jak utworzyć instancję obiektu klienckiego sceny głównej:
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.
Udostępnione funkcje
Niektóre funkcje są dostępne zarówno w MeetMainStageClient
, jak i w
MeetSidePanelClient
, podczas gdy inne cechy są typowe dla
klienta.
Oto niektóre funkcje dostępne w obu klientach:
getActivityStartingState()
która pobiera informacje o początkowym stanie dodatek po zaakceptowaniu zaproszenia przez uczestnika. aby dołączyć do aktywności.- Metoda
getMeetingInfo()
, która pobiera szczegóły spotkania, w którym działa dodatek. -
setActivityStartingState()
która ustawia początkowy stan dodatku gdy uczestnik zaakceptuje zaproszenie do aktywności. - Pełną listę funkcji obu klientów znajdziesz w
MeetAddonClient
obiektu.
Funkcje specyficzne dla klienta
Funkcje dostępne tylko w obiekcie MeetMainStageClient
:
notifySidePanel()
wysyła komunikat do panelu bocznego. Aby otrzymywać takie wiadomości, zasubskrybujframeToFrameMessage
callback w panelu bocznym.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. To od dodatku zależy, czy przed wywołaniem tej metody.
Funkcje dostępne tylko w obiekcie MeetSidePanelClient
:
notifyMainStage()
wysyła komunikat do mainStage. Wiadomość może zostać odebrana przez zasubskrybowanie wywołania zwrotnegoframeToFrameMessage
na scenie głównej.