Utilizza lo stato iniziale della collaborazione

In questa pagina viene descritto lo scopo di 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 del riquadro laterale carica l'URL specificato nel file manifest del componente aggiuntivo. Questo stato iniziale potrebbe essere diverso da quello iniziale che il componente aggiuntivo vuole utilizzare quando gli utenti partecipano utilizzando l'invito alla collaborazione. 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 tutti i dati di cui potrebbe essere necessario 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 devono appartenere alla stessa origine delle origini specificate nel manifest del componente aggiuntivo. Per maggiori informazioni, consulta Sicurezza dei componenti aggiuntivi.

Le lunghezze di caratteri di CollaborationStartingState.sidePanelUrl, CollaborationStartingState.mainStageUrl e CollaborationStartingState.additionalData devono essere conformi ai rispettivi limiti di dimensione così come pubblicati nella documentazione di riferimento dell'SDK.

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

Ottieni CollaborationStartingState con il metodo MeetAddonClient.getCollaborationStartingState.

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

Cancella CollaborationStartingState, con il metodo MeetAddonClient.clearCollaborationStartingState.

    mainStageClient.clearCollaborationStartingState();