本頁面說明如何在透過 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
欄位中。
詳情請參閱「外掛程式安全性」。