Khắc phục sự cố cho Ứng dụng Học sinh

Hướng dẫn này giúp học sinh, giáo viên và quản trị viên IT giải quyết các vấn đề phổ biến nhất khi sử dụng Ứng dụng Học sinh ELSA School.

1. Điều kiện tiên quyết

1.1 Yêu cầu hệ thống

Danh mục	Yêu cầu tối thiểu
Trình duyệt web	- Chrome ≥ 87 - Firefox ≥ 78 - Safari ≥ 14 - Edge ≥ 88
Hệ điều hành	Bất kỳ OS hiện đại nào hỗ trợ các trình duyệt trên
Độ phân giải màn hình	- Tối thiểu được hỗ trợ: 1024 × 768 - Được khuyến nghị: 1366 × 768 hoặc cao hơn
Băng thông internet	- Tối thiểu: 15–20 Mbps - Được khuyến nghị: 30 Mbps+

1.2 Yêu cầu thiết bị người dùng

Quyền truy cập Microphone phải được cho phép trong trình duyệt.
Thiết bị không được có những vật cản vật lý đối với microphone. Các chứng cản tiềm ẩn:
- Vỏ bảo vệ
- Miếng dán bảo vệ màn hình

1.3 Yêu cầu mạng và bảo mật

IT của trường của bạn nên thêm vào danh sách trắng những điều sau:

Loại cấu hình	Giá trị
Tên miền cần thêm vào danh sách trắng	- b2b-server.elsanow.io - pool.elsanow.io - content-media.elsanow.co - http://student.elsaspeak.com
Cổng (nếu cần thiết)	443 (HTTPS)
WebSocket cần kích hoạt (nếu cần thiết)	wss://pool.elsanow.io

2. Khắc phục sự cố

Dưới đây là các vấn đề phổ biến, lý do của chúng và giải pháp từng bước.

2.1 Microphone không được phép

Lỗi:
"Yêu cầu quyền truy cập Microphone. Vui lòng kích hoạt nó trong cài đặt thiết bị của bạn."

Lý do:
Quyền truy cập Microphone bị từ chối trong trình duyệt.

Giải pháp:

Mở Cài đặt trang web của trình duyệt.
Kích hoạt Microphone cho trang web ELSA.
Tải lại trang.

2.2 Ứng dụng không nhận được giọng nói của học sinh.

Lỗi:

"Bạn có đọc toàn bộ cụm từ không? Thử lại." Xuất hiện liên tục

Lý do:
Ứng dụng không phát hiện được giọng nói của người dùng.

Những nguyên nhân và giải pháp có thể:

Nguyên nhân	Giải pháp
Quyền truy cập Microphone không được cấp	Kích hoạt microphone trong cài đặt trình duyệt.
Microphone bị chặn vật lý	Tháo vỏ bảo vệ/miếng dán bảo vệ màn hình che microphone.
Microphone bị hỏng (tai nghe)	Kiểm tra mà không sử dụng tai nghe hoặc thay đổi tai nghe.
Môi trường ồn ào	Di chuyển đến khu vực yên tĩnh hơn.
Công tắc mic phần cứng bị tắt	Trên máy tính xách tay, kiểm tra xem phím bật tắt mic phần cứng có BẬT không.
PC không phát hiện được đầu vào âm thanh	Mở cài đặt âm thanh thiết bị → đảm bảo mức đầu vào microphone di chuyển khi nói.

2.3 Không thể kết nối với máy chủ

Lỗi:
"Không thể kết nối với máy chủ."

Lý do:
Tường lửa của trường hoặc lọc nội dung đang chặn quyền truy cập vào máy chủ ELSA.

Giải pháp:

Xác minh rằng tất cả các tên miền cần thiết đã được thêm vào danh sách trắng.
Xác nhận rằng lưu lượng truy cập cổng 443 và WebSocket được cho phép.
Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với Hỗ trợ ELSA.

Kiểm tra bổ sung cho môi trường iPad:

Xác nhận xem MDM hoặc lọc nội dung có được cài đặt hay không.
Một số bộ lọc có thể chặn các phương thức HTTP cụ thể (ví dụ: PATCH, PUT).
Kiểm tra xem chế độ khóa có được bật không: https://support.apple.com/en-us/105120
IT có thể cần kích hoạt các phương thức này trong chính sách lọc.

