Promuovere un componente aggiuntivo agli utenti tramite la condivisione schermo

La promozione di un componente aggiuntivo tramite la condivisione dello schermo.

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:

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.