Używanie stanu rozpoczęcia współpracy

Na tej stronie opisujemy przeznaczenie CollaborationStartingState oraz sposób jego konfigurowania i pobierania z poziomu pakietu SDK dodatków do Google Meet.

Omówienie stanu rozpoczęcia współpracy

Przy pierwszym otwarciu dodatku element iframe w panelu bocznym wczytuje adres URL podany w pliku manifestu dodatku. Ten stan początkowy może się różnić od stanu początkowego, którego chce używać dodatek, gdy użytkownicy dołączają za pomocą zaproszenia do współpracy. Za pomocą CollaborationStartingState można określić adresy URL elementów iframe, które mają być wczytywane, gdy użytkownicy dołączają za pomocą zaproszenia do współpracy. Dodatek może też wykorzystać pole additional_data do przechowywania danych potrzebnych do inicjowania.

Ustawianie, pobieranie i czyszczenie stanu rozpoczęcia współpracy

Możesz zarządzać domeną CollaborationStartingState za pomocą poniższych metod.

Ustaw CollaborationStartingState za pomocą metody MeetAddonClient.setCollaborationStartingState.

Adresy URL podane w metodzie MeetAddonClient.setCollaborationStartingState muszą należeć do tej samej origin co źródła określone w pliku manifestu dodatku. Więcej informacji znajdziesz w artykule na temat zabezpieczeń dodatków.

Długości sidePanelUrl, mainStageUrl i additionalData muszą być zgodne z limitami rozmiaru podanymi w dokumentacji pakietu SDK.

    mainStageClient.setCollaborationStartingState({
        sidePanelUrl: "https://app.example.com/sidepanel",
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

Pobierz CollaborationStartingState z metodą MeetAddonClient.getCollaborationStartingState.

    const startingState = mainStageClient.getCollaborationStartingState();
    const additionalData = JSON.parse(startingState.additionalData);

Wyczyść CollaborationStartingState za pomocą metody MeetAddonClient.clearCollaborationStartingState.

    mainStageClient.clearCollaborationStartingState();