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 duActivityStartingState
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 exemplehttps://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 exemplehttps://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é.