Khắc phục sự cố

Unity: mở Tools ▸ Majacloud ▸ Setup và lưu; asset phải nằm ở Assets/Resources/MajacloudSettings.asset. Godot: điền Project Settings ▸ Majacloud. Web: truyền baseUrl, projectId và clientKey.

Chỉ localhost mới được dùng http://. Hãy dùng HTTPS, hoặc chỉ khi phát triển, đặt ALLOW_INSECURE_HTTP trong config.local.php.

Hãy phục vụ cả game qua HTTPS: trình duyệt chặn lệnh gọi http:// từ trang https://. API đã gửi sẵn các header CORS.

Mọi lỗi đều có ID yêu cầu. Tìm ID đó trên trang Nhật ký của dự án.

Kiểm tra ID dự án và khóa client trên trang Khóa API. Nếu bạn đã đổi khóa client, các bản build cũ sẽ ngừng hoạt động.

Phiên không được dùng trong 30 ngày sẽ hết hạn. Nếu hai bản game dùng chung một phiên và cả hai cùng làm mới, cơ chế chống tái sử dụng sẽ đăng xuất phiên đó: hãy để một instance SDK duy nhất quản lý phiên.

Trình duyệt chặn các tab không được mở từ một cú nhấp chuột. Hãy bắt đầu liên kết từ trình xử lý sự kiện của nút.

Khóa công khai đã lưu không khớp với máy chủ, thường xảy ra sau khi chuyển sang máy chủ mới hoặc mất storage/keys/. Hãy chạy lại Test connection (hoặc cập nhật configPublicKey) và phát hành bản cập nhật.

SDK tải cấu hình khi khởi động. Hãy gọi fetch lại (ví dụ khi quay về menu) để nhận thay đổi ngay trong phiên chơi.

Đã chạm giới hạn của gói. Không dữ liệu nào bị xóa; hãy nâng cấp hoặc xóa các mục không dùng trong bảng điều khiển.

Chờ đủ số giây trong Retry-After. Tránh gọi fetch trong Update() hoặc vòng lặp game; hãy lưu đệm kết quả.

Bật plugin trong Project Settings ▸ Plugins; plugin sẽ thêm autoload. Kiểm tra thư mục phải đúng là res://addons/majacloud.

Chứng chỉ HTTPS của máy chủ không được tin cậy (thường là chứng chỉ tự ký). Hãy dùng chứng chỉ từ một tổ chức cấp phát công khai như Let's Encrypt.

Trang được phục vụ qua HTTP thuần từ một host khác. Hãy phục vụ qua HTTPS (localhost vẫn dùng được khi phát triển).