Promuovere un componente aggiuntivo agli utenti tramite la condivisione schermo

Promuovere un componente aggiuntivo tramite la condivisione schermo.

In questa pagina viene descritto come promuovere un componente aggiuntivo per gli utenti durante la condivisione 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 scheda è 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 installarlo.

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

Esempio: caricamento nella fase principale

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

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 della fase principale.

Quando l'utente condivide la pagina nella schermata della chiamata di Meet, vede un banner di presentazione in Meet. Se fai clic sul pulsante nel banner, nella fase principale si apre il componente aggiuntivo per il numero di progetto cloud specificato. Il AddonScreenshareInfo.mainStageUrl viene caricato e il AddonScreenshareInfo.additionalData viene utilizzato per impostare lo stato iniziale della collaborazione del componente aggiuntivo. Agli altri utenti della chiamata viene subito chiesto di installare o avviare il componente aggiuntivo.

Esempio: caricamento nel riquadro laterale

Nel seguente esempio di codice, la schermata di un utente condivide una pagina con un componente aggiuntivo che vuole iniziare nel riquadro laterale anziché nella fase principale:

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 condivide la pagina nella schermata della chiamata di Meet, vede un banner di presentazione in Meet. Se fai clic sul pulsante nel banner, si apre il componente aggiuntivo per il numero di progetto Cloud specificato nel riquadro laterale. Il AddonScreenshareInfo.sidePanelUrl viene caricato e il AddonScreenshareInfo.additionalData viene utilizzato per impostare lo stato iniziale della collaborazione del componente aggiuntivo. Agli altri utenti della 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 un componente aggiuntivo che deve regolare le autorizzazioni delle risorse prima che sia possibile avviare l'attività di collaborazione. A causa di questo requisito, il componente aggiuntivo deve essere avviato nel riquadro laterale, senza avviare la collaborazione per tutti.

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 condivide la pagina nella schermata della chiamata di Meet, vede un banner di presentazione in Meet. Se fai clic sul pulsante nel banner, si apre il componente aggiuntivo per il numero di progetto Cloud specificato nel riquadro laterale. Poiché AddonScreenshareInfo.startActivityOnOpen è stato impostato su false, il pulsante Avvia attività è disattivato fino all'impostazione di CollaborationStartingState. Per ulteriori informazioni, consulta Utilizzare lo stato di avvio della collaborazione.

Una volta avviata l'attività, agli altri utenti della chiamata verrà 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 file 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 ulteriori informazioni, consulta Sicurezza dei componenti aggiuntivi.