取得用戶端物件

本頁說明如何取得 外掛程式才能與 Google Meet 通訊

首先，外掛程式必須建立工作階段：

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

在這個工作階段中，您可以建立兩個用戶端物件：

• MeetMainStageClient 在主要容器中運作的外掛程式 階段，可使用 await session.createMainStageClient() 擷取。

• MeetSidePanelClient 安裝在前端執行的外掛程式 面板，可使用 await session.createSidePanelClient() 擷取。

請務必為主要階段擷取正確的用戶端物件 或側邊面板如果擷取的用戶端有誤，Google Meet 外掛程式 SDK 會擲回 例外狀況。如要檢查哪個 iframe (主要階段或側邊面板) 外掛程式正在執行，請使用 MeetAddon.getFrameType敬上 方法。

以下程式碼範例說明如何將主要階段用戶端物件例項化：

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

共用功能

部分功能在 MeetMainStageClient 和 MeetSidePanelClient，其他功能則與特定 用戶端。

舉例來說，這兩個用戶端提供的部分功能包括：

• MeetAddonClient.getCollaborationStartingState 方法是取得 參與者接受邀請即可新增外掛程式 讓員工能和我們合作
• MeetAddonClient.getMeetingInfo 方法是取得 外掛程式正在執行。
• MeetAddonClient.getMeetPlatformInfo 方法，即可取得 外掛程式正在執行。
• MeetAddonClient.setCollaborationStartingState 設定外掛程式的初始狀態 參與者接受協作邀請。
• 如需這兩種用戶端的完整功能清單，請參閱 MeetAddonClient敬上 物件。

用戶端專屬功能

此功能僅適用於 MeetMainStageClient:

• MeetMainStageClient.notifySidePanel 傳送訊息至側邊面板。郵件收件者： 訂閱 FrameToFrameMessage 回呼。

• MeetMainStageClient.loadSidePanel 方法會開啟側邊面板 iframe。iframe 來源已設為 資訊清單檔案中的側邊面板網址。

• MeetMainStageClient.unloadSidePanel 方法會關閉側邊面板 iframe。外掛程式 並在呼叫方法時停止在 Meet 中保留狀態。 外掛程式會自動保留 外掛程式狀態，再呼叫此方法。

此功能僅適用於 MeetSidePanelClient:

• MeetSidePanelClient.notifyMainStage 傳送訊息至 mainStage可透過訂閱接收訊息 傳送至 FrameToFrameMessage 回呼。