Add-ons über die Bildschirmfreigabe bewerben

Das Bewerben eines Add-ons durch die Bildschirmfreigabe.

Auf dieser Seite wird beschrieben, wie Sie bei der Bildschirmfreigabe eines Tabs mit Google Meet für ein Add-on werben, indem Sie eine kleine Codemenge auf einer anderen Webseite platzieren.

Mit der Methode MeetAddonScreenshare.exposeToMeetWhenScreensharing kann die Website Informationen an Meet senden, wenn der Tab freigegeben ist. 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 das Add-on bei der Bildschirmfreigabe für einen Tab nicht installiert hat, wird er aufgefordert, das Add-on zu installieren.

Das Objekt AddonScreenshareInfo enthält fünf Felder, die je nach Anwendungsfall hinzugefügt werden können:

Beispiel: Im Hauptbereich laden

Im folgenden Codebeispiel wird ein Nutzer, der eine Webseite in Meet mit dem folgenden Code freigibt, aufgefordert, das Add-on zu starten:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 den Hauptbereich.

Wenn der Nutzer im Meet-Anrufbildschirm die Seite teilt, wird in Meet ein Präsentationsbanner angezeigt. Durch Klicken auf die Schaltfläche im Banner wird das Add-on für die angegebene Cloud-Projektnummer im Hauptbereich geöffnet. AddonScreenshareInfo.mainStageUrl wird geladen und AddonScreenshareInfo.additionalData wird verwendet, um den Startstatus der Zusammenarbeit für das Add-on festzulegen. Andere Anrufteilnehmer werden sofort aufgefordert, das Add-on zu installieren oder zu starten.

Beispiel: In Seitenleiste laden

Im folgenden Codebeispiel teilt ein Nutzer eine Seite mit einem Add-on, das in der Seitenleiste und nicht im Hauptbereich beginnen soll:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 im Meet-Anrufbildschirm die Seite teilt, wird in Meet ein Präsentationsbanner angezeigt. Durch Klicken auf die Schaltfläche im Banner wird das Add-on für die angegebene Cloud-Projektnummer in der Seitenleiste geöffnet. AddonScreenshareInfo.sidePanelUrl wird geladen und AddonScreenshareInfo.additionalData wird verwendet, um den Startstatus der Zusammenarbeit für das Add-on festzulegen. Andere Anrufteilnehmer werden sofort aufgefordert, das Add-on zu installieren oder zu starten.

Beispiel: In die Seitenleiste laden, ohne eine Gruppenarbeit zu starten

Im folgenden Codebeispiel teilt ein Nutzerbildschirm eine Seite mit einem Add-on, das die Ressourcenberechtigungen anpassen muss, bevor die Zusammenarbeitsaktivität gestartet werden kann. Aus diesem Grund sollte das Add-on in der Seitenleiste gestartet werden, ohne dass die Zusammenarbeit für alle Nutzer gestartet wird.

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 im Meet-Anrufbildschirm die Seite teilt, wird in Meet ein Präsentationsbanner angezeigt. Durch Klicken auf die Schaltfläche im Banner wird das Add-on für die angegebene Cloud-Projektnummer in der Seitenleiste geöffnet. Da AddonScreenshareInfo.startActivityOnOpen auf „false“ gesetzt wurde, 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 die anderen Anrufteilnehmer 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, über die die Bildschirmfreigabe initiiert wird, im Add-on-Manifest im Feld addOnOrigins angegeben werden.

Weitere Informationen finden Sie unter Add-on-Sicherheit.