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 la fase principale o nel riquadro laterale. Se viene recuperato il client sbagliato, l'SDK dei componenti aggiuntivi di Google Meet restituisce 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 in MeetMainStageClient che in MeetSidePanelClient, mentre altre caratteristiche sono specifiche di un di alto profilo.

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

  • La getActivityStartingState() che ottiene informazioni sullo stato iniziale del componente aggiuntivo quando il partecipante accetta l'invito per 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 del client

Funzionalità disponibili solo in MeetMainStageClient :

  • La notifySidePanel() invia un messaggio al riquadro laterale. Il messaggio può essere ricevuto Iscrizione al frameToFrameMessage callback nel riquadro laterale.

  • Il metodo loadSidePanel() apre l'iframe del riquadro laterale. L'origine dell'iframe è impostata nel formato del riquadro laterale dal 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. Sta al componente aggiuntivo mantenere del componente aggiuntivo prima che questo metodo venga chiamato.

Funzionalità disponibili solo in MeetSidePanelClient :