Xử lý sự cố | Luyện đàn Piano

14. Xử lý sự cố

Cách chẩn đoán chung

Khi gặp lỗi, hãy thực hiện theo thứ tự sau:

Kiểm tra bạn đang đăng nhập đúng tài khoản.
Ghi lại màn hình, thao tác vừa thực hiện và thời điểm xảy ra lỗi.
Tải lại dữ liệu hoặc mở lại đúng khu vực đang dùng.
Kiểm tra mạng, quyền trình duyệt và trạng thái thiết bị nếu có liên quan.
Chỉ thử lại thao tác sau khi trạng thái đã tải xong.

Không bấm gửi/lưu liên tục, không xóa dữ liệu trình duyệt hoặc reset tiến trình trước khi xác định nguyên nhân.

1. Đăng nhập và tài khoản

Không đăng nhập được bằng email và mật khẩu

Kiểm tra email có khoảng trắng hoặc nhập sai ký tự không.
Kiểm tra mật khẩu đáp ứng yêu cầu của hệ thống.
Tải lại trang rồi thử lại một lần.
Nếu tài khoản mới, kiểm tra email xác minh và hoàn tất xác minh trước khi đăng nhập.
Nếu quên mật khẩu, dùng luồng đặt lại mật khẩu thay vì tạo tài khoản mới.

Không nhận được email xác minh hoặc đặt lại mật khẩu

Kiểm tra thư rác, quảng cáo và bộ lọc email.
Xác nhận địa chỉ email đã nhập đúng.
Chờ email mới thay vì mở liên kết cũ đã hết hạn.
Không chia sẻ liên kết đặt lại mật khẩu cho người khác.

Hệ thống có thể hiển thị thông báo chung dù email không tồn tại để bảo vệ thông tin tài khoản. Nếu email vận hành chưa được kích hoạt, việc gửi email thực tế có thể chưa khả dụng.

Google đăng nhập hoặc callback bị lỗi

Bắt đầu lại từ nút đăng nhập Google, không mở lại callback URL cũ.
Không chặn cookie hoặc chuyển trình duyệt sang chế độ loại bỏ credential.
Nếu đang dùng địa chỉ tunnel/development đã thay đổi, xóa site data của địa chỉ cũ rồi bắt đầu lại.
Kiểm tra trình duyệt vẫn giữ cookie trạng thái đăng nhập và không chặn cửa sổ chuyển hướng.

Đang đăng nhập nhầm tài khoản

Đăng xuất tài khoản hiện tại, đăng nhập lại đúng tài khoản rồi mở lại đường dẫn. Điều này đặc biệt quan trọng với:

lời mời giáo viên;
lời mời Trợ lý giảng dạy;
liên kết Showcase;
quyền xem kế hoạch hoặc bài giao.

Chi tiết tài khoản và quyền riêng tư nằm trong Tài khoản cá nhân và Quyền riêng tư và chia sẻ dữ liệu.

2. Ứng dụng, Course hoặc Exercise không tải

Trang bị treo hoặc hiển thị trạng thái tải mãi

Kiểm tra kết nối mạng.
Tải lại trang một lần.
Quay lại Học rồi mở lại Course/Level.
Nếu chỉ một bài lỗi, thử mở một bài khác để phân biệt lỗi bài với lỗi toàn ứng dụng.
Không mở nhiều tab cùng lúc để gửi cùng một thao tác.

Không thấy Course, Section, Level hoặc Exercise

Kiểm tra đúng Course đang chọn trong menu Khóa học.
Mở lại Section và Level sau khi danh sách tải xong.
Kiểm tra bài có thuộc một chương trình giáo viên khác không.
Course hoặc Exercise bị ẩn, lưu trữ hoặc không còn quyền có thể không xuất hiện; lịch sử cũ có thể vẫn còn.
Mở Khám phá khóa học để kiểm tra lại cấu trúc Course → Section → Level → Exercise.

Không tự thay bằng một bài có tên tương tự nếu bài được giao hoặc lịch sử đang trỏ tới một Exercise cụ thể.

Player không mở được hoặc mở sai bài

