附件探索 iframe

「附件探索 iframe」是在建立 Classroom 工作期間開啟外掛程式時,對老師顯示的初始檢視畫面。附件是指您希望學生互動的內容或活動。

老師在 Classroom 課程中建立新貼文 (例如作業、公告或問題),然後從外掛程式下拉式清單中選取外掛程式。只要花一點時間 (以小時為單位),Classroom 都允許外掛程式在訊息中新增附件。

查看作業建立畫面,包括老師可以附加的外掛程式選項 圖 1.查看作業建立畫面,包括老師可以附加的可用外掛程式選項。

老師選取外掛程式後,Classroom 會建立附件探索 iframe,並載入外掛程式的啟動網址。系統會將所有相關的 iframe 查詢參數傳送至啟動網址。

附件探索 UI 範例

圖 2. iframe 中的附件探索 UI 範例。

老師在 iframe 中使用合作夥伴的網頁應用程式選取連結。應用程式會呼叫 Classroom API 來將附件附加到作業中。老師選取附件後,外掛程式會傳送 postMessage 酬載,要求關閉 iframe。

iframe 隨即關閉,老師可能會看到附件,他們可以選擇預覽或移除作業中的附件。

查看作業建立畫面

圖 3. 查看包含三個活動類型外掛程式附件的指派作業。

iframe 中的使用者體驗注意事項

  • 初次開啟外掛程式時,外掛程式必須提示老師登入。
  • 所有 Classroom API 呼叫都必須啟用 Google 單一登入服務。如果產品有不同的登入系統,則您必須連結帳戶。
  • 老師必須能夠在 iframe 中預覽附件後,才能做出最終選擇。
  • 老師應能搜尋或瀏覽可附加內容。
  • 外掛程式可提供各種檢視畫面,例如近期內容、我的內容,以及依學習技能篩選。
  • 這個外掛程式必須讓使用者能夠在 iframe 中建立新的可附加項目。

請參閱 Classroom 外掛程式需求檢查清單,進一步瞭解使用者體驗需求。

在 iframe 中顯示授權狀態

如果外掛程式需要授權,但老師沒有授權,則「必須」向老師顯示清楚的訊息,通知他們採取適當的後續步驟來解決問題。以免授權限製造成任何混淆。

此外,我們也建議採用以下外掛程式:

  • 在附件探索 iframe 中顯示老師的授權等級。
  • 隱藏或停用因授權層級限製而無法向老師顯示的內容。