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

本頁面說明如何在透過 Google Meet 分享螢幕畫面時，在其他網頁上放置少量程式碼，以為使用者宣傳外掛程式。

MeetAddonScreenshare.exposeToMeetWhenScreensharing 方法可讓網站在分享螢幕畫面時，將資訊傳送至 Meet。如果使用者在簡報橫幅中點選「啟動活動」，而已安裝外掛程式，則這項資訊會用於 Meet 外掛程式體驗。如果使用者在分享螢幕畫面時未安裝外掛程式，系統會提示使用者安裝外掛程式。

AddonScreenshareInfo 物件包含五個欄位，可根據用途新增：

• AddonScreenshareInfo.additionalData：外掛程式可用來進行本身初始化的資訊。只有在 AddonScreenshareInfo.startActivityOnOpen 為 true 且可使用 CollaborationStartingState 存取的情況下才能設定。詳情請參閱「使用協作起始狀態」。

• AddonScreenshareInfo.cloudProjectNumber：必要。外掛程式的 Google Cloud 專案編號。

• AddonScreenshareInfo.mainStageUrl：外掛程式啟動後，主階段開啟的網址 (例如 https://www.example.com)。該網址必須與外掛程式資訊清單中指定的網址同屬一個來源。

• AddonScreenshareInfo.sidePanelUrl：外掛程式啟動後，側邊面板開啟的網址 (例如 https://www.example.com)。該網址必須與外掛程式資訊清單中指定的網址同屬一個來源。

• AddonScreenshareInfo.startActivityOnOpen：必要。是否要在使用者從簡報橫幅開啟外掛程式時，立即啟動 Meet 協作外掛程式體驗。如果使用 AddonScreenshareInfo.mainStageUrl，則必須為 true。

範例：在主要階段載入

在下列程式碼範例中，螢幕使用者在 Meet 中分享網頁時，系統會提示使用者啟動外掛程式：

<script src="https://www.gstatic.com/meetjs/addons/0.7.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：字串。您的 Cloud 專案編號。
• MAIN_STAGE_URL：字串。主要階段的網址。

當 Meet 通話畫面中的使用者分享網頁時，Meet 中顯示簡報橫幅。按一下橫幅上的按鈕，即可在主要階段開啟指定 Cloud 專案編號的外掛程式。系統會載入 AddonScreenshareInfo.mainStageUrl，並使用 AddonScreenshareInfo.additionalData 設定外掛程式的協作起始狀態。系統會立即提示通話中的其他使用者安裝或啟動外掛程式。

範例：載入側邊面板

在以下程式碼範例中，使用者分享螢幕畫面的頁面會分享給想從側邊面板啟動 (而非主要階段) 的外掛程式：

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 專案編號的外掛程式。系統會載入 AddonScreenshareInfo.sidePanelUrl，並使用 AddonScreenshareInfo.additionalData 設定外掛程式的協作起始狀態。系統會立即提示通話中的其他使用者安裝或啟動外掛程式。

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

在以下程式碼範例中，使用者會在畫面上透過外掛程式分享頁面，該外掛程式必須調整資源權限，才能開始進行協作活動。為符合這項要求，應在側邊面板中啟動外掛程式，而不會為所有人啟動協作功能。

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 專案編號的外掛程式。由於 AddonScreenshareInfo.startActivityOnOpen 設為 false，啟動活動按鈕會處於停用狀態，直到 CollaborationStartingState 設定為止。詳情請參閱「使用協作起始狀態」。

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

來源比對

系統會將 AddonScreenshareInfo.mainStageUrl 和 AddonScreenshareInfo.sidePanelUrl 中提供的來源與所提供 Cloud 專案編號的外掛程式資訊清單中的來源進行比對。如果一切相符，使用者即可啟動外掛程式。

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

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

相關主題

• 使用協作起始狀態
• 附加安全防護機制