Promuovere un componente aggiuntivo agli utenti tramite la condivisione schermo

Promozione di un componente aggiuntivo tramite lo schermo condivisione.

In questa pagina viene descritto come promuovere un componente aggiuntivo agli utenti mentre condividete una scheda con Google Meet inserendo una piccola quantità di codice su un'altra pagina web.

La MeetAddonScreenshare.exposeToMeetWhenScreensharing consente al sito di inviare informazioni a Meet quando la relativa scheda è condivisa sullo schermo. Queste informazioni vengono utilizzate il componente aggiuntivo di Meet quando l'utente fa clic su "Inizia attività" sul banner della presentazione se hanno installato. Se l'utente non ha installato quando condividono lo schermo di una scheda, viene richiesto di installare il componente aggiuntivo.

La AddonScreenshareInfo contiene cinque campi che possono essere aggiunti in base al caso d'uso:

Esempio: carica nella schermata principale

Nel seguente esempio di codice, un utente che condivide lo schermo in Meet contenente il codice seguente viene chiesto di avviare l'app 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 una presentazione in Meet. Facendo clic sul pulsante nel banner apre il componente aggiuntivo per il numero di progetto Cloud specificato sullo schermo principale. L'elemento AddonScreenshareInfo.mainStageUrl è stato caricato e AddonScreenshareInfo.additionalData viene utilizzato per impostare l'inizio della collaborazione lo stato del componente aggiuntivo. Gli altri utenti che partecipano alla chiamata viene subito chiesto 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 che desidera iniziare dal riquadro laterale rispetto a quella 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 una presentazione in Meet. Facendo clic sul pulsante del banner apre il componente aggiuntivo per il numero di progetto Cloud specificato nel riquadro laterale. L'elemento AddonScreenshareInfo.sidePanelUrl è stato caricato e AddonScreenshareInfo.additionalData viene utilizzato per impostare l'inizio della collaborazione lo stato del componente aggiuntivo. Gli altri utenti che partecipano alla chiamata viene subito chiesto 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 che deve regolare le autorizzazioni delle risorse prima che attività di collaborazione. A causa di questo requisito, deve essere avviato nel riquadro laterale, senza la collaborazione 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 una presentazione in Meet. Facendo clic sul pulsante del banner apre il componente aggiuntivo per il numero di progetto Cloud specificato nel riquadro laterale. Dal giorno AddonScreenshareInfo.startActivityOnOpen è stato impostato su false, il pulsante di avvio dell'attività viene disattivato fino CollaborationStartingState impostato. Per ulteriori informazioni, consulta Utilizzare il avvio della collaborazione .

Una volta avviata l'attività, agli 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 del componente aggiuntivo del numero di progetto cloud fornito. Se tutto corrisponde, l'utente può avviare il componente aggiuntivo.

Devi inoltre indicare l'origine del sito che avvia la condivisione schermo nel campo addOnOrigins nel componente aggiuntivo del file manifest.

Per ulteriori informazioni, consulta la sezione Componenti aggiuntivi sicurezza.