最佳做法

改善使用者以改善整體使用體驗 Google Meet 外掛程式設計。

授權最佳做法

針對 需要驗證或授權的 Google Meet 外掛程式。

使用 Google 登入功能

許多 Google Workspace 外掛程式使用者都已登入 Google 加入會議。因此,使用 Google 登入功能 您能在選擇前 3 個步驟中 登入流程。

在新視窗中開啟第三方登入頁面

除了 Google 登入外,應用程式可能還提供其他登入功能 機制如果是,請使用對話方塊,而不要在瀏覽器中開啟登入頁面 新分頁。如此一來,使用者仍能查看及返回 與 Meet 通話,所獲得的整體點擊次數較少。

正確要求 Google API 的範圍

如果您的 Meet 外掛程式呼叫了 Google API: 您必須提供完整的 OAuth 清單 範圍 所需的應用程式。也就是 Google Workspace Marketplace 中的「應用程式設定」頁面。新增這類資料欄後 會在使用者安裝您的 Meet 外掛程式,讓使用者知道自己含有哪些類型的資料 並允許您的應用程式存取

發布外掛程式之前 此外,您還必須設定 OAuth 同意授權 螢幕。 為此,您必須新增完全相同的授權範圍, Google Workspace Marketplace 應用程式設定。設定 OAuth 同意畫面也需要設定品牌宣傳資訊、隱私權政策 以及服務在要求範圍時顯示的服務條款。發布 公開,這些資訊都必須送交 驗證

編寫呼叫 Google Workspace API 的程式碼時,請遵循 JavaScript 快速入門導覽課程 是最簡單的入門方式這種做法遵循 存取 Google 登入和對話方塊請注意,初始化符記 客戶 JavaScript 需要單獨要求應用程式所需的範圍 實際使用的應用程式為確保使用者享有最佳體驗,以下要求的範圍 必須與 Google Workspace Marketplace 應用程式設定中的設定一致 頁面。這種備援功能可提供備用選項,以處理 已撤銷使用者 範圍

維護最佳做法

以下最佳做法是編寫可維護的 更重要的是 Meet 外掛程式。

使用最新版的 Google Meet 外掛程式 SDK

Meet 外掛程式 SDK 會定期更新。SDK 遵循 語意版本管理。如何找到最新版本:

  • 使用 gstatic:最新 SDK 版本包含在 gstatic 中 SDK 使用操作說明中找到的網址。
  • 使用 npm 時:從以下位置執行 npm update @googleworkspace/meet-add-ons: 包含 package.json 的目錄 。

建立測試用 Google Cloud 專案

Google Meet 外掛程式發布到 Google Workspace Marketplace 立即部署任何新的 Google Meet 外掛程式 。使用者會立即看到這些更新 清除快取,否則快取就會過期因此我們不建議 將變更推送至生產網站,直到徹底測試變更為止。

為避免直接部署至實際工作環境,建議您另外建立一個 私人發布的 Google Cloud 專案 組織。這項 Cloud 專案會託管測試環境 開發環境和開發環境。存取權 應為這個 Cloud 專案組成的小型團隊 讓您直接開發外掛程式

如要為外掛程式建立這些替代環境 您需要先代管網頁應用程式的替代環境 :在您擁有的網域中播放您的外掛程式。接著: 您可以建立替代環境 新增其他 的 Meet 外掛程式 Deployment 至測試環境 Google Cloud 專案這些新的部署作業 資訊清單,指向網頁應用程式的替代環境。 然後建議您分別安裝 環境如下:

  • 測試環境私人發布測試版本 讓貴機構的所有成員都能協助測試。
  • 開發:點選「動作」欄下方的「安裝」,即可安裝 只有您的帳戶支援外掛程式開發版本。

編寫測試

將 Meet 外掛程式部署至開發環境前 建議編寫單元測試單元測試應包含:

  • 模擬 Meet 外掛程式 SDK,然後驗證 Meet 外掛程式會正常呼叫 SDK 功能。
  • 對應用程式的所有非 SDK 相關功能進行單元測試 以及您偏好的網路測試架構。

使用者體驗最佳做法

下列最佳做法有助於製作 Meet 外掛程式 變得更直覺、更精緻

在側邊面板中管理所有起始狀態

我們強烈建議您根據 在側邊面板上進行的使用者動作。 方法是將協作活動開始 狀態 JavaScript。進入 CollaborationStartingState敬上 應該由外掛程式發起者設定 (通常是 即可。您可以想到 以表單形式呈現您的 外掛程式。

在不使用時關閉側邊面板

透過呼叫的方式開始活動後 startCollaboration、 建議您只保留側邊面板 可說是使用者體驗不可或缺的一環 Google Meet 外掛程式。確認主要使用者介面的 階段,透過呼叫 unloadSidePanel

利用分享螢幕畫面功能宣傳 Meet 外掛程式

與分享螢幕畫面相比,Meet 外掛程式提供更豐富的體驗。 不過,許多使用者都習慣使用 Meet 的分享螢幕畫面功能 而不是每個特徵的分數如果使用者分享的分頁顯示代管您的網站 Meet 外掛程式,則可將 Meet 設定為 向所有通話參與者顯示橫幅,提示他們安裝或使用 和對應的 Meet 外掛程式若需更多資訊,請參閲 透過螢幕宣傳外掛程式 分享