Utilizza lo stato iniziale della collaborazione

In questa pagina viene descritto lo scopo dei CollaborationStartingState e come impostarlo e recuperarlo dall'SDK dei componenti aggiuntivi di Google Meet.

Panoramica dello stato di inizio della collaborazione

Alla prima apertura di un componente aggiuntivo, L'iframe side-panel carica l'URL specificato nel componente aggiuntivo file manifest. Questa iniziale potrebbe essere diverso da quello iniziale, in cui vuole usare il componente aggiuntivo invito a una collaborazione. La CollaborationStartingState può essere utilizzato per specificare gli URL iframe da caricare quando gli utenti partecipano utilizzando l'invito alla collaborazione. Inoltre, il campo additional_data può essere utilizzato dal componente aggiuntivo per archiviare i dati di cui potrebbe aver bisogno per la sua inizializzazione.

Imposta, ottieni e cancella lo stato iniziale della collaborazione

Puoi gestire CollaborationStartingState con i seguenti metodi.

Imposta CollaborationStartingState utilizzando il metodo MeetAddonClient.setCollaborationStartingState . Il componente aggiuntivo può impostare CollaborationStartingState in qualsiasi momento prima o durante la collaborazione.

Gli URL specificati nel metodo MeetAddonClient.setCollaborationStartingState deve appartenere alla stessa origine del specificate nel manifest del componente aggiuntivo. Per ulteriori informazioni, vedi Componente aggiuntivo sicurezza.

La CollaborationStartingState.sidePanelUrl, CollaborationStartingState.mainStageUrl, e CollaborationStartingState.additionalData caratteri devono essere conformi ai rispettivi limiti di dimensione così come pubblicati in documenti di riferimento sull'SDK.

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

Ricevi CollaborationStartingState, con MeetAddonClient.getCollaborationStartingState .

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

Cancella CollaborationStartingState, con MeetAddonClient.clearCollaborationStartingState .

    mainStageClient.clearCollaborationStartingState();