Promuovere un componente aggiuntivo per gli utenti

Gli sviluppatori possono aumentare la rilevabilità dei componenti aggiuntivi promuovendoli tramite la chat durante la chiamata di Meet e la funzionalità di condivisione dello schermo di Meet.

Chat durante la chiamata

I componenti aggiuntivi di Google Meet vengono promossi automaticamente agli utenti nella chat durante la chiamata di Meet quando un messaggio contiene link associati a un componente aggiuntivo. Lo sviluppatore non deve eseguire alcuna azione per promuovere i componenti aggiuntivi nella chat. Il team di revisione determina quali link associare a un componente aggiuntivo in base all'URI del riquadro laterale e alle origini del componente aggiuntivo impostate nel manifest di deployment.

Quando gli utenti inviano un messaggio tramite una chat durante la chiamata associata a un componente aggiuntivo, si verifica una delle due situazioni seguenti:

1. Se il componente aggiuntivo non è installato, una scheda chiede all'utente di installarlo.
2. Se il componente aggiuntivo è già installato, un pulsante ricorda all'utente di aprirlo.

Condivisione 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 exposeToMeetWhenScreensharing() metodo consente al sito di inviare informazioni a Meet quando la sua 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 lo schermo di una scheda, gli viene chiesto di installarlo.

L' AddonScreenshareInfo oggetto 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 accessibile utilizzando ActivityStartingState. Per ulteriori informazioni, vedi Recuperare lo stato di avvio dell'attività.

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

• mainStageUrl: l'URL che la fase principale apre 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 il riquadro laterale apre 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: obbligatorio. Indica se avviare immediatamente l'esperienza del componente aggiuntivo per l'attività in Meet 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: caricare nel riquadro laterale senza avviare un'attività

Nel seguente esempio di codice, un utente condivide lo schermo di una pagina con un componente aggiuntivo 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 di progetto del tuo progetto Cloud.
• SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.

Quando l'utente nella chiamata di Meet condivide lo schermo della pagina, vede un banner della presentazione in Meet. Se fa clic sul pulsante del banner, il componente aggiuntivo viene aperto nel riquadro laterale per il numero di progetto Cloud specificato. Poiché la startActivityOnOpen proprietà è stata impostata su false, il pulsante di avvio dell'attività è disattivato finché non viene impostato ActivityStartingState. Per ulteriori informazioni, vedi Utilizzare lo stato di avvio dell'attività.

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

Il componente aggiuntivo di esempio "Animation" su GitHub include questo esempio come parte di un componente aggiuntivo completo. Quando viene presentata la pagina di indice dell'app web associata al componente aggiuntivo, all'utente che presenta viene chiesto di installare o configurare il componente aggiuntivo.

Esempio: caricare nella fase principale

Nel seguente esempio di codice, a un utente che condivide lo schermo di 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 di progetto del tuo progetto Google Cloud.
• MAIN_STAGE_URL: stringa. L'URL della fase principale.

Quando l'utente nella chiamata di Meet condivide lo schermo della pagina, vede un banner della presentazione in Meet. Se fa clic sul pulsante del banner, il componente aggiuntivo viene aperto nella fase principale per il numero di progetto Cloud specificato. La proprietà mainStageUrl viene caricata e la proprietà additionalData viene utilizzata per impostare lo stato di avvio dell'attività del componente aggiuntivo. Agli altri utenti della chiamata viene immediatamente chiesto di installare o avviare il componente aggiuntivo.

Esempio: caricare nel riquadro laterale

Nel seguente esempio di codice, un utente condivide lo schermo di una pagina con un componente aggiuntivo che deve essere avviato nel riquadro laterale anziché nella fase 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 di progetto del tuo progetto Cloud.
• SIDE_PANEL_URL: stringa. L'URL del riquadro laterale.

Quando l'utente nella chiamata di Meet condivide lo schermo della pagina, vede un banner della presentazione in Meet. Se fa clic sul pulsante del banner, il componente aggiuntivo viene aperto nel riquadro laterale per il numero di progetto Cloud specificato. La proprietà sidePanelUrl viene caricata e la proprietà additionalData viene utilizzata per impostare lo stato di avvio dell'attività del componente aggiuntivo. Agli altri utenti della chiamata viene immediatamente chiesto di installare o avviare il componente aggiuntivo.

Corrispondenza dell'origine

Le origini fornite nella mainStageUrl proprietà e nella sidePanelUrl proprietà 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 dello schermo deve essere elencata nel campo addOnOrigins nel manifest del componente aggiuntivo.

Per ulteriori informazioni, vedi Sicurezza dei componenti aggiuntivi.

Argomenti correlati

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