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 iniziale della collaborazione

Alla prima apertura di un componente aggiuntivo, l'iframe del riquadro laterale carica l'URL specificato nel manifest del componente aggiuntivo. Questo stato iniziale potrebbe essere diverso da quello iniziale che il componente aggiuntivo vuole utilizzare quando gli utenti entrano a far parte dell'invito alla collaborazione. Puoi utilizzare CollaborationStartingState per specificare gli URL iframe che devono essere caricati 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 necessari per l'inizializzazione.

Imposta, recupera e cancella lo stato iniziale della collaborazione

Puoi gestire CollaborationStartingState con i seguenti metodi.

Imposta CollaborationStartingState utilizzando il metodo MeetAddonClient.setCollaborationStartingState.

Gli URL specificati nel metodo MeetAddonClient.setCollaborationStartingState devono appartenere alla stessa origin delle origini specificate nel file manifest del componente aggiuntivo. Per maggiori informazioni, consulta Sicurezza dei componenti aggiuntivi.

Le lunghezze di sidePanelUrl, mainStageUrl e additionalData devono essere conformi ai rispettivi limiti di dimensione 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();