Recupera l'oggetto client

Questa pagina descrive come ottenere l'oggetto client che un per comunicare con Google Meet.

Innanzitutto, il componente aggiuntivo deve stabilire una sessione:

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

Dalla sessione è possibile creare due oggetti client:

• La MeetMainStageClient per un componente aggiuntivo in esecuzione nella fase, recuperabile con await session.createMainStageClient().

• La MeetSidePanelClient per un componente aggiuntivo in esecuzione sul lato , recuperabile con await session.createSidePanelClient().

È 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 verificare quale iframe (schermo principale o riquadro laterale) è in esecuzione, utilizza MeetAddon.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();

Funzionalità condivisa

Alcune funzionalità sono disponibili sia in MeetMainStageClient che in MeetSidePanelClient, mentre altre funzionalità sono specifiche per un determinato di alto profilo.

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

• La MeetAddonClient.getCollaborationStartingState che ottiene informazioni sullo stato iniziale del componente aggiuntivo quando il partecipante accetta l'invito per collaborare.
• La MeetAddonClient.getMeetingInfo che ottiene i dettagli della riunione in cui è in esecuzione.
• La MeetAddonClient.getMeetPlatformInfo che ottiene i dettagli sulla piattaforma delle riunioni su cui è in esecuzione.
• La MeetAddonClient.setCollaborationStartingState che imposta lo stato iniziale del componente aggiuntivo quando il partecipante accetta l'invito a collaborare.
• Per un elenco completo delle funzionalità di entrambi i client, consulta MeetAddonClient .

Funzionalità specifiche del client

Funzionalità disponibile solo in MeetMainStageClient:

• La MeetMainStageClient.notifySidePanel invia un messaggio al riquadro laterale. Il messaggio può essere ricevuto iscrivendoti a frameToFrameMessage callback nel riquadro laterale.

• La MeetMainStageClient.loadSidePanel apre l'iframe del riquadro laterale. L'origine dell'iframe è impostata nel formato del riquadro laterale dal file manifest.

• La MeetMainStageClient.unloadSidePanel chiude l'iframe del riquadro laterale. Il componente aggiuntivo non viene conservato in Meet quando il metodo viene chiamato. Sta al componente aggiuntivo mantenere del componente aggiuntivo prima che questo metodo venga chiamato.

Funzionalità disponibile solo in MeetSidePanelClient:

• La MeetSidePanelClient.notifyMainStage e invia un messaggio a mainStage. Il messaggio può essere ricevuto iscrivendoti al frameToFrameMessage di Google Cloud nel mainstage.