Mở bài từ thư viện hoặc kế hoạch thay vì dùng một đường dẫn cũ.
Kiểm tra Course, Level và bài hiển thị trong tiêu đề player.
Nếu bài xuất phát từ kế hoạch giáo viên, mở từ đúng assignment để giữ ngữ cảnh bài giao.
Nếu link cũ báo unavailable, bài hoặc phiên bản nội dung có thể không còn được phép truy cập.

3. MIDI và thiết bị đàn

Trình duyệt không hỗ trợ MIDI

Mở Chẩn đoán MIDI để kiểm tra khả năng Web MIDI. Tính năng cần trình duyệt hỗ trợ Web MIDI và ngữ cảnh bảo mật phù hợp. Nếu không hỗ trợ, bạn có thể không sử dụng được input đàn thật trong Practice/Lesson Test.

Đã cấp quyền nhưng không thấy đàn

Đây là hai trạng thái khác nhau. Đã cấp quyền · Chưa thấy đàn nghĩa là trình duyệt được phép truy cập nhưng chưa nhận input đang kết nối.

Bật nguồn đàn.
Kiểm tra cáp USB TO HOST là cáp truyền dữ liệu, không chỉ cáp sạc.
Cắm lại cáp và kiểm tra thiết bị trong hệ điều hành.
Đóng ứng dụng khác đang giữ cổng MIDI.
Mở Chẩn đoán MIDI và kiểm tra tên input.
Quay lại player, mở Settings và chọn đúng input.

Đàn xuất hiện nhưng nhấn phím không có tín hiệu

Nhấn phím trong Chẩn đoán MIDI và xem nhật ký có sự kiện mới không.
Thử một input khác nếu máy có nhiều thiết bị.
Kiểm tra đàn đang gửi MIDI channel thông thường và không ở chế độ chỉ phát âm thanh nội bộ.
Thử cáp hoặc cổng USB khác.
Nếu có note-on nhưng không có note-off/pedal, kiểm tra thiết lập MIDI của đàn và loại sự kiện mà model đó gửi.

MIDI bị ngắt trong khi học

Không rút thiết bị trong lúc Practice hoặc Lesson Test.
Với Practice, kết nối lại rồi kiểm tra trạng thái trước khi chơi tiếp.
Với Lesson Test, lượt có thể bị hủy an toàn khi input mất kết nối; kết nối lại và bắt đầu lượt mới.
Nếu player tự kết nối lại không thành công, bấm Đàn để yêu cầu quyền/chọn input lại.

Chẩn đoán không hiển thị sự kiện

Chẩn đoán chỉ hiển thị các sự kiện MIDI được hỗ trợ và giữ tối đa 40 sự kiện gần nhất. Chọn Làm mới nhật ký chỉ làm mới log, không cấp lại quyền hoặc sửa kết nối. Xem thêm Kết nối MIDI.

4. Audio, score và player

Không nghe được tiếng piano hoặc bản mẫu

Bấm/chạm một lần trong trang để cho phép trình duyệt khởi động audio.
Kiểm tra âm lượng hệ điều hành, tab trình duyệt và thiết bị output.
Chờ sample tải xong trước khi bắt đầu preview hoặc Lesson Test.
Nếu có lỗi tải sample, chọn thử lại và kiểm tra mạng.
MIDI feedback và reference audio là hai luồng khác nhau; một luồng lỗi không nhất thiết làm luồng kia mất tín hiệu.

Preview không phát hoặc tự dừng

Preview cần tải reference sample. Preview cũng tự dừng khi bạn bắt đầu chơi MIDI để tránh nhạc mẫu chồng lên phần luyện. Chọn Nghe mẫu lại sau khi player đã sẵn sàng.

Count-in không phát tiếng

Count-in mặc định chỉ hiển thị bằng hình ảnh. Bật metronome trong tùy chọn nếu muốn nghe click. Nhịp count-in dùng time signature của bài, không mặc định mọi bài là 4/4.

Score không theo cursor hoặc bị che

