Dữ liệu

Mô-đun Dữ liệu cho phép lưu trữ và truy xuất dữ liệu bộ đệm của người dùng đã đăng nhập. Dữ liệu này cũng sẽ được đồng bộ hóa trên tất cả các thiết bị mà người dùng chơi game.

Nếu người dùng chưa đăng nhập, mô-đun Dữ liệu sẽ lưu trữ dữ liệu game trong LocalStorage. Nếu người dùng đăng nhập sau này, dữ liệu game từ LocalStorage sẽ được đồng bộ hóa và sao lưu vào tài khoản người dùng.

Cảnh báo

Nếu bạn dự định sử dụng mô-đun Dữ liệu, đừng quên chọn sử dụng mô-đun Dữ liệu của JogosSDK trong biểu mẫu "Cách thức lưu trữ tiến trình của trò chơi" khi nộp game. Nếu không, mô-đun Dữ liệu sẽ bị vô hiệu hóa.

Sử dụng đồng bộ hóa dữ liệu game qua đám mây

Sau khi đọc trang giới thiệu SDK dành cho engine của bạn, vui lòng làm theo các bước sau để sử dụng mô-đun data này.

Khởi tạo

Trước khi sử dụng bất kỳ phương thức nào của mô-đun Dữ liệu, hãy đảm bảo rằng SDK đã được khởi tạo.

Cách sử dụng

//Sắp ra mắt

Tránh mất dữ liệu tiến trình người dùng

Nói chung, việc luôn lấy dữ liệu trước khi thiết lập dữ liệu là một cách tốt để đảm bảo rằng tiến trình trước đó của người chơi không bị mất.

Hành vi trong chế độ khách

Đối với người dùng khách, mô-đun Dữ liệu sẽ lưu trữ dữ liệu game trong localStorage. Khi người dùng khách đăng nhập, bạn không cần thực hiện bất kỳ hành động nào. SDK của chúng tôi sẽ tự động tải dữ liệu game của tài khoản (nếu có)；nếu người dùng này chưa từng chơi game của bạn trước đó, SDK sẽ chuyển dữ liệu khách sang tài khoản người dùng. Khi người dùng thoát, SDK sẽ tiếp tục sử dụng dữ liệu game của khách.

Giới hạn lưu trữ dữ liệu

SDK sẽ thực hiện xử lý chống rung cho việc lưu dữ liệu trong vòng 1 giây, có nghĩa là sau nhiều lần gọi phương thức này, việc lưu dữ liệu sẽ hoàn thành sau 1 giây. Trong một số trường hợp, có thể xảy ra ngoại lệ, việc lưu dữ liệu có thể cần thời gian chống rung lâu hơn, tối đa 30 giây. Giới hạn dữ liệu là 1MB. Nếu bạn gần đạt đến giới hạn này, một cảnh báo sẽ được hiển thị trong bảng điều khiển trình duyệt. Nếu dữ liệu vượt quá 1MB, sẽ không được sao lưu nữa.

Trợ giúp về mô-đun Dữ liệu

Nếu bạn không chắc chắn về cách sử dụng mô-đun Dữ liệu để lưu trữ và tải dữ liệu tiến trình, hãy tham khảo API localStorage có hoạt động tương tự như mô-đun Dữ liệu để tích hợp mô-đun Dữ liệu vào game đã phát hành.