Gestisci gli oggetti client

Questa pagina descrive come gestire gli oggetti client con cui un componente aggiuntivo deve 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:

• Il MeetMainStageClient per un componente aggiuntivo in esecuzione nella fase principale, recuperabile utilizzando await session.createMainStageClient().

• Il MeetSidePanelClient per un componente aggiuntivo in esecuzione nel riquadro laterale, recuperabile utilizzando await session.createSidePanelClient().

È importante recuperare l'oggetto client corretto per la fase principale o il riquadro laterale. Se viene recuperato il client errato, l'SDK dei componenti aggiuntivi di Google Meet genera un'eccezione. Per verificare in quale iframe (fase principale o riquadro laterale) è in esecuzione il componente aggiuntivo, utilizza il getFrameType() metodo.

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 progetto Cloud.

Funzionalità condivise

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

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

• Il getActivityStartingState() metodo che recupera informazioni sullo stato iniziale del componente aggiuntivo quando il partecipante accetta l'invito a partecipare all'attività.
• Il getMeetingInfo() metodo che recupera i dettagli della riunione in cui è in esecuzione il componente aggiuntivo.
• Il setActivityStartingState() metodo 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' MeetAddonClient oggetto.

Funzionalità specifiche del client

Funzionalità disponibili solo nell' MeetMainStageClient oggetto:

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

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

• Il unloadSidePanel() metodo chiude l'iframe del riquadro laterale. Lo stato del componente aggiuntivo non viene mantenuto in Meet quando viene chiamato il metodo. È compito del componente aggiuntivo conservare lo stato del componente aggiuntivo prima che venga chiamato questo metodo.

Funzionalità disponibili solo nell' MeetSidePanelClient oggetto:

• Il notifyMainStage() metodo invia un messaggio a mainStage. Il messaggio può essere ricevuto sottoscrivendo la frameToFrameMessage proprietà di callback in mainStage.