如何將 BigBlueButton 與 Moodle LMS 整合（逐步指南）

簡答：在 Moodle 4.0 或更高版本中，通常無需單獨安裝 BigBlueButton 活動外掛程式。如果您的網站已停用內建活動，請啟用它，然後在網站設定中輸入 BigBlueButton 伺服器 URL 和共用金鑰，之後將 BigBlueButton 活動新增至課程中，並分別與教師和註冊學生進行測試。您需要一個可用的 BigBlueButton 服務以及從其提供者或伺服器管理員取得的憑證；單獨安裝 Moodle 活動並不會建立視訊會議伺服器。

本指南涵蓋標準的 Moodle 活動集成，而非單獨的 LTI 部署。以下標籤和選單路徑在不同的 Moodle 版本或主題之間可能略有不同。介面面板僅用於展示設定和工作流程，並非實際 Moodle 安裝的螢幕截圖。

我還需要安裝其他Moodle插件嗎？

通常情況下不需要。 Moodle 在 4.0 版本中將 BigBlueButton 作為核心插件整合。在 Moodle 4.0 到 5.2 版本中，管理員可能需要在「網站管理」>「外掛程式」>「管理活動」下啟用它，並接受資料處理協議。 Moodle 5.3 文件指出，新安裝的網站預設為啟用此活動，但管理員仍需要輸入伺服器 URL 和共用金鑰；在此之前，活動選擇器可能會顯示 BigBlueButton 不可用。如果您的網站版本早於 Moodle 4.0，請在安裝單獨的插件副本之前，檢查插件版本是否與您的 Moodle 版本相符。請勿在新網站上安裝重複的活動模組。有關核心插件的歷史記錄，請參閱Moodle 的 BigBlueButton 升級說明；有關當前活動行為，請參閱 Moodle 5.3 BigBlueButton 文件。

安裝前我需要準備些什麼？

• BigBlueButton 服務：可以是貴組織運作的伺服器，也可以是允許 Moodle 整合的託管服務。
• 伺服器 URL 和共用金鑰：請諮詢您的服務提供者或伺服器管理員。如果您管理的是相容的自託管 BigBlueButton 伺服器，則其管理員可以sudo bbb-conf --secret在該伺服器上執行命令。該命令會列印 URL 和 API 金鑰。
• Moodle 管理員權限：只有網站管理員才能更改網站範圍的伺服器憑證；課程教師可以在活動啟用後新增該活動。
• 測驗課程和測驗帳號：使用一個教師或管理員帳號和一個註冊該課程的學生帳號。

URL 是 BigBlueButton 提供的用於 API 整合的伺服器位址，通常以 `.bigBlueButton.server` 結尾/bigbluebutton/。請完全複製提供者的值，包括 `.bigBlueButton.server`https://和末尾的斜杠，不要自行猜測/api路徑。共用金鑰用於對伺服器間的 API 請求進行簽署。請務必妥善保管：BigBlueButton 的 API 安全指南建議不要在瀏覽器端 JavaScript 或公開課程內容中揭露金鑰。如果您使用託管服務的憑證，該提供者可能會設定自己的參與者、錄製或會話限制。

如何將Moodle連接到BigBlueButton伺服器？

1. 檢查 Moodle 版本並啟用該活動

以網站管理員管理登錄，並在網站通知或系統資訊頁面確認 Moodle 版本。如果 BigBlueButton 活動被停用，請從活動管理頁面啟用它。在 Moodle 4.0 至 5.2 版本中，Moodle 的升級說明指出，該核心活動預設為停用狀態，管理員必須接受資料處理協定才能啟用它。在新的 Moodle 5.3 網站中，該活動應顯示為已啟用，但如果缺少憑證，則可能仍然無法在選擇器中找到它。選單位置可能有所不同；如果標籤與您的主題不匹配，請使用網站管理搜尋“BigBlueButton”。

2. 輸入伺服器 URL 和共用金鑰

從網站管理介面開啟 BigBlueButton 設置，通常位於「外掛程式」或「外掛程式 > 活動模組」下。找到BigBlueButton 伺服器 URL和BigBlueButton 共享金鑰的常規設定。貼上服務提供者或伺服器管理員提供的值，然後儲存變更。 Moodle 5.3 文件介紹如何從 BigBlueButton 設定頁面輸入這些憑證；在早期版本中，具體的導航標籤可能有所不同。

自託管服務，請將 Moodle 中的值與 BigBlueButton 伺服器上報告的 URL 和金鑰進行比較。請勿隨意重新產生或變更伺服器金鑰以進行故障排除：使用該伺服器的每個前端都必須更新為新值。此密鑰並非學生密碼，不得包含在活動歡迎訊息中。 BigBlueButton 在其伺服器自訂指南和BigBlueButton API 安全文件中解釋了共享金鑰如何驗證 API 呼叫。

