Clientobjekte verwalten

Auf dieser Seite wird beschrieben, wie Sie Clientobjekte verwalten, die ein Add‑on für die Kommunikation mit Google Meet benötigt.

Zuerst muss das Add‑on eine Sitzung einrichten:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

Ersetzen Sie CLOUD_PROJECT_NUMBER durch die Projektnummer Ihres Google Cloud-Projekts.

Aus der Sitzung können zwei Clientobjekte erstellt werden:

• Das MeetMainStageClient für ein Add‑on, das auf der Haupt bühne ausgeführt wird, kann mit await session.createMainStageClient() abgerufen werden.

• Das MeetSidePanelClient für ein Add‑on, das in der Seiten leiste ausgeführt wird, kann mit await session.createSidePanelClient() abgerufen werden.

Es ist wichtig, das richtige Clientobjekt für die Hauptbühne oder die Seitenleiste abzurufen. Wenn der falsche Client abgerufen wird, löst das Google Meet Add‑ons SDK eine Ausnahme aus. Mit der Methode können Sie prüfen, in welchem iFrame (Hauptbühne oder Seitenleiste) das Add‑on ausgeführt wird.getFrameType()

Das folgende Codebeispiel zeigt, wie das Clientobjekt der Hauptbühne instanziiert wird:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Ersetzen Sie CLOUD_PROJECT_NUMBER durch die Projektnummer Ihres Cloud-Projekts.

Gemeinsame Funktionen

Einige Funktionen sind sowohl im MeetMainStageClient- als auch im MeetSidePanelClient-Objekt verfügbar, während andere Funktionen spezifisch für einen bestimmten Client sind.

Beispiele für Funktionen, die in beiden Clients verfügbar sind:

• Die getActivityStartingState() Methode ruft Informationen zum Ausgangszustand des Add‑ons ab, wenn der Teilnehmer die Einladung zur Teilnahme an der Aktivität annimmt.
• Die getMeetingInfo() Methode ruft Details zur Besprechung ab, in der das Add‑on ausgeführt wird.
• Die setActivityStartingState() Methode legt den Ausgangszustand des Add‑ons fest, wenn der Teilnehmer die Einladung zur Teilnahme an der Aktivität annimmt.
• Eine umfassende Liste der Funktionen in beiden Clients finden Sie im MeetAddonClient Objekt.

Clientspezifische Funktionen

Funktionen, die nur im MeetMainStageClient Objekt verfügbar sind:

• Die notifySidePanel() Methode sendet eine Nachricht an die Seitenleiste. Die Nachricht kann empfangen werden, indem Sie den frameToFrameMessage Callback in der Seitenleiste abonnieren.

• Die loadSidePanel() Methode öffnet den iFrame der Seitenleiste. Die iFrame-Quelle wird auf die URL der Seitenleiste aus der Manifestdatei festgelegt.

• Die unloadSidePanel() Methode schließt den iFrame der Seitenleiste. Der Add‑on-Status wird in Meet nicht beibehalten, wenn die Methode aufgerufen wird. Es liegt in der Verantwortung des Add‑ons, den Add‑on-Status beizubehalten, bevor diese Methode aufgerufen wird.

Funktionen, die nur im MeetSidePanelClient -Objekt verfügbar sind:

• Die notifyMainStage() Methode sendet eine Nachricht an die Hauptbühne. Die Nachricht kann empfangen werden, indem Sie die frameToFrameMessage Callback Eigenschaft auf der Hauptbühne abonnieren.