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

透過畫面宣傳外掛程式 分享。

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

exposeToMeetWhenScreensharing()敬上 方法可讓網站將資訊傳送給 Meet 分享螢幕畫面時。這些資訊會用於 或是 Meet 的外掛程式 使用者按一下「開始活動」顯示在簡報橫幅中 已安裝外掛程式。如果使用者沒有 外掛程式，但分享螢幕畫面時 。

AddonScreenshareInfo敬上 物件包含 5 個根據用途新增的屬性：

  • additionalData: 外掛程式可以用來初始化的資訊。罐類收納 只有在 startActivityOnOpen 屬性為 true 且 透過 Deployment ActivityStartingState。 詳情請參閱使用起始活動 狀態。

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

  • mainStageUrl: 外掛程式開啟後，主階段開啟的網址 開始，例如 https://www.example.com網址必須隸屬於相同 origin 做為 外掛程式資訊清單。

  • sidePanelUrl: 外掛程式後開啟側邊面板的網址 開始，例如 https://www.example.com網址必須與外掛程式資訊清單中指定的網址屬於相同的來源。

  • startActivityOnOpen: 這是必要項目。是否啟動活動外掛程式 使用者啟動 Meet 後 額外播放。必須設為 true 如果使用 mainStageUrl 屬性。

範例：在主要階段載入

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

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

更改下列內容：

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

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

範例：在側邊面板中載入

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

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

更改下列內容：

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

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

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

在以下程式碼範例中，使用者畫面會與外掛程式共用頁面，而該外掛程式必須先調整資源權限，才能啟動活動。由於這項規定， 外掛程式都必須在側邊面板中啟動，沒有 已為所有人啟用活動

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

更改下列內容：

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

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

活動開始後，通話中的其他使用者會收到提示，要求他們啟動或安裝外掛程式。

起源比對

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

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

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