Promuovere un componente aggiuntivo agli utenti tramite la condivisione schermo

Promozione di un componente aggiuntivo tramite la condivisione dello schermo.

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 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 il componente aggiuntivo quando condivide lo schermo di una scheda, gli viene chiesto di installarlo.

L'oggetto AddonScreenshareInfo contiene cinque proprietà che possono essere aggiunte in base al caso d'uso:

  • additionalData: Informazioni che il componente aggiuntivo può utilizzare per inizializzarsi. Può essere impostata solo se la proprietà startActivityOnOpen è true e può essere acceduta utilizzando ActivityStartingState. Per ulteriori informazioni, consulta Utilizzare l'attività a partire da .

  • cloudProjectNumber: Obbligatorio. Il numero del tuo progetto Google Cloud.

  • mainStageUrl: L'URL che apre la fase principale dopo il componente aggiuntivo come https://www.example.com. L'URL deve appartenere allo stesso origin come URL specificati in del componente aggiuntivo.

  • sidePanelUrl: L'URL che viene aperto dal riquadro laterale una volta che il componente aggiuntivo come https://www.example.com. L'URL deve appartenere allo stesso origin come URL specificati in del componente aggiuntivo.

  • startActivityOnOpen: obbligatoria. Indica se avviare il componente aggiuntivo dell'attività in Meet non appena l'utente avvia la dal banner della presentazione. Deve essere vero se viene utilizzata la proprietà mainStageUrl.

di Gemini Advanced.

Esempio: carica nella schermata principale

Nel seguente esempio di codice, a un utente che condivide una pagina web in Meet contenente il seguente codice viene chiesto di avviare il componente aggiuntivo:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 progetto Google 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. La proprietà mainStageUrl viene caricata e la proprietà additionalData viene utilizzata per impostare lo stato iniziale dell'attività 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/1.0.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 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. Se fai clic sul pulsante nel banner, viene aperto il componente aggiuntivo per il numero del progetto cloud specificato nel riquadro laterale. La proprietà sidePanelUrl viene caricata La proprietà additionalData viene utilizzata per impostare l'inizio dell'attività 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 un'attività

Nel seguente esempio di codice, la schermata di un utente condivide una pagina con che deve regolare le autorizzazioni delle risorse prima che l'attività può essere avviata. A causa di questo requisito, deve essere avviato nel riquadro laterale, senza avviare attività per tutti.

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 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 nel banner apre il componente aggiuntivo per il numero di progetto Cloud specificato nel riquadro laterale. Poiché il startActivityOnOpen è stata impostata su false, il pulsante di avvio dell'attività viene disattivato finché ActivityStartingState impostato. Per ulteriori informazioni, vedi Utilizzare l'attività stato iniziale.

Una volta avviata l'attività, agli altri utenti della chiamata viene chiesto di avviare o installare il componente aggiuntivo.

Corrispondenza origine

Le origini fornite nel mainStageUrl: e la proprietà 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.