Tài liệu MAJACLOUD
Backend tự lưu trữ (self-hosted) cho game của bạn: tài khoản người chơi, bảng xếp hạng, cấu hình từ xa có chữ ký, lưu trữ đám mây và phần thưởng, kèm SDK cho Unity, Godot và web.
Chú thích trong mã và tên API được giữ nguyên tiếng Anh để khớp với SDK.
Trên trang này
Chọn engine#
Unity là SDK chính và đi kèm một scene mẫu chơi được ngay. Game Godot và web dùng chung dự án, khóa và dịch vụ.
Unity SDK Khuyên dùngC# cho Unity 2021.3+ với API async và coroutine, kèm scene Starter. Godot SDKAddon GDScript cho Godot 4.2+ với autoload và công cụ thiết lập trong editor. Web SDKMột file JavaScript cho game HTML5, website và máy chủ Node.js. REST APIHTTPS và JSON thuần cho mọi engine, công cụ hay máy chủ khác.
Dịch vụ#
Người chơiĐăng nhập khách vẫn giữ nguyên sau khi khởi động lại, sau đó là tài khoản email hoặc Google. Bảng xếp hạngĐiểm tốt nhất hoặc mới nhất, đặt lại từ hằng ngày đến hằng tháng, giới hạn điểm chống gian lận. Cấu hình từ xaThay đổi giá trị trực tiếp; mọi phản hồi đều được ký và xác minh. Lưu trữ đám mâyDữ liệu JSON riêng cho từng người chơi, có bản sửa đổi và phát hiện xung đột. Phần thưởngPhần thưởng hằng ngày, hằng tuần hoặc một lần do máy chủ quyết định.
Cách hoạt động#
- Tạo dự án trong bảng điều khiển. Bạn sẽ nhận được ID dự án, một khóa client công khai và một khóa bí mật.
- Thêm SDK vào game rồi dán Base URL, ID dự án và khóa client.
- Đăng nhập cho người chơi. Lệnh gọi đầu tiên tạo một tài khoản khách; phiên được lưu lại và khôi phục ở lần mở game tiếp theo.
- Gọi các dịch vụ. Mọi yêu cầu đều hiện trên trang Nhật ký của dự án kèm ID yêu cầu.
Tiếp theo#
Mới bắt đầu? Phần bắt đầu nhanh chỉ mất khoảng năm phút. Đã thiết lập xong? Hãy chuyển đến một dịch vụ, tài liệu tham khảo REST hoặc khắc phục sự cố.