Über ein Meet-Add-on zusammenarbeiten

Teilnehmer einer Videokonferenz können gemeinsam an einer Google Meet-Add-on-Aktivität arbeiten. Wenn eine gemeinsame Aktivität beginnt, erhalten alle Teilnehmer der Videokonferenz eine Benachrichtigung, dass die Aktivität laufen.

Diese Benachrichtigung wird an die Verfügbarkeit und den Installationsstatus des Add-on:

  • Wenn der Teilnehmer das Add-on installiert hat: Er kann an der Aktivität teilnehmen.

  • Wenn der Teilnehmer das Add-on nicht hat installiert: Sie werden zur Installation der Add-on.

  • Wenn das Add-on für die Plattform der Teilnehmer: Die Person wird informiert, dass sie nicht an der Aktivität teilnehmen kann. mit ihrem aktuellen Gerät.

Wenn ein Nutzer an der Aktivität teilnimmt, lädt er seine eigenen Iframes mit Ihren Add-on-Inhalten. Sie können festlegen, ob neue Teilnehmer die kollaborative Aktivität im Hauptbereich oder in der Seitenleiste öffnen sollen.

Aktivität starten

Eine Aktivität wird durch Aufrufen der Methode startActivity() mit der Methode ActivityStartingState .

Schritt 1 (optional): Das Add-on legt den Startstatus der Aktivität fest

ActivityStartingState enthält Informationen zum ursprünglichen Status des Add-ons, die verwendet werden, wenn der Teilnehmer die Einladung zur Teilnahme an der Aktivität annimmt.

Das Add-on kann die ActivityStartingState festlegen oder aktualisieren, indem es die Methode setActivityStartingState() jederzeit vor oder während der Aktivität aufruft. Anrufe an setActivityStartingState() kann weggelassen werden, wenn ActivityStartingState gleich exklusiv im Aufruf von startActivity() festgelegt.

Schritt 2: Aktivität wird durch das Add-on gestartet

Die Aktivität beginnt, wenn das Add-on die Methode startActivity() für den MeetSidePanelClient. Die Methode startActivity() verwendet ein ActivityStartingState-Objekt als Parameter, sodass startActivity() aufgerufen werden kann, anstatt setActivityStartingState()

Sobald der Nutzer die Inhaltsauswahl abgeschlossen hat und eine Aktivität starten möchte, rufe die Methode startActivity() in deinem Add-on so auf:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

Wenn die Methode startActivity() aufgerufen wird, führt Meet Folgendes aus: folgenden Aktionen:

  • Für andere Teilnehmer: In Meet wird eine Benachrichtigung angezeigt, dass die Aktivität läuft.

  • Für den Initiator: Wenn in der ActivityStartingState eine Hauptbühne-URL angegeben wurde, wird die Hauptbühne in Meet mit der URL aus der ActivityStartingState geöffnet.

Schritt 3: Startstatus der Aktivität abrufen

Wenn ein Nutzer der Aktivität beitritt, lädt er Ihr Add-on. in die Hauptanzeige oder in die Seitenleiste verschieben, je nach ActivityStartingState.

Mit der Property additionalData kannst du Ausgangsdaten teilen (auch als als Status) mit Nutzern, die der Aktivität beitreten. Nach Initialisieren eines MainStageClient oder SidePanelClient, ich kann die Funktion getActivityStartingState() Methode zum Abrufen der additionalData-Eigenschaft.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

Schritt 4 (optional): Add-on-Status in einer Aktivität teilen

Sie können den Status auch für andere Nutzer freigeben, während die Aktivität läuft. Sie haben zwei Möglichkeiten, den Status zu teilen:

  • Sie können die Synchronisierung selbst übernehmen, indem Sie ein eigenes Synchronisierungs-Backend erstellen.
  • Verwenden Sie die Co-Doing API, eine bequeme und schnelle Möglichkeit, beliebige Daten unter Nutzern zu teilen.

Beispiel: Animations-Add-on auf GitHub

Das Beispiel-Add-on „Animation“ auf GitHub enthält die Funktion „Mit anderen zusammenarbeiten“ in einem Add-on. Schritt 1 aus dieser Anleitung ist in der Beispieldatei nicht enthalten. Stattdessen wird die Methode startActivity() aufgerufen (Schritt 2), wenn der Initiator des Add-ons im Seitenpanel auf die Schaltfläche Animation starten klickt. Dabei wird der Startstatus mit der vom Nutzer ausgewählten Farbe ausgefüllt. Nach dem Start der Aktivität ruft die Hauptphase den Startstatus ab, indem sie die Methode getActivityStartingState() aufruft (Schritt 3). Schritt 4 wird als Status (der ausgewählte Farbe) während der Aktivität in dieser Beispiel-Add-on. Einzelne Nutzer können ihren eigenen Status jedoch ändern, indem sie eine Farbe auswählen, die über Frame-to-Frame-Messaging vom Frame des Seitenpanels an den Frame der Hauptbühne gesendet wird.

Einschränkungen

  • Die in der ActivityStartingState angegebenen URLs müssen zur selben origin als die Ursprünge aus, die in das Add-on-Manifest. Weitere Informationen finden Sie unter Add-on-Sicherheit.
  • Die sidePanelUrl Property, mainStageUrl Property und additionalData Zeichenlängen von Eigenschaften müssen ihren jeweiligen Größenbeschränkungen entsprechen: in der SDK-Referenzdokumentation.