Add-on für Nutzer bewerben

Entwickler können die Auffindbarkeit ihrer Add-ons erhöhen, indem sie sie über den In-Call-Chat von Meet und die Bildschirmfreigabefunktion von Meet bewerben.

Anrufchat

Google Meet-Add-ons werden Nutzern im In-Call-Chat von Meet automatisch präsentiert, wenn eine Nachricht Links enthält, die mit einem Add-on verknüpft sind. Entwickler müssen nichts weiter tun, um Add-ons im Chat zu bewerben. Das Überprüfungsteam legt anhand des URI der Seitenleiste und der im Bereitstellungsmanifest festgelegten Add-on-Quellen fest, welche Links einem Add-on zugeordnet werden.

Wenn Nutzer eine Nachricht über einen In-Call-Chat senden, der mit einem Add-on verknüpft ist, passiert eines von zwei Dingen:

  1. Wenn das Add‑on nicht installiert ist, wird der Nutzer auf einer Karte aufgefordert, es zu installieren.
  2. Wenn das Add-on bereits installiert ist, wird der Nutzer über eine Schaltfläche daran erinnert, es zu öffnen.

Bildschirmfreigabe

Bewerbung eines Add‑ons durch Bildschirmfreigabe.

Auf dieser Seite wird beschrieben, wie Sie ein Add-on für Nutzer bewerben können, während Sie einen Tab mit Google Meet freigeben. Dazu müssen Sie nur ein wenig Code auf einer anderen Webseite platzieren.

Mit der Methode exposeToMeetWhenScreensharing() kann die Website Informationen an Meet senden, wenn ihr Tab freigegeben wird. Diese Informationen werden in der Add‑on-Umgebung mit Meet verwendet, wenn der Nutzer im Präsentationsbanner auf „Aktivität starten“ klickt und das Add‑on installiert hat. Wenn der Nutzer das Add‑on nicht installiert hat, wenn er einen Tab freigibt, wird er 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, die das Add-on zur Initialisierung verwenden kann. Kann nur festgelegt werden, wenn die Property startActivityOnOpen „true“ 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 beim Start des Add-ons geöffnet wird, z. B. https://www.example.com. Die URL muss zum selben Ursprung gehören wie die URLs, die im Add-on-Manifest angegeben sind.

  • sidePanelUrl: Die URL, die in der Seitenleiste geöffnet wird, sobald das Add-on gestartet wird, z. B. https://www.example.com. Die URL muss zum selben Ursprung gehören wie die URLs, die im Add-on-Manifest angegeben sind.

  • startActivityOnOpen: Erforderlich. Gibt an, ob das Aktivitäts-Add-on in Meet sofort gestartet werden soll, wenn der Nutzer das Add-on über das Präsentationsbanner startet. Muss „true“ sein, wenn die Property mainStageUrl verwendet wird.

SDK installieren und importieren

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

Wenn in Ihrem Projekt npm verwendet wird, können Sie der Anleitung für das npm-Paket für das Meet-Add-ons SDK folgen.

Installieren Sie zuerst das npm-Paket:

npm install @googleworkspace/meet-addons

Das Meet Add-ons SDK ist dann verfügbar, indem Sie die MeetAddonScreenshareExport-Schnittstelle importieren:

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

Für TypeScript-Nutzer sind TypeScript-Definitionen im Modul enthalten. TypeScript-Nutzer sollten moduleResolution in der tsconfig.json des Projekts auf "bundler" setzen, damit durch die Spezifikation „exports“ in package.json der Export des Bildschirmfreigabepakets importiert werden kann.

gstatic

Das Google Meet Add-ons SDK ist als JavaScript-Bundle unter gstatic verfügbar, einer Domain, über die statische Inhalte bereitgestellt werden.

Wenn Sie das Meet-Add-ons SDK verwenden möchten, fügen Sie Ihrer App das folgende Script-Tag hinzu:

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Das Meet Add-ons SDK ist über die MeetAddon-Schnittstelle unter window.meet.addon verfügbar.

Beispiel: Laden in der Seitenleiste ohne Starten einer Aktivität

Im folgenden Codebeispiel gibt ein Nutzer eine Seite mit einem Add-on frei, für das Ressourcenberechtigungen angepasst werden müssen, bevor die Aktivität gestartet werden kann. Aufgrund dieser Anforderung sollte das Add-on in der Seitenleiste gestartet werden, ohne dass die Aktivität 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 im Meet-Anruf die Seite freigibt, wird in Meet ein Präsentationsbanner 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 das Attribut startActivityOnOpen auf „false“ gesetzt wurde, ist die Schaltfläche zum Starten der Aktivität deaktiviert, bis ActivityStartingState festgelegt ist. Weitere Informationen finden Sie unter Startstatus der Aktivität verwenden.

Sobald die Aktivität gestartet wurde, werden andere Nutzer im Anruf aufgefordert, das Add-on zu starten oder zu installieren.

Das Beispiel-Add-on „Animation“ auf GitHub enthält 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, der die Seite aufruft, aufgefordert, das Add‑on zu installieren oder einzurichten.

Beispiel: Auf dem Hauptbildschirm laden

Im folgenden Codebeispiel wird ein Nutzer, der eine Webseite in Meet freigibt, die den folgenden Code enthält, 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 die Hauptbühne.

Wenn der Nutzer im Meet-Anruf die Seite freigibt, wird in Meet ein Präsentationsbanner angezeigt. 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. Die Property mainStageUrl 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.

Beispiel: In der Seitenleiste laden

Im folgenden Codebeispiel teilt ein Nutzer eine Seite mit einem Add-on, das im Seitenbereich und nicht auf der Hauptbühne 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 im Meet-Anruf die Seite freigibt, wird in Meet ein Präsentationsbanner 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. 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 in der Property mainStageUrl und der Property 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 die Quelle der Website, die die Bildschirmfreigabe initiiert, im Feld addOnOrigins im Add-on-Manifest aufgeführt sein.

Weitere Informationen finden Sie unter Add-on-Sicherheit.