Add-ons über die Bildschirmfreigabe bewerben

Werbung für ein Add-on über die Bildschirmfreigabe

Auf dieser Seite wird beschrieben, wie Sie bei Nutzern ein Add-on bewerben. bei der Bildschirmfreigabe in Google Meet, indem Sie eine kleine Codemenge auf einer anderen Webseite.

Die exposeToMeetWhenScreensharing() ermöglicht es der Website, Informationen an Meet zu senden, wenn der Tab mit der Bildschirmfreigabe geteilt wurde. Diese Informationen werden in der mit Meet, wenn das Add-on Nutzer klickt auf „Aktivität starten“ auf dem Präsentationsbanner, Add-on installiert. 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.

Die AddonScreenshareInfo enthält fünf Eigenschaften, die je nach Anwendungsfall hinzugefügt werden können:

  • additionalData: Informationen, die das Add-on zur Initialisierung nutzen 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 verwenden.

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

  • mainStageUrl: Die URL, die der Hauptbereich nach dem Add-on öffnet beginnt, wie z. B. https://www.example.com. Die URL muss zur selben origin als die im Add-on-Manifests.

  • 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 gestartet werden soll in Meet, wenn der Nutzer die Add-on aus dem Präsentationsbanner aus. Muss wahr sein wenn das Attribut mainStageUrl verwendet wird.

Beispiel: In der Hauptbühne laden

Im folgenden Codebeispiel teilt ein Nutzer, der über einen Bildschirm eine Webseite in Meet mit dem folgenden Code wird aufgefordert, die Add-on:

<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>

Ersetzen Sie Folgendes:

  • CLOUD_PROJECT_NUMBER: String. Die Projektnummer Ihres Google Cloud-Projekt
  • MAIN_STAGE_URL: String. Die URL für den Hauptbereich.

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 Hauptbühne. Das Attribut mainStageUrl wird geladen und die Mit der Eigenschaft additionalData wird die Aktivität festgelegt, die Status des Add-ons. Die anderen Anrufteilnehmer 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 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>

Ersetzen Sie Folgendes:

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

Wenn ein Nutzer im Meet-Anrufbildschirm die Seite freigibt, sieht er eine Präsentationsbanner in Meet. Durch Klicken auf die Schaltfläche im Banner öffnet das Add-on für die angegebene Cloud-Projektnummer in in der Seitenleiste. Das Attribut sidePanelUrl wird geladen und die Mit der Eigenschaft additionalData wird die Aktivität festgelegt, die Status des Add-ons. Die anderen Anrufteilnehmer sofort aufgefordert, das Add-on zu installieren oder zu starten.

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

Im folgenden Codebeispiel teilt ein Nutzerbildschirm eine Seite mit einem das die Ressourcenberechtigungen anpassen muss, bevor Aktivität gestartet werden kann. Aufgrund dieser Anforderung sollte in der Seitenleiste ohne das Symbol die für alle gestartet wird.

<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>

Ersetzen Sie Folgendes:

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

Wenn ein Nutzer im Meet-Anrufbildschirm die Seite freigibt, sieht er eine Präsentationsbanner in Meet. 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 Aktivität verwenden Ausgangszustand.

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

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 der Ursprung der Website, die die Bildschirmfreigabe initiiert, angegeben sein. im Feld addOnOrigins des Add-ons Manifest-Datei.

Weitere Informationen finden Sie unter Add-on Sicherheit.