請參閱這些 Google Meet 外掛程式設計指南,提升使用者的整體體驗。
授權最佳做法
如果 Google Meet 外掛程式需要驗證或授權,建議您採用下列最佳做法。
使用 Google 登入
許多 Google Workspace 外掛程式使用者在加入會議前,都已登入 Google 帳戶。因此,提供 Google One Tap 選項可讓使用者在登入流程中省下多次點擊。詳情請參閱「管理外掛程式的登入方式」。
在新視窗中開啟第三方登入頁面
除了 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 位於使用 SDK 的操作說明中,gstatic URL 內。
- 使用 npm 時:在含有
package.json
的目錄中執行npm update @googleworkspace/meet-add-ons
,該目錄是代管 Meet 外掛程式的網站。
建立 Google Cloud 測試專案
Google Meet 外掛程式發布至 Google Workspace Marketplace 後,Meet 使用者就能立即部署並使用外掛程式。使用者清空快取或快取過期後,就會看到這些更新。因此,我們建議您先徹底測試變更,再將變更推送至正式網站。
為避免直接部署至正式環境,建議您建立獨立的 Google Cloud 專案,並以私密方式發布至貴機構。這個 Cloud 專案會代管 Meet 外掛程式的暫存和開發環境。這個 Cloud 專案的存取權應僅限於直接參與外掛程式開發的小型團隊。
如要為外掛程式建立這些替代環境,請先在您擁有的網域上,代管含有外掛程式的網頁應用程式替代環境。然後,您可以在測試 Google Cloud 專案中新增其他 部署作業,為 Meet 外掛程式建立替代環境。這些新部署作業應有資訊清單,指向網頁應用程式的替代環境。接著,建議您按照下列方式安裝各個外掛程式環境:
- 預先發布:私下發布預先發布版本,讓貴機構的任何使用者都能協助測試。
- 開發:按一下「動作」欄下方的「安裝」,即可將 Meet 外掛程式開發版本安裝到您的帳戶。
撰寫測試
將 Meet 外掛程式部署至開發環境前,建議先撰寫單元測試。單元測試應包含:
- 模擬 Meet 外掛程式 SDK,然後確認 Meet 外掛程式是否如預期呼叫 SDK 函式。
- 使用偏好的網頁測試架構,對外掛程式的所有非 SDK 相關功能進行單元測試。
使用者體驗最佳做法
下列最佳做法可協助您打造更直覺易用的 Meet 外掛程式。
在側邊面板中管理所有起始狀態
強烈建議您根據使用者在側邊面板中執行的動作設定外掛程式。方法是在 JavaScript 中設定活動的起始狀態。所有要輸入
ActivityStartingState
的資料,都應由外掛程式發起人 (通常是會議主辦人) 在側邊面板中設定。側邊面板的第一個檢視畫面可視為表單,用來控管外掛程式的設定。
未使用時關閉側邊面板
透過呼叫 startActivity()
方法啟動活動後,只有在側邊面板是 Google Meet 外掛程式使用者體驗的重要部分時,才應保持開啟。開啟主舞台後,即可呼叫 unloadSidePanel()
方法關閉側邊面板。
透過分享螢幕畫面宣傳 Meet 外掛程式
與分享螢幕畫面相比,Meet 外掛程式可提供更豐富的體驗。 不過,許多使用者習慣使用 Meet 的螢幕分享功能。如果使用者分享的分頁顯示的是裝載 Meet 外掛程式的網站,系統可以設定為向所有通話參與者顯示橫幅,提示他們安裝或使用相應的 Meet 外掛程式。詳情請參閱「透過分享畫面宣傳外掛程式」。
標誌設計指南
設計 Meet 專屬標誌時,請遵守下列規範,確保標誌在現在和未來都能呈現最佳效果:
請使用 PNG 檔案格式,大小為 256 像素 x 256 像素。
請使用透明度。
請使用 Meet 外掛程式開發人員工具,確認深色模式標誌在深色模式下是否正常顯示。
請使用對比度檢查工具 (例如 Web Accessibility In Mind (WebAIM) 的 Contrast Checker),確認標誌 (和其他圖像素材) 在高對比模式下呈現良好效果。
請遵守特定應用程式整合的圖片規定。
圖片中不得包含邊框間距。改為將圖片延伸至檔案邊界。