一堂課系統說明

快速開始

教師：建立第一堂課

1. 開啟首頁，按「🔑 老師登入」，輸入管理者提供的教師建立密碼。
2. 按「＋ 新增看板」，填寫名稱，設定本看板的管理密碼；需要限制學生加入時，可另外設定加入密碼。
3. 進入看板，按「分享 / QR」，將看板網址或QR碼提供給學生。
4. 按「📌 置頂訊息」發布本課主題；學生可用右下角「✏️ 貼一張」參與。
5. 需要示範時，直接按看板上方「🖥 分享老師畫面」。

學生：加入課堂

1. 開啟老師提供的看板網址或掃描QR碼，依提示輸入加入密碼。
2. 按「暱稱」設定老師要求的名稱或座號。若看板有名單限制，依老師指定的座號加入。
3. 閱讀置頂重點，按「貼一張」發表內容，或依老師指示回覆、留言與使用白板。

一般貼文互動只需瀏覽器。全班畫面、Windows桌面通知與遠端操作需要安裝學生端；觀看老師網頁廣播則需開著同一看板。

登入與權限

學生不需知道教師或管理密碼。若教師工具沒有出現，先確認已進入正確看板，並取得該看板管理權限。不同瀏覽器或裝置可能需要重新登入。

看板與貼文

首頁可選擇課堂看板；教師可建立或匯入看板，並在「看板設定」調整課堂規則。各看板的內容與管理權限分別保存。

