Questa pagina descrive come promuovere un componente aggiuntivo agli utenti durante la condivisione dello schermo di una scheda con Google Meet inserendo una piccola quantità di codice in un'altra pagina web.
Il metodo MeetAddonScreenshare.exposeToMeetWhenScreensharing
consente al sito di inviare informazioni a Meet quando la relativa scheda viene condivisa sullo schermo. Queste informazioni vengono utilizzate nell'esperienza del componente aggiuntivo di Meet quando l'utente fa clic su "Avvia attività" sul banner della presentazione, se ha installato il componente aggiuntivo. Se l'utente non ha installato il componente aggiuntivo quando condivide lo schermo di una scheda, gli verrà chiesto di installare il componente aggiuntivo.
L'oggetto AddonScreenshareInfo
contiene cinque campi che possono essere aggiunti in base al caso d'uso:
AddonScreenshareInfo.additionalData
: informazioni che il componente aggiuntivo può utilizzare per inizializzarsi. Può essere impostato solo seAddonScreenshareInfo.startActivityOnOpen
è true e può essere accessibile utilizzandoCollaborationStartingState
. Per ulteriori informazioni, consulta Utilizzare lo stato di inizio della collaborazione.AddonScreenshareInfo.cloudProjectNumber
: obbligatorio. Il numero del progetto Google Cloud del componente aggiuntivo.AddonScreenshareInfo.mainStageUrl
: l'URL che apre la fase principale all'avvio del componente aggiuntivo, ad esempiohttps://www.example.com
. L'URL deve appartenere alla stessa origine degli URL specificati nel manifest del componente aggiuntivo.AddonScreenshareInfo.sidePanelUrl
: l'URL che viene aperto dal riquadro laterale all'avvio del componente aggiuntivo, ad esempiohttps://www.example.com
. L'URL deve appartenere alla stessa origine degli URL specificati nel manifest del componente aggiuntivo.AddonScreenshareInfo.startActivityOnOpen
: obbligatorio. Indica se avviare l'esperienza del componente aggiuntivo collaborativo in Meet immediatamente quando l'utente avvia il componente aggiuntivo dal banner della presentazione. Deve essere true se viene utilizzatoAddonScreenshareInfo.mainStageUrl
.
Esempio: carica nella schermata principale
Nel seguente esempio di codice, a un utente che condivide lo schermo in Meet una pagina web contenente il seguente codice viene chiesto di avviare il componente aggiuntivo:
<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
{
cloudProjectNumber: CLOUD_PROJECT_NUMBER,
startActivityOnOpen: true,
mainStageUrl: MAIN_STAGE_URL,
additionalData: "{\"selected_item\": \"42\"}",
}
);
</script>
Sostituisci quanto segue:
- CLOUD_PROJECT_NUMBER: stringa. Il numero del tuo progetto Cloud.
- MAIN_STAGE_URL: stringa. L'URL dello stage principale.
Quando l'utente nella schermata della chiamata di Meet condivide la pagina, vede un
banner di presentazione in Meet. Se fai clic sul pulsante sul banner, si apre il componente aggiuntivo per il numero di progetto Cloud specificato nella schermata principale. Viene caricato AddonScreenshareInfo.mainStageUrl
e viene utilizzato AddonScreenshareInfo.additionalData
per impostare lo stato iniziale della collaborazione del componente aggiuntivo. Agli altri utenti della chiamata viene chiesto immediatamente di installare o avviare il componente aggiuntivo.
Esempio: carica nel riquadro laterale
Nel seguente esempio di codice, la schermata di un utente condivide una pagina con un componente aggiuntivo che vuole iniziare dal riquadro laterale anziché dalla schermata principale:
<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
{
cloudProjectNumber: CLOUD_PROJECT_NUMBER,
startActivityOnOpen: true,
sidePanelUrl: SIDE_PANEL_URL,
additionalData: "{\"selected_item\": \"42\"}",
}
);
</script>
Sostituisci quanto segue:
- CLOUD_PROJECT_NUMBER: stringa. Il numero del tuo progetto Cloud.
- SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.
Quando l'utente nella schermata della chiamata di Meet condivide la pagina, vede un
banner di presentazione in Meet. Se fai clic sul pulsante sul banner, nel riquadro laterale si apre il componente aggiuntivo per il numero di progetto Cloud specificato. Viene caricato AddonScreenshareInfo.sidePanelUrl
e viene utilizzato AddonScreenshareInfo.additionalData
per impostare lo stato iniziale della collaborazione del componente aggiuntivo. Agli altri utenti della chiamata viene chiesto immediatamente di installare o avviare il componente aggiuntivo.
Esempio: carica nel riquadro laterale senza avviare una collaborazione
Nel seguente esempio di codice, la schermata di un utente condivide una pagina con un componente aggiuntivo che deve regolare le autorizzazioni delle risorse prima che l'attività di collaborazione possa essere avviata. A causa di questo requisito, il componente aggiuntivo deve essere avviato nel riquadro laterale senza che la collaborazione venga avviata per tutti.
<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
{
cloudProjectNumber: CLOUD_PROJECT_NUMBER,
startActivityOnOpen: false,
sidePanelUrl: SIDE_PANEL_URL,
}
);
</script>
Sostituisci quanto segue:
- CLOUD_PROJECT_NUMBER: stringa. Il numero del tuo progetto Cloud.
- SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.
Quando l'utente nella schermata della chiamata di Meet condivide la pagina, vede un
banner di presentazione in Meet. Se fai clic sul pulsante sul banner, nel riquadro laterale si apre il componente aggiuntivo per il numero di progetto Cloud specificato. Poiché
AddonScreenshareInfo.startActivityOnOpen
era impostato su false, il pulsante di avvio dell'attività è disabilitato fino a quando
CollaborationStartingState
non viene impostato. Per ulteriori informazioni, consulta Utilizzare lo stato iniziale della collaborazione.
Una volta avviata l'attività, ad altri utenti della chiamata viene chiesto di avviare o installare il componente aggiuntivo.
Corrispondenza origine
Le origini fornite in
AddonScreenshareInfo.mainStageUrl
e
AddonScreenshareInfo.sidePanelUrl
vengono confrontate con le origini nel manifest del componente aggiuntivo
del numero di progetto cloud fornito. Se tutto corrisponde, l'utente può
avviare il componente aggiuntivo.
Inoltre, l'origine del sito che avvia la condivisione schermo deve essere elencata nel campo addOnOrigins
del manifest del componente aggiuntivo.
Per maggiori informazioni, vedi Sicurezza dei componenti aggiuntivi.