
語言 🇹🇼 繁體中文
概述
Canvas LTI 1.3 設定
設定
故障排除
投票
透過 LTI 1.3 為 Canvas LMS 添加評論
FastComments 透過 LTI 1.3 標準與 Canvas LMS 整合。這會將即時留言和協作聊天直接加入您的 Canvas 課程 - 無需在您的伺服器上安裝外掛。
留言會自動出現在作業下方,並且講師可以透過 Rich Content Editor 在 Pages、Quizzes、和 Announcements 中嵌入 FastComments。SSO 會透過 LTI 啟動自動處理 - 學生使用他們的 Canvas 帳戶留言,無需額外登入。此整合支援串狀留言、即時協作聊天(含文字高亮),以及自動角色對應。
快速開始 
- 前往 your FastComments LTI Config。
- 輸入 Configuration Name 與您的 Platform URL(例如
https://yourschool.instructure.com)。選擇要啟用的 Placements(Assignment View 和/或 Editor Button — 預設兩者皆為開啟)。點選 Create Configuration。精靈會進入第 2 步並顯示您的 Configuration URL。 - 在 Canvas 中,前往 Admin > Developer Keys > + Developer Key > LTI Key。將 Method 設為 "Enter URL" 並貼上 Configuration URL。儲存金鑰,然後將其 State 設為 ON,在提示時點選 Allow。
- 從 Canvas 的 Developer Keys 表格中複製 Client ID 編號。回到 FastComments,將其貼到 Client ID 欄位並點選 Save & Continue。
- 檢查設定摘要,然後點選 Enable Integration 使其上線。
- 在 Canvas 安裝 External App(Admin > Settings > Apps > + App > By Client ID)。留言將會自動顯示在作業下方,且教師可以透過 Rich Content Editor 工具列按鈕,在 Pages、Quizzes 與 Announcements 中嵌入 FastComments。
FastComments 儀表板設定 
前往 LTI 設定
設定頁面使用導引精靈逐步引導。您會從 步驟 1:建立 開始。
建立新的 LTI 設定
填寫以下欄位:
- Configuration Name - 一個可選的標籤,用以識別這個設定(如果您連接多個 Canvas 實例會很有用)。
- Platform URL - 您的 Canvas 實例網址(例如
https://yourschool.instructure.com)。此欄位為必填。
選擇放置位置
在 Platform URL 下方,您可以選擇 FastComments 在 Canvas 課程中的顯示位置。預設會啟用兩個放置位置:
- Assignment View - 評論會自動顯示在作業下方。
- Rich Content Editor Button - 授課者可以使用富內容編輯器工具列按鈕,將 FastComments 嵌入頁面、測驗及公告。
您可以啟用其中一個或兩個。至少需要啟用一個放置位置。
點選 建立設定。
複製設定 URL
建立設定後,精靈會進入 步驟 2:連線。頁面頂端會顯示一個明顯的 設定 URL,並附有 複製 按鈕。
複製此 URL。您在下一步於 Canvas 建立開發者金鑰時會需要用到。
頁面還會顯示在 Canvas 中需執行步驟的編號說明,以及欄位讓您輸入 Client ID 和可選的 Deployment ID(在取得後)。
Canvas 開發者金鑰 
在 Canvas 開啟開發者金鑰
以管理員身分登入 Canvas。前往 管理(在左側邊欄)> 選取您的帳號 > 開發者金鑰。
建立 LTI 開發者金鑰
點選 + Developer Key 並選擇 LTI Key。
在設定表單中:
- 在 Redirect URIs 欄位(左側),貼上從 FastComments 設定頁面複製的 Launch URL。
- 在右側,將 Method 設為 Enter URL。
- 在 JSON URL 欄位貼上您從 FastComments 複製的 Configuration URL。
- Canvas 會自動載入 LTI 設定。
- 為金鑰命名(例如:「FastComments」)。
- 點擊 Save。
啟用開發者金鑰
儲存後,新的金鑰會出現在開發者金鑰表格中,其 State 顯示為 OFF。點擊切換按鈕將其設為 ON。Canvas 可能會提示您確認 — 點擊 Allow 以啟用金鑰。
複製用戶端 ID
開發者金鑰表格在 Details 欄中顯示一個數字 Client ID(例如 17000000000042)。複製此數字 — 您在下一步會需要它。
完成連線 
在 FastComments 中輸入 Client ID
回到 您的 FastComments LTI 設定。設定精靈應該停在 Step 2: Connect。
將從 Canvas 複製的 Client ID 貼到 Client ID 欄位。如您的 LMS 提供 Deployment ID,可選擇輸入。
點擊 Save & Continue。
啟用整合
設定精靈會進入 Step 3: Go Live。畫面會顯示您設定的摘要(名稱、平台 URL、Client ID 和 Deployment ID)。
檢查各項細節,然後點擊 Enable Integration 以啟動 LTI 連線。
啟用後,設定精靈會顯示 Management View,您可以在此編輯設定、查看所有 LTI URL,或新增其他部署。
在 Canvas 中安裝外部應用程式
在 Canvas 中,前往 Admin > 選擇您的帳戶 > Settings > Apps 分頁。
點擊 + App 並設定:
- 將 Configuration Type 設為 By Client ID。
- 從 Developer Keys 表格貼上 Client ID。
- 點擊 Submit。
- 在提示時確認安裝。
FastComments 現已安裝於帳戶層級,並可供所有課程使用。
新增至課程 
留言在您的課程中如何顯示
一旦啟用 LTI 整合並安裝了 External App,FastComments 會根據您設定的 placements 自動運作:
作業檢視
如果啟用了 Assignment View placement,留言會自動顯示在課程中每個作業的下方。學生和講師在檢視作業時會看到一個巢狀留言區 — 每個作業無需額外設定。
每個作業都有自己獨立的留言串。
Rich Content Editor 按鈕
如果啟用了 Editor Button placement,講師可以將 FastComments 嵌入到任何使用 Rich Content Editor 的內容中:
- 編輯 Page、Quiz 或 Announcement。
- 在 Rich Content Editor 工具列中,點擊 FastComments 按鈕。
- FastComments 會自動嵌入到內容中。
- 儲存頁面。
當學生檢視該頁面時,嵌入的 FastComments 小工具會載入該頁面專屬的留言串。
自動 SSO
在兩種 placement 中,學生都會透過其 Canvas 帳號自動登入。姓名、電子郵件和頭像會透過 LTI launch 同步,無需另外登入。
鎖定公開存取(建議)
預設情況下,FastComments 的留言資料是公開可讀的。任何能猜出留言串 URL 或 API endpoint 的人都可以檢視其留言,即使在 Canvas 之外也一樣。對於課程討論,您幾乎肯定會希望將檢視權限限制為僅限已註冊的學生。
開啟您的 widget customization page 並建立一條啟用 Require SSO To View Comments 的規則,然後將安全層級設為 Secure SSO,這樣留言串就只能透過已簽署的 LTI launch 載入。
完整操作說明請參閱 Protecting Comment Threads With Single-Sign-On,包括如何將規則範圍限制在單一網域或頁面。
評論樣式 
FastComments 為您的 Canvas 課程新增討論串留言功能。標準的 FastComments 小工具會顯示在頁面上。使用者可以發表串聯留言、回覆、投票,並使用所有標準功能。
留言會附屬於每個課程頁面或資源連結,因此討論會依頁面、作業或模組保持組織化。
角色映射 
在 LTI 啟動期間,Canvas 的角色會自動對應到 FastComments 的角色。無需手動設定。
角色對應
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| 管理員 | 管理員 | 擁有完整帳戶存取權,可管理所有評論與設定 |
| 教師 | 版主 | 編輯與刪除評論、置頂討論串、管理討論 |
| 學習者 | 留言者 | 發表評論、回覆、投票及使用提及 |
運作方式
當使用者從 Canvas 啟動 FastComments 時,LTI 1.3 協議會包含他們的 Canvas 角色。FastComments 會讀取該角色並自動指派適當的權限。
如果使用者擁有多重角色(例如同時是教師與管理員),系統會採用權限最高的角色。
自訂 
FastComments 設計為可客製化以配合您的網站。
如果您想加入自訂樣式或調整設定,請查看我們的自訂化說明文件以了解如何操作。
網域錯誤 
您可能會遇到授權錯誤,如下所示:
這是因為 FastComments 不知道應該允許您的帳戶在此網域上使用。
在這種情況下,解決方法很簡單。您只需將您的 Canvas 實例網域加入到 FastComments 帳戶中。
加入您的 Canvas 網域(例如 yourschool.instructure.com),評論應該就會正確載入。
在 Canvas 課程中添加投票 
一旦 FastComments 已安裝在您的 Canvas 課程中,您也可以直接在評論中進行即時投票。 在小工具自訂設定中開啟 Enable Polls,投票按鈕就會出現在評論工具列。 投票可設定 2 到 10 個選項,結果會即時更新給頁面上的所有人,您可以決定誰能建立投票以及投票是否需要登入。 在 Canvas 上不需要其他安裝。
Try the Live Polls demo 或閱讀 Polls documentation 以設定它們。