Promouvoir un module complémentaire auprès des utilisateurs via le partage d'écran

Promouvoir un module complémentaire via l'écran le partage.

Cette page explique comment promouvoir un module complémentaire auprès des utilisateurs lorsque vous partagez un onglet avec Google Meet en insérant une petite quantité de code sur une autre page Web.

La exposeToMeetWhenScreensharing() permet au site d'envoyer des informations à Meet lorsque son onglet est partagé sur l'écran. Ces informations sont utilisées dans l'expérience du module complémentaire avec Meet lorsque l'utilisateur clique sur "Démarrer l'activité" sur la bannière de présentation s'il a installé le module complémentaire. Si l'utilisateur ne dispose pas lorsqu'ils partagent un onglet, ils sont invité à installer le module complémentaire.

La AddonScreenshareInfo contient cinq propriétés qui peuvent être ajoutées en fonction du cas d'utilisation:

  • additionalData: Infos que le module complémentaire peut utiliser pour s'initialiser. Boîte ne doit être défini que si la propriété startActivityOnOpen est "true" et peut être accessibles à l'aide du ActivityStartingState Pour en savoir plus, consultez la section Utiliser l'activité l'état.

  • cloudProjectNumber: Obligatoire. Numéro de votre projet Google Cloud.

  • mainStageUrl: URL que l'espace de création principal ouvre une fois le module complémentaire commence, par exemple https://www.example.com. L'URL doit appartenir à la même origine que les URL spécifiées dans le fichier manifeste du module complémentaire.

  • sidePanelUrl: URL que le panneau latéral ouvre une fois le module complémentaire commence, par exemple https://www.example.com. L'URL doit faire partie du même origin comme URL spécifiées dans le le fichier manifeste du module complémentaire.

  • startActivityOnOpen: Obligatoire. Lancer ou non le module complémentaire de l'activité dans Meet dès que l'utilisateur lance la depuis la bannière de la présentation. Doit être vrai si la propriété mainStageUrl est utilisée.

Exemple: chargement dans l'étape principale

Dans l'exemple de code suivant, un utilisateur qui utilise un écran partage une page Web dans Meet contenant le code suivant est invité à lancer le module complémentaire:

<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>

Remplacez les éléments suivants :

  • CLOUD_PROJECT_NUMBER: chaîne. Le numéro de votre projet projet Google Cloud.
  • MAIN_STAGE_URL : chaîne. URL de l'étape principale.

Lorsque l'utilisateur partage la page depuis l'écran d'appel Meet, il voit un une bannière de présentation dans Meet. Cliquer sur le bouton de la bannière ouvre le module complémentaire pour le numéro de projet Cloud donné dans sur la scène principale. La propriété mainStageUrl est chargée, et La propriété additionalData permet de définir le début de l'activité l'état du module complémentaire. Les autres participants à l'appel sont immédiatement invité à installer ou à lancer le module complémentaire.

Exemple : Chargement dans le panneau latéral

Dans l'exemple de code suivant, un utilisateur partage une page avec un qui doit commencer dans le panneau latéral que l'étape 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>

Remplacez les éléments suivants :

  • CLOUD_PROJECT_NUMBER : chaîne. Le numéro de votre projet Google Cloud.
  • SIDE_PANEL_URL: chaîne. URL du panneau latéral.

Lorsque l'utilisateur partage la page depuis l'écran d'appel Meet, il voit un une bannière de présentation dans Meet. Cliquer sur le bouton de la bannière ouvre le module complémentaire pour le numéro de projet Cloud donné dans le panneau latéral. La propriété sidePanelUrl est chargée, et La propriété additionalData permet de définir le début de l'activité l'état du module complémentaire. Les autres participants à l'appel sont immédiatement invité à installer ou à lancer le module complémentaire.

Exemple: Charger dans le panneau latéral sans démarrer d'activité

Dans l'exemple de code suivant, un utilisateur partage une page avec un qui doit ajuster les autorisations liées aux ressources peut démarrer. Du fait de cette exigence, le doit être démarré dans le panneau latéral, sans le d'activité est lancée pour tout le monde.

<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>

Remplacez les éléments suivants :

  • CLOUD_PROJECT_NUMBER : chaîne. Le numéro de votre projet Google Cloud.
  • SIDE_PANEL_URL: chaîne. URL du panneau latéral.

Lorsque l'utilisateur partage la page depuis l'écran d'appel Meet, il voit un une bannière de présentation dans Meet. Cliquer sur le bouton de la bannière ouvre le module complémentaire pour le numéro de projet Cloud donné dans le panneau latéral. Depuis le startActivityOnOpen a été définie sur "false", le bouton "Démarrer l'activité" est désactivé jusqu'à ce que ActivityStartingState est défini. Pour en savoir plus, consultez la section Utiliser l'état de démarrage de l'activité.

Une fois l'activité démarrée, les autres participants à l'appel sont invités à effectuer l'une des actions suivantes : lancer ou installer le module complémentaire.

Mise en correspondance des origines

Les origines fournies dans la propriété mainStageUrl et la propriété sidePanelUrl sont comparées aux origines du fichier manifeste du module complémentaire du numéro de projet Cloud fourni. Si tout correspond, l’utilisateur est autorisé à lancer le module complémentaire.

En outre, l'origine du site à l'origine du partage d'écran doit être indiquée. dans le champ addOnOrigins du module complémentaire. le fichier manifeste.

Pour en savoir plus, consultez la section Module complémentaire sécurité.