• 發表：學生按「貼一張」，依畫面提供的欄位加入文字、圖片或其他支援的內容。
• 整板搜尋與統計：搜尋內容或作者、切換排序時，系統會查詢整面看板，再分頁顯示；不必先按「載入更多」。搜尋結果數與整板貼文、留言、反應統計會分別標示。只能搜尋與統計自己有權查看的資料，匿名與先答後看限制仍有效。
• 工具列：常用的分享、共用白板與教師畫面分享留在主畫面。「展示與檢視」收納全板詞雲、幻燈片、小組計分與列印；教師的「班級工具」收納分組、桌面訊息、全班畫面與看板設定。「管理與匯出」提供審核、計時、參與統計與備份。
• 完整展示與列印：詞雲、小組計分、抽籤、幻燈片及「列印全板 / PDF」會先讀完全部可見貼文，不受目前搜尋條件影響。畫面會顯示讀取進度；讀取失敗時請按重試，已開啟的展示為快照。詞雲與計分可按更新取得新資料。完整列印會先等待圖片載入，建議使用「展示與檢視 → 列印全板 / PDF」。
• 操作與連線狀態：一般操作訊息、連線狀態、整板統計與「載入更多」集中在貼文區下方，成功訊息只保留最新一則簡短文字。錯誤會短暫提示，詳細原因與重試按鈕保留在下方；編輯視窗內仍顯示送出與上傳狀態。上傳成功仍須按送出才算繳交；送出失敗保留草稿，可在原視窗重試。斷線逐步延長重試間隔，連回後重新核對貼文。也可按「重新連線」。若離線，請先保留編輯視窗。
• 先答後看：教師按看板內「📝 作答與繳交」，啟用學生身分與繳交進度，並勾選先答後看。揭曉前，學生只能查看自己的貼文；送出後仍須等待教師按「全班揭曉」。待審貼文不會因揭曉而自動核准。教師可用原有的置頂訊息與看板描述提供題目。
• 繳交進度：至少送出一張貼文即算已交，待審也計入；刪除自己的所有貼文後回到未交。同名學生以座號或獨立學生身分區分，同一學生使用多個裝置只計一人。有班級名單時，未曾進入的學生也列入未交；無名單時只統計已登記的身分。教師可展開「裝置歸屬與舊資料修正」，確認後手動指定舊裝置與歷來貼文的學生歸屬。
• 換裝置與共用電腦：學生的登記與繳交狀態整合在上方工具列的單一按鈕；首次登記後，點「尚未繳交」或「已繳交」即可查看身分與換機代碼。換裝置時輸入代碼連結，請勿分享。座號初次登記不等同本人認證；座號已登記但沒有代碼時，請老師協助確認或重設。共用電腦換人時，先在身分視窗按「換另一位學生使用」，避免沿用前一位學生身分。
• 草稿保存：新增與編輯貼文會自動保存本機草稿，依看板、學生與編輯目標分開。重新開啟相同編輯視窗會恢復草稿；送出成功才清除，取消與送出失敗仍保留。只有完成上傳的附件網址會保存，尚未上傳的檔案與錄音須重新選取。草稿不會跨裝置同步；清除瀏覽器資料也會清除草稿。
• 互動：使用留言、回覆及老師開放的課堂工具。是否能發文、編輯或繪製白板，依看板設定而定。
• 👥 分組管理：教師在看板上方按「分組管理」設定組別與學生，可教師指定、隨機平均分組或開放學生自選。貼文共編、組別計分及小組白板共用一份組員名單；每組自動對應一張白板。學生需先進入同一看板，才會出現在名單中。第一次開啟會帶入原有看板與白板分組供教師確認；儲存不會開始活動或切換學生畫面。若名單衝突，先帶入原教師指定的白板組別。組別改名保留原筆畫；移除組別後，舊白板仍供教師查看。
• 多頁與分組白板：教師開啟共用白板後，可在「頁面管理」新增全班頁；組別與組員一律由「分組管理」調整。按「開始分組活動」，學生自動進入自己的小組頁共同編輯；教師可留在白板內切頁巡組，不會切換學生畫面。按「結束分組活動」，學生編輯立即暫停，全班同步觀看教師目前頁面；之後教師切頁，全班也跟隨。再次開始活動可繼續編輯，原有筆畫會保留。學生自選組別在活動開始後鎖定，由教師調整。未分組學生留在全班共用頁等待指定。語音仍為全班收聽。
• 查看同組成員：學生按上方的組別按鈕（例如「👥 第一組」），可在「我的組別」查看同組名單，自己的項目會標示「你」。有已登記學生身分時顯示座號，同一身分在同組的多個裝置合併列出；未連結身分者暫依裝置分開，同名不會自動合併。只提供同組成員，不列出其他組的學生；匿名看板則隱藏其他組員姓名。老師調整組別後，可按「更新名單」取得最新資料。
• 教師退出與活動暫停：教師結束展示後，學生可關閉白板或自行切頁；如果已按「結束分組活動」，學生編輯仍維持暫停，直到教師再次開始活動。學生裝置必須先進入看板，由教師指定組別；更換瀏覽器或裝置需重新指定。教師直接關閉瀏覽器或斷線時，展示授權最長90秒後到期，學生端再核對更新。
• 暫停發文：若看到「暫停發文中」，等老師重新開放即可，不需重新安裝程式。
• 備份：教師可使用管理功能匯出看板，之後以首頁「匯入看板」還原。請妥善保管匯出的課堂資料。

置頂訊息、連結與文字特效

1. 在看板上方按「📌 置頂訊息」。
2. 輸入課堂重點，調整文字大小與顏色；內文的完整 https:// 或 http:// 網址會自動變成超連結，也可另外填寫教材連結。
3. 選擇靜態、跑馬燈、柔和閃爍或呼吸光暈，並設定速度，從預覽確認效果。
4. 按「發布／更新置頂」。訊息橫放在所有貼文上方，持續顯示至老師更新或移除。

置頂訊息不另設特效控制按鈕。滑鼠停留在跑馬燈上，或以鍵盤聚焦其中連結時，會暫停移動，方便閱讀與點選。裝置設定減少動態效果時，改為靜態顯示。置頂訊息不需學生按確認，重新整理仍會保留。

教師畫面廣播與講解