Nếu vừa tự cuộn score, player chuyển sang chế độ xem thủ công và tạm dừng auto-follow.
Chọn nút quay về vị trí đang chơi để bật lại follow.
Đóng sheet Công cụ/Tùy chọn nếu đang che score.
Xoay ngang điện thoại hoặc giảm zoom trình duyệt nếu vùng score quá hẹp.
Không coi section loop là audio loop; loop Practice chỉ reset matcher theo phạm vi đã chọn.

Fullscreen không hoạt động

Trình duyệt chỉ cho phép Fullscreen sau thao tác trực tiếp của người dùng. Bấm nút fullscreen lại từ player. Nếu vẫn bị từ chối, player vẫn có thể chạy trong tab ở chế độ toàn khung.

5. Điểm, completion và tiến độ

Đã luyện nhưng chưa hoàn thành bài

Mở bài, nghe mẫu và Practice tự do không tự tạo completion. Hãy chọn Lesson Test, dùng đúng phạm vi kiểm tra đầy đủ và chờ kết quả server xác nhận.

Điểm trên màn hình khác với điểm trong lịch sử

Điểm ban đầu phía trình duyệt có thể là provisional. Server chấm lại từ nội dung đã pin và kết quả server là nguồn chuẩn. Tải lại lịch sử sau khi attempt đồng bộ.

Điểm cao nhưng vẫn chưa qua

Một lượt có thể không đạt vì một cổng riêng, chẳng hạn độ chính xác nốt, nhịp độ, tempo tối thiểu hoặc điều kiện profile. Đọc lý do chi tiết ở kết quả thay vì chỉ nhìn điểm tổng.

Luyện thử không cập nhật sao hoặc completion

Đây là hành vi đúng. Luyện thử/Hỗ trợ dùng để làm quen. Qua bài/Chuẩn hoặc Thử thách đạt quy đổi Chuẩn mới có thể cập nhật completion và sao.

6. Attempt, Replay và Showcase

Attempt chưa xuất hiện trong lịch sử

Kiểm tra bạn đã đăng nhập khi thực hiện Lesson Test.
Kiểm tra mạng và chờ outbox đồng bộ.
Tải lại Lịch sử lượt luyện sau một khoảng ngắn.
Không bấm gửi lại nhiều lần; retry cùng phiên được thiết kế để không tạo bản ghi trùng.

Không thấy Replay

Kiểm tra lần lượt:

Đây có phải Lesson Test đủ điều kiện không?
Kết quả đã được server xác nhận chưa?
Lượt chơi có tạo trace MIDI hợp lệ không?
Bạn có đang xem đúng attempt không?
Replay có bị xóa hoặc link chia sẻ bị thu hồi không?
Nếu là bài giao, dữ liệu có được tạo từ chính assignment đó không?

Replay là phát lại bài bạn đã chơi trên đàn thật; nó không phải bản thu âm microphone. Xem Thành tích và bản phát lại.

Showcase link không mở hoặc không phát được

Kiểm tra link có bị cắt khi sao chép không.
Thử mở toàn bộ link trong cửa sổ riêng tư.
Link có thể đã bị chủ sở hữu thu hồi.
Người có link chỉ xem được Showcase đó, không được truy cập Course hoặc tiến độ khác.
Nếu popup Facebook/Zalo bị chặn, cho phép popup rồi thử lại; trang hiện tại không bị điều hướng.

7. Journey, Practice Together và quyền riêng tư

Không thấy bài đăng hoặc hồ sơ Journey

Kiểm tra phạm vi bài đăng là riêng tư, bạn bè hay công khai. Bài bị ẩn, hồ sơ không public hoặc tài khoản bị block cũng có thể hiển thị như không khả dụng.

Không tìm thấy người trong Khám phá

Khám phá chỉ trả hồ sơ public phù hợp, loại trừ chính bạn, người đã follow, tài khoản bị block và đề xuất đã ẩn. Bối cảnh Course/Level chỉ được hiển thị khi người kia bật chia sẻ phù hợp.

Không tạo được lời mời Luyện tập cùng nhau

Kiểm tra:

