透過分享螢幕畫面向使用者宣傳外掛程式

本頁說明如何向使用者宣傳外掛程式 透過插入少量程式碼，透過 Google Meet 分享螢幕畫面 其他網頁中

exposeToMeetWhenScreensharing() 方法可讓網站將資訊傳送給 Meet 分享螢幕畫面時。如果使用者已安裝外掛程式，當他們在簡報橫幅上點選「開始活動」時，系統就會在 Meet 外掛程式體驗中使用這項資訊。如果使用者沒有 外掛程式，但分享螢幕畫面時 。

AddonScreenshareInfo 物件包含五個屬性，可根據用途加入：

• additionalData：外掛程式可用於初始化自身的資訊。罐類收納 只有在 startActivityOnOpen 屬性為 true 且 透過 Deployment ActivityStartingState。 詳情請參閱「取得活動啟動狀態」。

• cloudProjectNumber: 這是必要項目。Google Cloud 專案的專案編號。

• mainStageUrl：在外掛程式啟動後，主畫面會開啟的網址，例如 https://www.example.com。網址必須隸屬於同一個 origin 做為 外掛程式資訊清單。

• sidePanelUrl：啟動外掛程式後，側邊面板會開啟的網址，例如 https://www.example.com。網址必須隸屬於同一個 origin 做為 外掛程式資訊清單。

• startActivityOnOpen：必填。當使用者從簡報橫幅啟動外掛程式時，是否立即在 Meet 中啟動活動外掛程式體驗。如果使用 mainStageUrl 屬性，則必須設為 true。

安裝並匯入 SDK

您可以使用 npm 或 gstatic 存取 SDK。

npm install @googleworkspace/meet-addons

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

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

範例：在不啟動活動的情況下載入側邊面板

在下列程式碼範例中，使用者螢幕畫面和 必須調整資源權限的外掛程式 一開始可以啟動因此，您應在側邊面板中啟動外掛程式，而非為所有使用者啟動活動。

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

更改下列內容：

• CLOUD_PROJECT_NUMBER：字串。專案的專案編號 Cloud 專案
• SIDE_PANEL_URL：字串。側邊面板的網址。

Meet 通話畫面中的使用者分享網頁時，會看到 會議簡報橫幅。點選橫幅上的按鈕 開啟指定 Cloud 專案編號的外掛程式 顯示側邊面板由於 startActivityOnOpen 屬性已設為 false，因此在設定 ActivityStartingState 之前，啟動活動按鈕會處於停用狀態。詳情請參閱「使用活動啟動狀態」。

活動開始後，系統會提示通話中的其他使用者 啟動或安裝外掛程式

GitHub 上的 「Animation」範例外掛程式包含這個範例，是完整外掛程式的一部分。時間 索引頁面 顯示與外掛程式相關聯的網頁應用程式 系統會提示簡報使用者 外掛程式。

範例：在主畫面中載入

在下列程式碼範例中，如果使用者在 Meet 中分享含有下列程式碼的網頁畫面，系統就會提示使用者啟動外掛程式：

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

更改下列內容：

• CLOUD_PROJECT_NUMBER：字串。專案的專案編號 存取 Google Cloud 專案
• MAIN_STAGE_URL：字串。主畫面的網址。

當 Meet 通話畫面中的使用者分享網頁時，他們會在 Meet 中看到簡報橫幅。點選橫幅上的按鈕 開啟指定 Cloud 專案編號的外掛程式 在主舞台上系統會載入 mainStageUrl 屬性，並使用 additionalData 屬性設定外掛程式的活動啟動狀態。通話中的其他使用者為 ，系統會立即提示您安裝或啟動外掛程式。

範例：載入側邊面板

在下列程式碼範例中，使用者螢幕畫面和 以及偏好從側邊面板啟動的外掛程式 而非主要階段：

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

更改下列內容：

• CLOUD_PROJECT_NUMBER：字串。專案的專案編號 Cloud 專案
• SIDE_PANEL_URL：字串。側邊面板的網址。

Meet 通話畫面中的使用者分享網頁時，會看到 會議簡報橫幅。點選橫幅上的按鈕 開啟指定 Cloud 專案編號的外掛程式 顯示側邊面板系統會載入 sidePanelUrl 屬性，並使用 additionalData 屬性設定外掛程式的活動啟動狀態。通話中的其他使用者為 ，系統會立即提示您安裝或啟動外掛程式。

來源比對

提供的來源 mainStageUrl 而 sidePanelUrl 系統會將資源與外掛程式中的來源資料進行比較 該 Cloud 專案編號的資訊清單。如果一切相符，使用者 允許啟動外掛程式

此外，啟動螢幕分享的網站來源必須列於外掛程式資訊清單的 addOnOrigins 欄位中。

詳情請參閱外掛程式 安全性。

相關主題

• 使用 Meet 外掛程式協作
• 外掛程式安全性