1. 取得看板管理權限後，按上方獨立的「🖥 分享老師畫面」。
2. 在開始分享視窗勾選「分享影片／電腦聲音」，需要講解時另勾「同時開啟麥克風講解」，再按「開始分享」。麥克風不會預設開啟。
3. 播放網頁影片時，建議在瀏覽器選擇影片所在的「分頁」，並勾選「分享分頁音訊」。分享整個螢幕或視窗能否取得聲音，取決於瀏覽器與作業系統；未勾選或不支援時，教師畫面會顯示「未取得分享音訊」。
4. 學生需開啟同一看板，才能在網頁中接收廣播。
5. 分享中仍可開關廣播麥克風與分享音訊。麥克風須允許收音；關閉麥克風不會中斷影片聲音。教師聲音狀態會明確顯示正在傳送的來源，連線失敗可按「重試聲音」。也可從「置頂訊息」底部展開「老師畫面分享與語音講解」控制。
6. 學生若看得到畫面卻沒有聲音，先查看「老師分享聲音」播放器；瀏覽器若阻擋自動播放，請按「播放聲音」，並確認電腦音量。老師自己的預覽不播放回自己的分享聲音，避免回音。
7. 結束時按「停止畫面分享」，或使用瀏覽器提供的停止分享按鈕。

這是教師單向講解；學生要與老師雙向通話，請使用個別協助。置頂訊息與畫面分享各自控制，停止畫面不會移除置頂。建議使用耳麥，避免回音。

畫面分享需要HTTPS或本機測試環境，以及支援分享功能的瀏覽器。手機請使用Android教師App的「手機廣播」。

Windows學生端安裝與配對

1. 從本系統「程式下載」下載完整 Windows 串流學生端ZIP，先全部解壓縮，保留EXE、DLL與隨附文件。
2. 執行 OneLessonStudent.exe，確認伺服器網址正確，填寫電腦名稱或座號。
3. 需要加入教室時，輸入老師提供的教室配對碼，按「連線／配對」。只使用個別求助時，可留空教室碼。
4. 若要登入Windows後自動啟動，由使用者勾選對應選項。關閉主視窗會縮至系統列；完全結束請從系統列選擇退出。

學生端需要.NET Framework 4.8。更新前先退出舊程式，再解壓縮新版；不要只替換串流包中的單一EXE。配對碼、求助碼、固定裝置碼與控制密碼用途不同，請依老師指示填寫。

查看全班畫面

1. 教師進入看板，按「全班畫面」，產生教室配對碼。
2. 學生安裝並開啟學生端，以該教室碼連線。
3. 教師在「全班畫面」開始查看，依裝置狀態確認是否連線與分享。
4. 課程結束後停止查看。學生亦可使用本機的停止控制。

不同看板的教室配對分開管理。網頁顯示的裝置數不等於實際學生人數；未安裝、未連線或未配對到該教室的電腦，不會自動出現。

個別協助、問題與遠端操作

學生發起求助

1. 在學生端按「請老師協助」，將顯示的短效求助碼提供給老師。
2. 可用「傳送問題（文字／語音）」補充問題。錄音需由學生主動開始，可停止、試聽後再傳送。
3. 老師接入後，學生端會顯示分享狀態。需要回話時，主動開啟學生端麥克風。

教師接入與操作

1. 登入後按「個別協助」，輸入學生的求助碼，按「開始協助」。
2. 查看學生畫面與問題；需要講解時，按「開啟我的麥克風」，可進行雙向通話。
3. 需要控制滑鼠鍵盤時，按「請求遠端操作」，等學生在本機同意。只看畫面不等於已取得操作權限。
4. 結束時按「結束協助」。學生亦可在本機停止操作或結束分享。

Windows學生端將停止操作與停止分享集中在同一工具列，可拖曳移動或收合；收合後仍保留停止入口。

固定連線自己的電腦

先在該電腦學生端設定固定裝置連線與獨立控制密碼，再由教師端勾選固定裝置模式，填入裝置碼與控制密碼。預設仍需學生確認；免確認僅適用於在本機明確啟用的指定個人電腦。教室配對碼不能代替每台裝置的控制密碼。

桌面訊息

「桌面訊息」提供已安裝並配對學生端的裝置通知，可依介面選擇對象、確認或回報方式。與置頂訊息的差別如下：

• 置頂訊息：顯示在看板上方，適合課堂主題、重點與教材連結，學生需開著看板。
• 桌面訊息：由Windows學生端接收，瀏覽器關閉仍可收到；學生端需持續執行並連線。
• 畫面廣播：分享教師的示範畫面，可搭配單向麥克風講解。

Android教師端與手機廣播

目前下載版本為v0.4.1，修正內部收音額外等待可能造成的緩衝堆積與丟樣；手機原生廣播新增內部聲音，並包含三種畫質與斷線重連；這些功能需要覆蓋更新APK。看板的先答後看、繳交進度、草稿、整板搜尋與工具列更新由網站提供，網站部署新版後在App按「重整」即可取得；重整會結束目前協助、語音或手機廣播，請先保存內容。v0.2.0或更早版本仍應覆蓋更新APK，取得停止廣播的原生修正。

App目前沒有原生列印／PDF整合，需改用手機Chrome或電腦瀏覽器開啟同一看板並重新登入管理權限。App與瀏覽器的登入、草稿分開保存，請勿為更新網站而解除安裝或清除App資料。

1. 從「程式下載」安裝Android教師APK，開啟後登入並進入課堂看板。
2. 查看學生問題時，可用「個別協助」接入；取得操作允許後，以畫面下方觸控工具操作，中文可透過文字欄傳送。
3. 示範手機操作時，按App上方「手機廣播」，Android 10以上播放影片可勾選「分享裝置內部聲音（影片／音樂）」，需要講解時另勾麥克風；允許錄音權限，再完成Android系統的分享確認。
4. 要切換其他App示範，請選擇分享整個螢幕。從通知列或App內停止廣播；鎖定手機會停止分享。

Android版需要Android 8以上；使用手機廣播的權限由系統詢問。內部聲音需要Android 10以上、勾選選項及來源App允許擷取；麥克風僅在勾選時開啟。部分受系統保護的畫面可能無法分享。

區網版使用方式

區網版由教室主機獨立提供課堂服務。教師與學生需連上可到達主機的網路，開啟主機顯示的HTTPS網址。一般操作與線上版相同。

教室管理者

1. 解壓縮可攜包，放入有效的 license.key，依隨附README設定主機固定IP與HTTPS。
2. 使用內部CA時，確認並安裝教室公開根憑證；使用公信CA時，主機名稱需符合憑證且可在教室網路解析。
3. 依README設定教室網路連線，再執行「啟動.bat」。主機的 /connect 頁提供連線QR碼與下載入口。
4. 完整保管主機設定、憑證與資料目錄。升級前停止主機並備份，不要覆寫既有設定或資料。

Windows與Android

Windows學生從區網主機下載完整ZIP與 classroom.json，將設定放在EXE同一資料夾再啟動。Android請使用區網教師APK，按「主機」填入教室HTTPS網址；內部CA須先在手機安裝並信任。

學生只需取得公開根憑證，不需主機管理密碼、伺服器私鑰或CA私鑰。區網課堂與影音由本機提供，外部影片、網頁與連結內容仍可能需要網際網路。

開板模式與班級帳號

教師建立班級

1. 建立課堂看板後，開啟「管理與匯出 → 班級與學生帳號」，建立班級，或使用班級代碼與班級管理密碼綁定既有班級。
2. 貼上每行「01=姓名」的名單，產生學生初始密碼。下載本次帳密CSV並私下分發；初始密碼只顯示這次，遺失可個別重設。不要把班級管理密碼交給學生。
3. 同一班級可綁定多塊看板；學生以相同帳號換機，不需換機代碼，同名也不會合併。既有座號重新匯入只更新姓名，不改密碼。
4. 教師可重設密碼、停用及恢復帳號；學生可從帳號視窗變更密碼。登入最長八小時，密碼異動會使舊登入失效。

共用電腦換人時務必登出，教師交給學生前也須退出管理。登出會關閉白板與影音，未儲存的繪圖請先保存。學生密碼與登入權杖不存入瀏覽器本機儲存；教師看不到舊密碼，只能重設。

共用進板密碼

匿名板及教學部落格可在「管理與匯出 → 看板設定」設定加入密碼。留空保留原密碼，勾選清除才取消。此密碼只用於進板，不授予管理權，也不等於班級帳號密碼。

部落格管理與舊看板

「留言審核與禁言」可核准、刪除留言並限制參與者。每篇文章可關閉留言；看板總開關關閉時，所有文章都停止接受非教師留言。訪客只依瀏覽器識別，若需嚴格管理請關閉訪客留言，只接受登入學生。

舊看板保留原行為；改為課堂後，舊作答須由教師在班級管理確認連結，不依姓名合併。有課堂資料的看板不能直接改公開；請用「複製教材建立部落格」，逐項確認教材可公開。只複製教師教材與獨立附件，不帶學生作答、留言或帳號資料。模式切換前須停止影音分享。

JSON備份不含班級密碼或登入權杖。還原課堂後須重新授權綁定班級，並確認連結舊紀錄；區網版與線上版帳號各自保存，不會自動同步。

教材與多檔附件

刪除貼文時，系統會同步清除能確認歸屬、且不再被其他貼文或白板使用的圖片、錄音與檔案，並釋放容量。共用附件會保留。刪除前會提示無法復原；若伺服器暫時無法清理，會顯示提醒，保留紀錄供後續清理。既有超過3個附件的學生貼文仍可閱讀，不會自動移除；學生編輯附件時須減至3個。教師仍可使用10個。

老師可從「看板設定」按「清理未使用附件」，清理上傳超過一天、未被貼文或白板引用的舊檔案；未發布草稿中的舊附件也可能被清除，請先發布需要保留的草稿。編輯貼文時移除附件或取消草稿不會立即刪除伺服器檔案，可由此功能清理。

教師新增或編輯貼文時勾選「📚 列為教材」，學生可由看板上方「📚 教材」集中查看，再按一次返回全部貼文。既有貼文也能編輯後指定為教材。教材沿用原貼文，不需重複上傳；先答後看期間，已公開教材仍可閱讀，學生答案繼續隱藏。請勿將尚未要公布的答案列為教材。

• 教師每則貼文最多10個檔案、學生最多3個檔案，每個上限30MB。可一次多選、拖入多個，或分次追加；圖片仍有獨立的6張額度。
• 檔案上傳後可改顯示名稱、調整順序或移除；超過3個附件時預設收合。失敗檔案可逐一重試或移除，成功檔案不用重傳。檔案全部處理完畢後，仍須按「貼上牆」或「儲存」。
• 教師編輯視窗會顯示看板剩餘空間；圖片、錄音和檔案共用容量。草稿保留已上傳附件、名稱、順序與教材勾選；未上傳成功的檔案需重新選取。
• 內文或參考網址中的YouTube影片連結會顯示縮圖。點「播放影片」才載入播放器，必要時再按播放器播放鍵；不自動播放。多支影片先顯示第一支，其餘可展開；也能「到YouTube開啟」。無法取得縮圖時仍保留播放按鈕與外連。
• YouTube縮圖和播放需要網際網路，區網主機不會代存YouTube影片。影片若限制嵌入，請使用外連；HTML附件維持沙盒隔離與學生先審機制。看板備份與ZIP匯出會包含多檔附件，JSON還原保留教材標記。

常見問題

Android原生廣播 v0.3.0

安裝新版APK後，進入自己有管理權限的看板，按App上方「手機廣播」，選擇「教材文字」「影片流暢」或「省流量」，再決定是否開啟麥克風，並確認Android本次分享授權。教材文字最高長邊1920／短邊1080、15fps；影片流暢使用相同尺寸上限、30fps；省流量最高長邊1280／短邊720、10fps。保留來源比例、不放大，實際品質依手機與網路而定。

畫面及麥克風各自重試，間隔1、2、4、8秒後最高10秒；沿用本次擷取及廣播識別，不延長原最長30分鐘期限。鎖定、系統撤銷分享、明確停止、權限失效或20秒無法驗證授權就停止，不會自動重新開始。圖片備援會縮小後傳送，省流量模式最多每2秒一張。v0.4.0另增內部音訊選項：Android 10以上且來源允許時可擷取影片／音樂。狀態會顯示是否偵測到內部聲音，學生須按「播放聲音」；未偵測到時請確認影片正在播放及來源限制。內部收音不會自行開啟麥克風；兩者混音建議使用耳機。