Xử Lý Sự Cố

Bài hát không hiện trong Library

Nguyên nhân: Phần mở rộng file không được nhận diện, hoặc Library chưa được reload.

Sửa:

1. Xác nhận phần mở rộng là .json, .skysheet, hoặc .txt.
2. Nhấn Reload songs trong desktop GUI để reload mà không cần khởi động lại.
3. Nếu vẫn không hiện, kiểm tra file nằm trực tiếp trong thư mục songs/, không phải trong thư mục con.

Lỗi “Failed to parse” hoặc lỗi parse khi khởi động

Nguyên nhân: Nội dung file không phải JSON hợp lệ, hoặc sheet dùng schema version mà parser hiện tại chưa hỗ trợ.

Sửa:

1. Mở file trong text editor. Xác nhận nó chứa JSON object bắt đầu bằng {.
2. Re-export sheet từ Sky Music editor.
3. Nếu lỗi vẫn tiếp diễn, mở GitHub issue và đính kèm thông báo lỗi (không phải file sheet).

Nốt nhạc nghe muộn hoặc sớm so với nhạc nền

Nguyên nhân A — Lệch FPS: Cài đặt FPS trong Sky Auto Player không khớp với FPS cấu hình trong Sky.

Sửa: Mở cài đặt theo bài và đặt FPS khớp với frame rate của Sky (30 hoặc 60).

Nguyên nhân B — Lệch tempo: Tempo multiplier không phải 1,0.

Sửa: Reset tempo multiplier về 1,0 trong cài đặt theo bài.

Nguyên nhân C — Tải hệ thống cao: CPU tải nặng gây jitter scheduling Windows, làm tăng độ trễ phía sender vượt quá khả năng bù của adaptive lead.

Sửa: Đóng ứng dụng nền. Thử bật tuning preset cho PC yếu qua flag --tuning. Xem FAQ đầy đủ.

Lưu ý: Sky Auto Player kiểm soát khi nào phím được gửi. Khi game xử lý chúng phụ thuộc vào vòng lặp sampling input của game và scheduling Windows — những yếu tố này ngoài tầm kiểm soát của player.

Nốt hold không đăng ký (nhả quá sớm)

Nguyên nhân: Thời gian hold ở FPS đã cấu hình ngắn hơn thời gian đăng ký tối thiểu của game cho phím đó.

Sửa: Trong cài đặt theo bài, chuyển từ 1,0 frame sang 1,25 frame hoặc 1,5 frame. Cài đặt FPS phải khớp với FPS trong Sky để timing hold chính xác.

Game không nhận input nào

Nguyên nhân A — Focus: Cửa sổ game không có focus khi phát nhạc bắt đầu.

Sửa: Chuyển sang cửa sổ game trước khi nhấn hotkey phát. Sky Auto Player gửi phím đến cửa sổ đang active; nếu game không được focus, phím sẽ đi nơi khác.

Nguyên nhân B — Hotkey chưa đặt: Hotkey phát chưa được bind hoặc xung đột với ứng dụng khác.

Sửa: Mở command palette (/) và kiểm tra hotkey binding.

Nguyên nhân C — Sai key layout: Profile key layout không khớp với keyboard layout đang dùng trong Sky.

Sửa: Kiểm tra profile layout trong cài đặt khớp với những gì Sky hiển thị.

Cảnh báo Windows SmartScreen khi khởi động

Nguyên nhân: Installer hoặc binary không đạt identity Authenticode mong đợi, hoặc không được tải từ trang GitHub Releases chính thức của Sky Auto Player.

Sửa: Không bỏ qua cảnh báo. Xóa file và tải lại installer cùng sidecar .exe.sig từ trang GitHub Releases chính thức của Sky Auto Player.

Cập nhật thủ công

Nguyên nhân: Official Tauri updater không thể stage hoặc chạy installer current-user.

Sửa:

1. Thử lại Update and Restart từ thông báo cập nhật trong app.
2. Nếu vẫn thất bại, tải installer NSIS canonical từ trang GitHub Releases chính thức của Sky Auto Player.
3. Không dùng ZIP v3, MANIFEST.json hoặc updater executable độc lập cho v4.

HUD hiển thị jitter timing cao

Nguyên nhân: Chỉ số jitter của HUD phản ánh phương sai dispatch phía sender. Giá trị cao cho thấy áp lực scheduling OS trên máy của bạn.

Sửa: Đóng ứng dụng nền. Thử tuning preset. Lưu ý rằng jitter phía sender không trực tiếp dẫn đến lỗi timing nghe được — sampling rate của game thường là yếu tố lớn hơn.

Giới hạn đã biết

Những vấn đề này không thể sửa từ phía player và được ghi nhận là ràng buộc đã biết:

• Timing phía game: Game quyết định khi nào đăng ký phím. Sky Auto Player không thể ghi đè tần số polling input của game.
• Đoạn nhạc rất nhanh: Arpeggio cực dày ở BPM cao có thể vượt quá khả năng đăng ký nốt riêng lẻ của game, bất kể phím được gửi chính xác đến mức nào.
• Chỉ hỗ trợ Windows: MMCSS real-time scheduling và SendInput là Windows API. macOS và Linux không được hỗ trợ và không có trong roadmap.
• Dự án không chính thức: Sky Auto Player không liên kết với thatgamecompany. Tự động phát nhạc có thể xung đột với Điều khoản Dịch vụ của Sky.