學生應用程式故障排除

本指南幫助學生、教師和 IT 管理員解決使用 ELSA School 學生應用程式時遇到的最常見問題。

1. 先決條件

1.1 系統要求

類別	最低要求
網頁瀏覽器	- Chrome ≥ 87 - Firefox ≥ 78 - Safari ≥ 14 - Edge ≥ 88
作業系統	任何支援上述瀏覽器的現代作業系統
螢幕解析度	- 最低支援：1024 × 768 - 建議：1366 × 768 或更高
網際網路頻寬	- 最低：15–20 Mbps - 建議：30 Mbps+

1.2 用戶裝置要求

瀏覽器中必須允許麥克風權限。
裝置不應有物理障礙物阻擋麥克風。可能的阻礙物：
- 保護殼
- 螢幕保護貼

1.3 網路和安全要求

您的學校 IT 部門應將以下項目加入白名單：

設定類型	值
要加入白名單的網域	- b2b-server.elsanow.io - pool.elsanow.io - content-media.elsanow.co - http://student.elsaspeak.com
連接埠（如需要）	443 (HTTPS)
要啟用的 WebSocket（如需要）	wss://pool.elsanow.io

2. 故障排除

以下是常見問題、原因及逐步解決方案。

2.1 麥克風未允許

錯誤：
「需要麥克風存取權限。請在您的裝置設定中啟用它。」

原因：
瀏覽器中拒絕了麥克風權限。

解決方案：

開啟瀏覽器網站設定。
為 ELSA 網站啟用麥克風。
重新載入頁面。

2.2 應用程式無法拾取學生的聲音。

錯誤：

「您是否讀完了整個短語？請重試。」反覆出現

原因：
應用程式未檢測到用戶的聲音。

可能原因及解決方案：

原因	解決方案
未授予麥克風權限	在瀏覽器設定中啟用麥克風。
麥克風被物理阻擋	移除覆蓋麥克風的保護殼/螢幕保護貼。
故障麥克風（耳機）	不使用耳機進行測試或更換耳機。
噪音環境	移動到更安靜的區域。
硬體麥克風開關已禁用	在筆記型電腦上，檢查硬體麥克風切換鍵是否為開啟。
PC 未檢測到音訊輸入	開啟裝置音效設定 → 確保說話時麥克風輸入級別移動。

2.3 無法連接到伺服器

錯誤：
「無法連接到伺服器。」

原因：
學校防火牆或內容篩選正在阻止對 ELSA 伺服器的存取。

解決方案：

驗證所有必需的網域是否都加入了白名單。
確認允許連接埠 443 和 WebSocket 流量。
如果問題仍然存在，請聯絡 ELSA 支援。

iPad 環境的其他檢查：

確認是否安裝了 MDM 或內容篩選。
某些篩選器可能會阻止特定的 HTTP 方法（例如 PATCH、PUT）。
檢查是否啟用了鎖定模式：https://support.apple.com/en-us/105120
IT 部門可能需要在篩選策略中啟用這些方法。

2.4 無法看到來自教師的最新任務

可能原因	解決方案
學生未在班級中正確註冊。	驗證學生是否已在正確的班級中註冊。
教師指派到了錯誤的班級或開始日期不是今天。	驗證任務是否分配給了正確的班級，以及開始日期是否為今天。
瀏覽器快取阻止了最新資料的載入。	清除瀏覽器快取。
學生使用了錯誤的帳戶登入。	檢查學生是否使用了正確的帳戶登入。

2.5 應用程式速度緩慢或延遲

原因：
裝置規格不足或快取積累。

解決方案：

切換到具有更高處理能力或更多記憶體的支援裝置。
清除瀏覽器快取。

2.6 無法登入學生應用程式

錯誤：
「認證不符。」

原因：
電子郵件或密碼不正確。

解決方案：

點擊登入頁面上的**「忘記密碼」**並重設您的密碼。
- 如果您使用自己的學校電子郵件，請輸入該電子郵件並檢查您的收件匣以獲取重設連結。
如果您使用別名例如 xxxxx@elsaspeak.com，請通知您的教師聯絡 ELSA 客戶支援以重設密碼。
如果您使用別名例如 elsa_001@k12.elsanow.io，請通知您的教師。
- 您的教師可以直接透過管理員儀表板重設您的密碼。

錯誤：
「您的帳戶處於非使用狀態。請聯絡您的教師。」

原因：
學生帳戶在管理員儀表板中被標記為非使用狀態。

解決方案：

教師應在管理員儀表板中重新啟用該帳戶。
如果該帳戶已處於使用狀態，請聯絡 ELSA 支援。
- 學生可能在另一個組織中處於非使用狀態，需要在 ELSA 端進行更正。

2.7 朗讀無法儲存錄音

錯誤：

_「內部錯誤」_在朗讀完成錄音時出現。

原因：
處理錄音時發生錯誤。

可能原因及解決方案：

原因	解決方案
錄音太短（少於 3 秒）。	跟著文本朗讀並延長時間。在完成文本前不要停止錄音。
文本段落包含我們的系統無法識別的標點符號或符號。	在管理員儀表板中，移除除逗號和句號外的所有其他標點符號或符號，以查看在重新指派任務後錯誤是否消失。
連接到伺服器時遇到麻煩。	登出並重新登入。稍後再試一次。

3. 何時聯絡 ELSA 支援

完成上述步驟後，如果出現以下情況，請透過此報告表單（https://forms.gle/beGvWffUr8A6nKiE6）聯絡 ELSA：

問題在多個裝置上持續存在
學生儘管設定正確但仍無法使用應用程式