Gestisci gli oggetti client

Questa pagina descrive come gestire gli oggetti client di cui un plug-in ha bisogno per comunicare con Google Meet.

Innanzitutto, il componente aggiuntivo deve stabilire una sessione:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

Sostituisci CLOUD_PROJECT_NUMBER con il numero del progetto Google Cloud.

Dalla sessione è possibile creare due oggetti client:

È importante recuperare l'oggetto client corretto per il livello principale o per il riquadro laterale. Se viene recuperato il client sbagliato, l'SDK dei componenti aggiuntivi di Google Meet genera un'eccezione. Per controllare in quale iframe (area principale o riquadro laterale) è in esecuzione il plug-in, utilizza il metodo getFrameType().

Il seguente esempio di codice mostra come creare un'istanza dell'oggetto client della fase principale:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Sostituisci CLOUD_PROJECT_NUMBER con il numero del tuo progetto Cloud.

Funzionalità condivise

Alcune funzionalità sono disponibili sia nell'oggetto MeetMainStageClient sia nell'oggetto MeetSidePanelClient, mentre altre sono specifiche di un determinato client.

Ad esempio, alcune funzionalità disponibili in entrambi i client includono:

  • Il metodo getActivityStartingState() che recupera le informazioni sullo stato iniziale del plug-in quando il partecipante accetta l'invito a partecipare all'attività.
  • Il metodo getMeetingInfo() che recupera i dettagli sulla riunione in cui è in esecuzione il plug-in.
  • Il metodo setActivityStartingState() che imposta lo stato iniziale del componente aggiuntivo quando il partecipante accetta l'invito a partecipare all'attività.
  • Per un elenco completo delle funzionalità di entrambi i client, consulta l'oggetto MeetAddonClient.

Funzionalità specifiche per cliente

Funzionalità disponibili solo nell'oggetto MeetMainStageClient:

  • Il metodo notifySidePanel() invia un messaggio al riquadro laterale. Il messaggio può essere ricevuto sottoscrivendo il frameToFrameMessage callback nel riquadro laterale.

  • Il metodo loadSidePanel() apre l'iframe del riquadro laterale. L'origine dell'iframe è impostata sull'URL del riquadro laterale del file manifest.

  • Il metodo unloadSidePanel() chiude l'iframe del riquadro laterale. Lo stato del componente aggiuntivo non viene mantenuto in Meet quando viene chiamato il metodo. Spetta al componente aggiuntivo mantenere costante qualsiasi stato del componente aggiuntivo prima che venga chiamato questo metodo.

Funzionalità disponibili solo nell'oggetto MeetSidePanelClient: