Collaborare utilizzando un componente aggiuntivo di Meet

I partecipanti a una riunione possono collaborare a un'attività del componente aggiuntivo di Google Meet. Quando inizia un'attività collaborativa, tutti i partecipanti alla riunione ricevono una notifica che li informa che l'attività è in corso.

Questa notifica è adattata alla disponibilità e allo stato di installazione del componente aggiuntivo:

  • Se il partecipante ha installato il componente aggiuntivo: Può partecipare all'attività.

  • Se il partecipante non ha installato il componente aggiuntivo: gli viene chiesto di installarlo.

  • Se il componente aggiuntivo non è disponibile per la piattaforma del partecipante: viene informato che non può partecipare all'attività utilizzando il dispositivo attuale.

Quando un utente partecipa all'attività, carica i propri iframe con i contenuti del componente aggiuntivo. Puoi personalizzare se i nuovi partecipanti devono aprire l'attività collaborativa nella schermata principale o nel riquadro laterale.

Avvia l'attività

Un'attività viene avviata chiamando il metodo startActivity(), che utilizza l'interfaccia ActivityStartingState.

(Facoltativo) Passaggio 1: il componente aggiuntivo imposta lo stato iniziale dell'attività

ActivityStartingState contiene informazioni sullo stato iniziale del componente aggiuntivo utilizzato quando il partecipante accetta l'invito a partecipare all'attività.

Il componente aggiuntivo può impostare o aggiornare ActivityStartingState chiamando il metodo setActivityStartingState() in qualsiasi momento prima o durante l'attività. Le chiamate a setActivityStartingState() possono essere omesse se ActivityStartingState è impostato esclusivamente nella chiamata a startActivity().

Passaggio 2: il componente aggiuntivo avvia l'attività

L'attività inizia quando il componente aggiuntivo chiama il metodo startActivity() su MeetSidePanelClient. Il metodo startActivity() accetta un oggetto ActivityStartingState come parametro, quindi è possibile chiamare startActivity() anziché setActivityStartingState().

Una volta che l'utente ha completato la selezione dei contenuti ed è pronto per iniziare un'attività, chiama il metodo startActivity() nel tuo componente aggiuntivo come segue:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

Quando viene richiamato il metodo startActivity(), Meet esegue le seguenti azioni:

  • Per gli altri partecipanti: Meet mostra una notifica che indica che l'attività è in corso.

  • Per l'organizzatore: se è stato specificato un URL del palco principale in ActivityStartingState, Meet apre il palco principale utilizzando l'URL di ActivityStartingState.

Passaggio 3: ottieni lo stato iniziale dell'attività

Quando un utente partecipa all'attività, carica il componente aggiuntivo nella fase principale o nel riquadro laterale a seconda di ActivityStartingState.

Con la proprietà additionalData, puoi condividere i dati iniziali (chiamati anche stato) con gli utenti che partecipano all'attività. Dopo aver inizializzato un MainStageClient o un SidePanelClient, puoi chiamare il metodo getActivityStartingState() per recuperare la proprietà additionalData.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

Passaggio 4 (facoltativo): condividi lo stato del componente aggiuntivo in un'attività

Puoi anche condividere lo stato tra gli utenti mentre l'attività è in corso. Puoi condividere lo stato in due modi:

  • Gestiscilo autonomamente creando il tuo backend di sincronizzazione.
  • Utilizza l'API Co-Doing, che è un modo comodo e veloce per condividere dati arbitrari tra gli utenti.

Esempio: componente aggiuntivo Animazione su GitHub

Il componente aggiuntivo di esempio"Animazione" su GitHub include la collaborazione in un componente aggiuntivo. Il passaggio 1 di questa guida non è incluso nel campione. Invece, quando l'iniziatore del componente aggiuntivo fa clic sul pulsante "Avvia l'animazione" nel riquadro laterale, viene chiamato il metodo startActivity() (passaggio 2) compilando lo stato iniziale con il colore selezionato dall'utente. Dopo l'avvio dell'attività, il palco principale recupera lo stato iniziale chiamando il metodo getActivityStartingState() (passaggio 3). Il passaggio 4 viene omesso perché lo stato (il colore selezionato) non viene condiviso tra i partecipanti durante l'attività in questo componente aggiuntivo di esempio. I singoli utenti possono, tuttavia, modificare il proprio stato selezionando un colore, che viene inviato dal frame del riquadro laterale al frame del palco principale utilizzando la messaggistica da frame a frame.

Vincoli