Promuovere un componente aggiuntivo agli utenti tramite la condivisione schermo

Questa pagina descrive come promuovere un componente aggiuntivo agli utenti mentre condividi una scheda con Google Meet inserendo una piccola quantità di codice su un'altra pagina web.

Il metodo 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 con Meet quando l'utente fa clic su "Avvia attività" nel banner della presentazione se ha installato il componente aggiuntivo. Se l'utente non ha installato il componente aggiuntivo quando condivide 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 maggiori informazioni, consulta la sezione Ottenere lo stato di avvio dell'attività.

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

• mainStageUrl: l'URL che apre la fase principale all'avvio del componente aggiuntivo, ad esempio https://www.example.com. L'URL deve appartenere alla stessa origine degli URL specificati nel manifest del componente aggiuntivo.

• sidePanelUrl: l'URL che viene aperto dal riquadro laterale all'avvio del componente aggiuntivo, ad esempio https://www.example.com. L'URL deve appartenere alla stessa origine degli URL specificati nel manifest del componente aggiuntivo.

• startActivityOnOpen: obbligatoria. Indica se avviare l'esperienza del componente aggiuntivo dell'attività in Meet immediatamente quando l'utente avvia il componente aggiuntivo dal banner della presentazione. Deve essere true se viene utilizzata la proprietà mainStageUrl.

Installare e importare l'SDK

Puoi accedere all'SDK utilizzando npm o gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Esempio: caricamento nel riquadro laterale senza avviare un'attività

Nel seguente codice di esempio, una schermata utente condivide una pagina con un plug-in che deve modificare le autorizzazioni delle risorse prima che l'attività possa essere avviata. A causa di questo requisito, il componente aggiuntivo deve essere avviato nel riquadro laterale senza che l'attività venga avviata per tutti.

<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 progetto Cloud.
• SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.

Quando l'utente nella schermata della chiamata di Meet condivide la pagina, visualizza un banner della 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. Poiché la proprietà startActivityOnOpen è stata impostata su false, il pulsante Avvia attività è disattivato finché non viene impostato ActivityStartingState. Per ulteriori informazioni, consulta Utilizzare lo stato iniziale dell'attività.

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

L'add-on di esempio "Animazione" su GitHub include questo esempio come parte di un add-on completo. Quando viene visualizzata la pagina di indice dell'app web associata al componente aggiuntivo, all'utente presentatore viene chiesto di installare o configurare il componente aggiuntivo.

Esempio: caricamento 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>
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 della fase principale.

Quando l'utente nella schermata della chiamata di Meet condivide la pagina, visualizza un banner della 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. La proprietà mainStageUrl viene caricata e la proprietà additionalData viene utilizzata per impostare lo stato di inizio dell'attività 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 dal riquadro laterale anziché dalla schermata principale:

<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 progetto Cloud.
• SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.

Quando l'utente nella schermata della chiamata di Meet condivide la pagina, visualizza un banner della 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. La proprietà sidePanelUrl viene caricata e la proprietà additionalData viene utilizzata per impostare lo stato iniziale dell'attività del componente aggiuntivo. Agli altri utenti della chiamata viene chiesto immediatamente di installare o avviare il componente aggiuntivo.

Corrispondenza origine

Le origini fornite nella proprietà mainStageUrl e nella proprietà sidePanelUrl vengono confrontate con le origini nel manifest del componente aggiuntivo del numero del 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.

Argomenti correlati

• Collaborare utilizzando un componente aggiuntivo di Meet
• Sicurezza dei componenti aggiuntivi