bạn đã luyện ít nhất 300 giây trên đúng Exercise trong 7 ngày trước đó;
Exercise chưa được qua;
người nhận là bạn bè phù hợp và có quyền truy cập đúng bài;
activity chưa vượt giới hạn hoặc thời gian chờ;
người nhận chưa mute hoặc tắt lời mời.

Practice Together là hoạt động bất đồng bộ, không phải phòng luyện realtime. Xem Luyện tập cùng nhau.

Không xem được dữ liệu sau khi thu hồi quyền

Thu hồi consent, bỏ phân công hoặc dừng quan hệ có thể chặn quyền đọc mới ngay lập tức. Lịch sử đã ghi không nhất thiết bị xóa. Không dùng link hoặc thông báo cũ để vượt qua quyền hiện tại.

8. Thông báo và kế hoạch giáo viên

Không thấy thông báo

Mở bộ lọc Tất cả, không chỉ Chưa đọc.
Tải lại hộp thư nếu mạng vừa khôi phục.
Cuộn xuống để tải các trang cũ hơn.
Kiểm tra đúng tài khoản nhận thông báo.

Mở chuông có thể xóa số chưa xem, nhưng không tự đánh dấu mọi dòng là đã đọc. Dùng Đọc tất cả nếu cần.

Thông báo có nhưng không mở được nội dung

Target có thể đã hết hạn, bị xóa, không còn public hoặc quyền của bạn đã thay đổi. Đây là trạng thái bảo vệ dữ liệu, không phải bằng chứng rằng thông báo bị hỏng.

Không thấy kế hoạch hoặc bài giao

Kiểm tra đã chấp nhận lời mời giáo viên chưa.
Kiểm tra đúng workspace/programme.
Mở cả quan hệ đang hoạt động và lịch sử nếu giao diện cho phép.
Nếu quan hệ đang Tạm dừng, bài có thể chỉ đọc và không thể thực hiện hoạt động mới.
Nếu đã Ngừng học, cần lời mời mới để học tiếp.

9. Dạy học offline

Không thấy học viên trong roster

Kiểm tra ngày chọn, quan hệ học tập còn Đang học, assignment slot còn hiệu lực và occurrence chưa bị hủy/thay thế. Trợ lý chỉ thấy học viên được phân công.

Buổi offline vẫn là “Chờ xác nhận”

Buổi chưa đánh dấu vắng có thể được tự chốt Có mặt khi bắt đầu occurrence offline tiếp theo của học viên (T+1). Nếu học viên vắng, đánh dấu Vắng thay vì chờ tự động.

Không thể lập lịch hoặc ngày nghỉ

Màn hình lập kế hoạch giới hạn ngày trong vòng 30 ngày kể từ hôm nay. Kiểm tra ngày bắt đầu không sau ngày kết thúc và không chọn ngày quá giới hạn.

Không xuất được Excel

Chọn khoảng ngày hợp lệ.
Chọn Xem thống kê.
Chờ bảng báo cáo tải xong.
Chọn Xuất Excel.

Báo cáo workspace tổng hợp buổi, có mặt, vắng và số phút. Điểm khích lệ/nhận xét là dữ liệu ghi nhận buổi học, không phải điểm kiểm tra.

Xem chi tiết trong Dạy học offline.

10. Khi liên hệ hỗ trợ

Hãy cung cấp:

tên màn hình và thao tác ngay trước khi lỗi;
thời điểm xảy ra lỗi và múi giờ nếu liên quan lịch/tiến trình;
trình duyệt, hệ điều hành và loại thiết bị;
thông báo lỗi hoặc mã lỗi nguyên văn;
model đàn, loại cáp và trạng thái trong Chẩn đoán MIDI nếu liên quan MIDI;
bài/Course/Level đang mở, không gửi toàn bộ dữ liệu tài khoản nếu không cần.

Không gửi:

mật khẩu hoặc mã xác minh;
cookie, session hoặc token đăng nhập;
token lời mời;
dữ liệu học viên khác;
Replay/Showcase link nếu bộ phận hỗ trợ không yêu cầu rõ.

Nếu gửi ảnh chụp màn hình, hãy che email, số điện thoại, mã tài khoản và link chia sẻ trước khi gửi.
---

← Trước · Mục lục