Dados

O módulo Dados permite salvar e recuperar dados em cache do jogo para usuários conectados. Esses dados também serão sincronizados em todos os dispositivos onde o usuário joga o jogo.

Se o usuário não estiver conectado, o módulo Dados armazenará os dados do jogo no LocalStorage. Se o usuário se conectar posteriormente, os dados do jogo no LocalStorage serão sincronizados e backupados na conta do usuário.

Aviso

Se você pretende usar o módulo Dados, não se esqueça de selecionar o uso do módulo de dados do JogosSDK no formulário "Modo como seu jogo salva o progresso" ao enviar o jogo. Caso contrário, o módulo Dados será desativado.

Usando a sincronização em nuvem para dados do jogo

Após ler a página de introdução do SDK para seu motor, siga os passos abaixo para usar o módulo data.

Inicialização

Antes de usar qualquer método do módulo Dados, certifique-se de que o SDK foi inicializado.

Uso

// Em breve

Evitar perda de progresso do usuário

Em geral, é uma boa prática sempre recuperar os dados antes de defini-los, para garantir que o progresso anterior do jogador não seja perdido.

Comportamento no modo convidado

Para usuários convidados, o módulo Dados armazenará os dados do jogo no localStorage. Quando um convidado se conecta, não é necessário realizar nenhuma ação. Nosso SDK carregará automaticamente os dados do jogo da conta (se houver); se o usuário não jogou seu jogo antes, o SDK transferirá os dados do convidado para a conta do usuário. Quando o usuário desconectar-se, o SDK retornará a usar os dados do jogo do convidado.

Limites de salvamento de dados

O SDK aplicará um debounce no salvamento de dados em 1 segundo, o que significa que após múltiplas chamadas do método, o salvamento dos dados será concluído 1 segundo depois. Em alguns casos, podem ocorrer exceções, e o salvamento de dados pode exigir um debounce mais longo, com um máximo de 30 segundos. O limite de dados é de 1MB. Se você estiver prestes a atingir esse limite, um aviso será exibido no console do navegador. Se os dados excederem 1MB, não serão mais backupados.

Ajuda com o módulo de dados

Se você não tiver certeza de como usar o módulo de dados para salvar e carregar o progresso, consulte a API localStorage, que funciona da mesma maneira que o módulo de dados, para integrá-lo em jogos já lançados.