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

本頁面說明如何在其他網頁上放置少量程式碼，以在透過 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.1.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 中會顯示橫幅橫幅。按一下橫幅上的按鈕，即可在主階段中開啟指定雲端專案編號的外掛程式。已載入 AddonScreenshareInfo.mainStageUrl，並使用 AddonScreenshareInfo.additionalData 設定外掛程式的協作啟動狀態。通話中的其他使用者會立即提示安裝或啟動外掛程式。

範例：在側邊面板中載入

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

<script src="https://www.gstatic.com/meetjs/addons/0.1.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 中會顯示橫幅橫幅。按一下橫幅上的按鈕，即可開啟側邊面板中指定雲端專案編號的外掛程式。已載入 AddonScreenshareInfo.sidePanelUrl，並使用 AddonScreenshareInfo.additionalData 設定外掛程式的協作啟動狀態。通話中的其他使用者會立即提示安裝或啟動外掛程式。

範例：在側邊面板中載入，但不啟動協作活動

在以下程式碼範例中，使用者畫面分享的頁面會提供外掛程式，而該外掛程式必須先調整資源權限，才能啟動協作活動。基於這項規定，外掛程式應在側邊面板中啟動，不必為所有人開始協同合作。

<script src="https://www.gstatic.com/meetjs/addons/0.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 通話畫面中的使用者分享頁面時，Meet 中會顯示橫幅橫幅。按一下橫幅上的按鈕，即可開啟側邊面板中指定雲端專案編號的外掛程式。由於 AddonScreenshareInfo.startActivityOnOpen 設為 False，在設定 CollaborationStartingState 前，「開始活動」按鈕會處於停用狀態。詳情請參閱「使用協作起始狀態」。

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

來源比對

系統會將 AddonScreenshareInfo.mainStageUrl 和 AddonScreenshareInfo.sidePanelUrl 中提供的來源與所提供 Cloud 專案編號的外掛程式資訊清單中的來源進行比較。如果所有項目都相符，系統就會允許使用者啟動外掛程式。

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

詳情請參閱「附加安全性」。

相關主題

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