Auf dieser Seite wird beschrieben, wie Sie Nutzern ein Add-on empfehlen, während Sie einen Tab mit Google Meet freigeben, indem Sie etwas Code auf einer anderen Webseite platzieren.
Mit der Methode MeetAddonScreenshare.exposeToMeetWhenScreensharing kann die Website Informationen an Meet senden, wenn der Tab mit der Bildschirmfreigabe geteilt wird. Diese Informationen werden im Add-on mit Meet verwendet, wenn der Nutzer im Präsentationsbanner auf „Aktivität starten“ klickt, sofern er das Add-on installiert hat. Wenn der Nutzer bei der Bildschirmfreigabe eines Tabs das Add-on nicht installiert hat, wird er aufgefordert, das Add-on zu installieren.
Das AddonScreenshareInfo-Objekt enthält fünf Felder, die je nach Anwendungsfall hinzugefügt werden können:
AddonScreenshareInfo.additionalData: Informationen, die das Add-on zur Initialisierung verwenden kann. Kann nur festgelegt werden, wennAddonScreenshareInfo.startActivityOnOpenauf „true“ gesetzt ist, und kann überCollaborationStartingStateaufgerufen werden. Weitere Informationen finden Sie unter Beginn der Zusammenarbeit verwenden.AddonScreenshareInfo.cloudProjectNumber: Erforderlich. Die Google Cloud-Projektnummer des Add-ons.AddonScreenshareInfo.mainStageUrl: Die URL, die die Hauptphase öffnet, sobald das Add-on gestartet wird, z. B.https://www.example.com. Die URL muss demselben origin zugeordnet sein wie die URLs, die im Add-on-Manifest angegeben sind.AddonScreenshareInfo.sidePanelUrl: Die URL, die nach dem Start des Add-ons in der Seitenleiste geöffnet wird, z. B.https://www.example.com. Die URL muss demselben origin zugeordnet sein wie die URLs, die im Add-on-Manifest angegeben sind.AddonScreenshareInfo.startActivityOnOpen: Erforderlich. Gibt an, ob das Add-on für die Zusammenarbeit in Meet sofort gestartet werden soll, wenn der Nutzer es über das Präsentationsbanner startet. Muss „true“ sein, wennAddonScreenshareInfo.mainStageUrlverwendet wird.
Beispiel: In der Hauptbühne laden
Im folgenden Codebeispiel wird ein Nutzer, der eine Webseite in Meet mit dem folgenden Code freigibt, zum Starten des Add-ons aufgefordert:
<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>
Ersetzen Sie Folgendes:
- CLOUD_PROJECT_NUMBER: String. Die Nummer Ihres Cloud-Projekts.
- MAIN_STAGE_URL: String. Die URL für die Hauptbühne.
Wenn der Nutzer auf dem Meet-Anrufbildschirm die Seite teilt, wird ein Präsentationsbanner in Meet angezeigt. Wenn Sie auf die Schaltfläche im Banner klicken, wird das Add-on für die angegebene Cloud-Projektnummer in der Hauptbühne geöffnet. Das AddonScreenshareInfo.mainStageUrl wird geladen und mit AddonScreenshareInfo.additionalData wird der Startstatus der Zusammenarbeit des Add-ons festgelegt. Andere Anrufteilnehmer werden sofort aufgefordert, das Add-on zu installieren oder zu starten.
Beispiel: In Seitenleiste laden
Im folgenden Codebeispiel teilt ein Nutzerbildschirm eine Seite mit einem Add-on, das in der Seitenleiste und nicht in der Hauptbühne beginnen soll:
<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>
Ersetzen Sie Folgendes:
- CLOUD_PROJECT_NUMBER: String. Die Nummer Ihres Cloud-Projekts.
- SIDE_PANEL_URL: String. Die URL für die Seitenleiste.
Wenn der Nutzer auf dem Meet-Anrufbildschirm die Seite teilt, wird ein Präsentationsbanner in Meet angezeigt. Wenn Sie auf die Schaltfläche im Banner klicken, wird das Add-on für die angegebene Cloud-Projektnummer in der Seitenleiste geöffnet. Das AddonScreenshareInfo.sidePanelUrl wird geladen und mit AddonScreenshareInfo.additionalData wird der Startstatus der Zusammenarbeit des Add-ons festgelegt. Andere Anrufteilnehmer werden sofort aufgefordert, das Add-on zu installieren oder zu starten.
Beispiel: In Seitenleiste laden, ohne eine Zusammenarbeit zu starten
Im folgenden Codebeispiel wird auf einem Nutzerbildschirm eine Seite mit einem Add-on geteilt, das die Ressourcenberechtigungen anpassen muss, bevor die Zusammenarbeitsaktivität gestartet werden kann. Aufgrund dieser Anforderung sollte das Add-on in der Seitenleiste gestartet werden, ohne dass die Zusammenarbeit für alle gestartet wird.
<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>
Ersetzen Sie Folgendes:
- CLOUD_PROJECT_NUMBER: String. Die Nummer Ihres Cloud-Projekts.
- SIDE_PANEL_URL: String. Die URL für die Seitenleiste.
Wenn der Nutzer auf dem Meet-Anrufbildschirm die Seite teilt, wird ein Präsentationsbanner in Meet angezeigt. Wenn Sie auf die Schaltfläche im Banner klicken, wird das Add-on für die angegebene Cloud-Projektnummer in der Seitenleiste geöffnet. Da AddonScreenshareInfo.startActivityOnOpen auf „false“ gesetzt war, ist die Schaltfläche „Aktivität starten“ deaktiviert, bis CollaborationStartingState festgelegt wird. Weitere Informationen finden Sie unter Startstatus der Zusammenarbeit verwenden.
Sobald die Aktivität gestartet wurde, werden andere Nutzer im Anruf aufgefordert, das Add-on zu starten oder zu installieren.
Ursprungsabgleich
Die in AddonScreenshareInfo.mainStageUrl und AddonScreenshareInfo.sidePanelUrl angegebenen Ursprünge werden mit den Ursprüngen im Add-on-Manifest der angegebenen Cloud-Projektnummer verglichen. Wenn alles übereinstimmt, darf der
Nutzer das Add-on starten.
Außerdem muss der Ursprung der Website, die die Bildschirmfreigabe initiiert, im Add-on-Manifest im Feld addOnOrigins angegeben sein.
Weitere Informationen finden Sie unter Add-on-Sicherheit.