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 conawait session.createMainStageClient()
.La
MeetSidePanelClient
per un componente aggiuntivo in esecuzione sul lato , recuperabile conawait 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.