2.4 Không thể xem bài tập mới nhất từ giáo viên

Nguyên nhân có thể	Giải pháp
Học sinh không được đăng ký đúng trong lớp học.	Xác minh học sinh được ghi danh vào lớp học đúng.
Giáo viên giao cho lớp sai hoặc ngày bắt đầu không phải hôm nay.	Xác minh bài tập được giao cho lớp đúng và ngày bắt đầu là hôm nay.
Bộ nhớ đệm trình duyệt đang chặn dữ liệu mới nhất không tải.	Xóa bộ nhớ đệm trình duyệt.
Học sinh đăng nhập bằng tài khoản sai.	Kiểm tra xem học sinh có đăng nhập bằng tài khoản đúng không.

2.5 Ứng dụng chậm hoặc lag

Lý do:
Thông số kỹ thuật của thiết bị không đủ hoặc bộ nhớ đệm đã tích tụ.

Giải pháp:

Chuyển sang thiết bị được hỗ trợ có sức mạnh xử lý hoặc bộ nhớ cao hơn.
Xóa bộ nhớ đệm trong trình duyệt.

2.6 Không thể đăng nhập vào Ứng dụng Học sinh

Lỗi:
"Thông tin xác thực không khớp."

Lý do:
Email hoặc mật khẩu không chính xác.

Giải pháp:

Bấm "Quên mật khẩu" trên trang đăng nhập và đặt lại mật khẩu của bạn.
- Nếu bạn sử dụng email trường của riêng bạn, hãy nhập email đó và kiểm tra hộp thư của bạn để tìm liên kết đặt lại.
Nếu bạn sử dụng bí danh như xxxxx@elsaspeak.com, hãy thông báo cho giáo viên của bạn liên hệ với Hỗ trợ Khách hàng ELSA để đặt lại mật khẩu.
Nếu bạn sử dụng bí danh như elsa_001@k12.elsanow.io, vui lòng thông báo cho giáo viên của bạn.
- Giáo viên của bạn có thể đặt lại mật khẩu của bạn trực tiếp thông qua bảng điều khiển quản trị viên.

Lỗi:
"Tài khoản của bạn không hoạt động. Vui lòng liên hệ với giáo viên của bạn."

Lý do:
Tài khoản học sinh được đánh dấu là không hoạt động trong bảng điều khiển quản trị viên.

Giải pháp:

Giáo viên nên kích hoạt lại tài khoản trong bảng điều khiển quản trị viên.
Nếu tài khoản đã hoạt động, hãy liên hệ với Hỗ trợ ELSA.
- Học sinh có thể không hoạt động trong tổ chức khác, điều này cần được sửa chữa từ phía ELSA.

2.7 Read Aloud không lưu được bản ghi âm

Lỗi:

"Lỗi nội bộ" xuất hiện khi kết thúc bản ghi âm trong Read Aloud.

Lý do:
Có lỗi xảy ra khi xử lý bản ghi âm.

Những nguyên nhân và giải pháp có thể:

Nguyên nhân	Giải pháp
Bản ghi âm quá ngắn (dưới 3 giây).	Đọc theo văn bản và nói lâu hơn. Không dừng bản ghi âm trước khi hoàn thành văn bản.
Đoạn văn bản chứa dấu chấm câu hoặc ký hiệu mà hệ thống không nhận diện.	Trong bảng điều khiển quản trị viên, hãy loại bỏ tất cả dấu chấm câu hoặc ký hiệu khác ngoài dấu phẩy và dấu chấm để xem lỗi có biến mất sau khi giao lại bài tập không.
Có sự cố kết nối với máy chủ.	Đăng xuất và đăng nhập lại. Thử lại vào thời điểm khác.

3. Khi nào liên hệ với Hỗ trợ ELSA

Sau khi hoàn thành các bước trên, hãy liên hệ với ELSA thông qua Biểu mẫu báo cáo (https://forms.gle/beGvWffUr8A6nKiE6) nếu:

Vấn đề vẫn tiếp diễn trên nhiều thiết bị
Học sinh không thể sử dụng ứng dụng mặc dù cài đặt đúng