3. 在課程中加入測試活動

開啟您擁有編輯權限的課程並啟用編輯模式。在目標部分，選擇「新增活動或資源」，然後選擇BigBlueButton。如果找不到該插件，請返回步驟 1 中的站點層級檢查，而不是嘗試新增其他插件。使用明確標記的臨時會話，例如“BBB 連接測試”，以免學生誤認為是正式課程。

4. 確定會議詳情和日程安排

為活動取一個易於識別的名稱，並添加簡短描述，說明房間的用途。歡迎訊息是可選的。決定是否啟用「等待主持人」功能：啟用後，學生將等待具有主持人角色的使用者進入。如果課程有特定的開始或結束時間，請設定時間表並檢查課程時區。除非您的機構明確允許，否則請勿向訪客開放測試活動；在設定過程中，僅允許註冊用戶存取更容易控制。

最初請使用預設的參與者角色。如果教師需要主持討論室，請在測試前確認其帳戶在 Moodle 課程中擁有相應的角色。訪客連結和外部存取有單獨的網站層級限制，當 Moodle 網站要求使用者登入時，這些連結和存取可能無法使用。

如何驗證該整合對學習者是否有效？

5. 儲存活動並確認已顯示在課程中

儲存活動並返回課程頁面。確認活動名稱及安排時間是否正確。如果活動被隱藏、超出可用時間範圍或受群組或存取權限限制，即使伺服器連線正常，學生也可能無法看到該活動。在診斷 BigBlueButton 伺服器之前，請先檢查活動的可見性和課程註冊。

6. 以教師身分加入並檢查音訊存取權限

以教師或主持人身分開啟測驗活動。當房間提示連接音訊時，請選擇「麥克風」測試口語和聽力，或選擇「僅收聽」（如果您在沒有麥克風的情況下檢查回放）。出現提示時，允許瀏覽器存取麥克風。瀏覽器權限被拒絕與 Moodle 憑證錯誤不同：如果房間已開啟但音訊失敗，請先檢查瀏覽器的網站權限和所選音訊設備。

7. 使用已註冊的學生帳號再次加入

使用第二個瀏覽器帳號或另一台裝置以已註冊學生的身分登錄，並開啟相同活動。確認學生是否可以立即進入，或是否出現預期的等待主持人加入的提示。檢查參與者是否出現在房間內，以及簡短的聊天或語音測試是否有效。此測驗比管理員啟動測驗更具驗證性，因為學生可見性、課程註冊、群組限制和主持人設定都可能影響結果。

8. 僅當您的裝置支援時才檢查錄製內容

錄製功能是可選的，具體取決於伺服器、活動設定、權限和服務計劃。如果啟用了錄製功能，請進行簡短的測試錄製，正常結束會議，並檢查錄製連結是否對目標 Moodle 角色可用。錄製內容可能不會立即顯示；Moodle 的升級文件指出，錄製元資料任務可以非同步運行，並且在文件所述的升級方案中，Moodle 的 cron 任務必須運行才能進行與錄製相關的處理。對於目前的 cron 任務運行情況，在斷定整合本身發生故障之前，請檢查 Moodle 的排程任務狀態以及您的服務提供者的錄製策略。

如果Moodle無法連線或學生無法加入怎麼辦？

如果 Moodle 報告無法進入房間，請先檢查 URL、共用金鑰和伺服器是否可達。 Moodle 舊版故障排除頁面記錄了這些常見原因；您可以將其用作診斷清單，同時從您目前的提供者取得實際憑證，而不是複製舊版測試伺服器的值。對於自管理伺服器，BigBlueButton 管理員也可以從伺服器端檢查服務。請勿在螢幕截圖、支援貼文和公開日誌中洩漏共享金鑰。

最終設定清單

• Moodle 版本和活動模組狀態已知。
• 正確的 BigBlueButton 端點和共享金鑰已保存在站點設定中。
• 活動會出現在課程中，測試學生可以看到。
• 教師和註冊學生可以按預定角色加入。
• 至少有一名參與者可以在瀏覽器中正常聆聽音訊。
• 只有當錄製回放是服務的一部分時，才會單獨測試錄製回放功能。

成功整合意味著 Moodle 可以為正確的課程使用者建立並啟動會話，而不僅僅是選擇器中存在 BigBlueButton 活動。如果教師啟動成功，但學生、媒體或錄音內容失敗，請分別排查這些權限或服務層的問題，而不是重複重新安裝 Moodle 的核心活動。