Add-ons über die Bildschirmfreigabe bewerben

Auf dieser Seite wird beschrieben, wie Sie Nutzern ein Add-on präsentieren, während Sie einen Tab mit Google Meet teilen. Dazu fügen Sie einen kleinen Code-Snippet auf einer anderen Webseite ein.

Die exposeToMeetWhenScreensharing() ermöglicht es der Website, Informationen an Meet zu senden, wenn der Tab mit der Bildschirmfreigabe geteilt wurde. Diese Informationen werden im Add-on für Meet verwendet, wenn der Nutzer auf dem Präsentationsbanner auf „Aktivität starten“ klickt, sofern das Add-on installiert ist. Wenn die Nutzenden nicht über das das Add-on installiert, wenn sie einen Tab im Bildschirm freigeben, werden sie aufgefordert, das Add-on zu installieren.

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

• additionalData: Informationen, mit denen sich das Add-on initialisieren kann. Kann nur festgelegt werden, wenn die Property startActivityOnOpen auf „wahr“ gesetzt ist und über ActivityStartingState darauf zugegriffen werden kann. Weitere Informationen finden Sie unter Startstatus der Aktivität abrufen.

• cloudProjectNumber: Erforderlich. Die Projektnummer Ihres Google Cloud-Projekts.

• mainStageUrl: Die URL, die die Hauptbühne öffnet, sobald das Add-on gestartet wird, z. B. https://www.example.com. Die URL muss derselben Quelle wie die im Add-on-Manifest angegebenen URLs zugewiesen sein.

• sidePanelUrl: Die URL, über die der Seitenbereich geöffnet wird, sobald das Add-on gestartet wird, z. B. https://www.example.com. Die URL muss zur selben origin als die im Add-on-Manifests.

• startActivityOnOpen: Erforderlich. Ob das Aktivitäts-Add-on in Meet sofort gestartet werden soll, wenn der Nutzer das Add-on über das Präsentationsbanner startet. Muss wahr sein wenn das Attribut mainStageUrl verwendet wird.

SDK installieren und importieren

Sie können mit npm oder mit gstatic auf das SDK zugreifen.

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>

Beispiel: In die Seitenleiste laden, ohne eine Aktivität zu starten

Im folgenden Codebeispiel wird auf einem Nutzerbildschirm eine Seite mit einem Add-on geteilt, für das die Ressourcenberechtigungen angepasst werden müssen, bevor die Aktivität gestartet werden kann. Aufgrund dieser Anforderung sollte in der Seitenleiste ohne das Symbol die für alle gestartet wird.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Ersetzen Sie Folgendes:

• CLOUD_PROJECT_NUMBER: String. Die Projektnummer Ihres Cloud-Projekts.
• SIDE_PANEL_URL: String. Die URL für die Seitenleiste.

Wenn der Nutzer die Seite auf dem Meet-Anrufbildschirm freigibt, wird in Meet ein Präsentationsbanner angezeigt. Durch Klicken auf die Schaltfläche im Banner öffnet das Add-on für die angegebene Cloud-Projektnummer in in der Seitenleiste. Da die Property startActivityOnOpen auf „falsch“ gesetzt wurde, ist die Schaltfläche zum Starten der Aktivität deaktiviert, bis ActivityStartingState festgelegt wurde. Weitere Informationen finden Sie unter Startstatus der Aktivität verwenden.

Sobald die Aktivität gestartet wurde, werden die anderen Anrufteilnehmer aufgefordert, entweder um das Add-on zu starten oder zu installieren.

Die „Animation“ Beispiel-Add-on auf GitHub beinhaltet dieses Beispiel als Teil eines vollständigen Add-ons. Wenn die Indexseite der mit dem Add-on verknüpften Web-App angezeigt wird, wird der Nutzer aufgefordert, das Add-on entweder zu installieren oder einzurichten.

Beispiel: Im Hauptbereich laden

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

<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 Projektnummer Ihres Google Cloud-Projekts.
• MAIN_STAGE_URL: String. Die URL für den Hauptbereich.

Wenn ein Nutzer im Meet-Anrufbildschirm die Seite freigibt, sieht er eine Präsentationsbanner in Meet. Wenn Sie auf die Schaltfläche im Banner klicken, wird das Add-on für die angegebene Cloud-Projektnummer auf der Hauptbühne geöffnet. Das Attribut mainStageUrl wird geladen und die Mit der Eigenschaft additionalData wird die Aktivität festgelegt, die Status des Add-ons. Andere Nutzer im Anruf werden sofort aufgefordert, das Add-on zu installieren oder zu starten.

Beispiel: In der Seitenleiste laden

Im folgenden Codebeispiel wird auf einem Nutzerbildschirm eine Seite mit einem Add-on geteilt, das nicht im Hauptbereich, sondern im Seitenbereich gestartet werden soll:

<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 Projektnummer Ihres Cloud-Projekts.
• SIDE_PANEL_URL: String. Die URL für die Seitenleiste.

Wenn der Nutzer die Seite auf dem Meet-Anrufbildschirm freigibt, wird in Meet ein Präsentationsbanner angezeigt. Durch Klicken auf die Schaltfläche im Banner öffnet das Add-on für die angegebene Cloud-Projektnummer in in der Seitenleiste. Die Property sidePanelUrl wird geladen und die Property additionalData wird verwendet, um den Startstatus der Aktivität des Add-ons festzulegen. Andere Nutzer im Anruf werden sofort aufgefordert, das Add-on zu installieren oder zu starten.

Ursprungsabgleich

Die im Feld origins angegebenen Ursprünge mainStageUrl Property und die sidePanelUrl werden mit den Ursprüngen im Add-on verglichen. Manifest der angegebenen Cloud-Projektnummer. Wenn alles übereinstimmt, das Add-on starten darf.

Außerdem muss die Quelle der Website, auf der die Bildschirmfreigabe gestartet wird, im Feld addOnOrigins im Add-on-Manifest aufgeführt sein.

Weitere Informationen finden Sie unter Add-on-Sicherheit.

Weitere Informationen

• Mit einem Meet-Add-on zusammenarbeiten
• Add-on-Sicherheit