Jogos salvos

O serviço de Jogos salvos oferece uma maneira conveniente de salvar a progressão para jogadores nos servidores do Google. Seu jogo pode acessar os dados salvos para permitir que os jogadores continuem do último ponto de salvamento em qualquer dispositivo.

O serviço de Jogos salvos permite sincronizar os dados de um jogador em vários dispositivos. Por exemplo, se você tem um jogo para Android, pode usar o serviço de Jogos salvos para permitir que um jogador inicie um jogo no smartphone Android e continue em um tablet sem perder o progresso. Esse serviço também pode ser usado para garantir que o jogo continue de onde parou, mesmo que o dispositivo seja perdido, destruído ou trocado por um modelo mais recente.

Para aprender a implementar jogos salvos na sua plataforma, consulte Implementações de clientes.

Noções básicas sobre Jogos salvos

Um jogo salvo consiste em duas partes:

  • Um blob binário não estruturado: esses dados podem representar o que você quiser, e seu jogo é responsável por analisar e gravar os dados nele.
  • Metadados estruturados: outras propriedades associadas aos dados binários que permitem aos serviços relacionados a jogos do Google Play apresentar visualmente Jogos salvos na interface do usuário (IU) da lista de Jogos salvos padrão e exibir informações úteis no app Google Play Games (por exemplo, carimbo de data/hora da última atualização).

Um jogo pode gravar um número arbitrário de Jogos salvos para um único jogador, sujeito à cota do usuário. Não há um requisito rígido para restringir os jogadores a um único arquivo de salvamento.

Imagens de capa

O serviço de Jogos salvos oferece uma experiência visual ao usuário, além dos recursos de persistência. É altamente recomendado associar imagens representativas aos arquivos de salvamento correspondentes. Se você estiver usando a interface do usuário (IU) de lista de jogos salvos padrão fornecida pelo SDK do Play Games no seu jogo, a IU vai mostrar essas imagens de capa. As imagens de capa também podem aparecer no app Google Play Games.

Descrições

Você pode fornecer uma breve descrição do conteúdo de um determinado jogo salvo. Ela é mostrada diretamente aos jogadores e precisa resumir o estado que o jogo salvo representa. Por exemplo, "Luta contra os goblins na Floresta Sombria".

Cota

Os desenvolvedores não são cobrados pelos dados de jogos salvos na nuvem. Em vez disso, esses dados são contabilizados na cota do Google Drive do jogador. Você não precisa se preocupar com isso. A única cota que os desenvolvedores de jogos precisam considerar é a da API Google Drive.

Isolamento de leitura/gravação

Todos os dados salvos são armazenados na pasta de dados do aplicativo do jogador no Google Drive. Apenas seu jogo pode gravar e ler dados nesta pasta. Ela não pode ser visualizada ou modificada por jogos de outros desenvolvedores, isso garante uma forte proteção contra corrupção de dados. Além disso, os jogos salvos são isolados de adulterações diretas por jogadores para que não seja possível modificar jogos salvos individualmente.

Suporte off-line

Seu jogo ainda pode ler e gravar dados em um jogo salvo quando o dispositivo do jogador estiver off-line, mas não será possível sincronizar com os serviços relacionados a jogos do Google Play até que a conectividade de rede seja estabelecida. Após a reconexão, os serviços relacionados a jogos do Google Play atualizam de forma assíncrona os dados de jogos salvos nos servidores do Google.

Resolução de conflitos

Ao usar o serviço de Jogos salvos, seu jogo pode encontrar conflitos no salvamento de dados. Esses conflitos podem ocorrer quando um usuário está executando mais de uma instância do aplicativo em dispositivos ou computadores diferentes. O aplicativo precisa ser capaz de resolver esses conflitos de uma maneira que forneça a melhor experiência do usuário.

Normalmente, os conflitos de dados ocorrem quando uma instância do aplicativo não consegue acessar o serviço de Jogos salvos ao tentar carregar ou salvar dados. Em geral, a melhor maneira de evitar conflitos de dados é carregar os dados mais recentes do serviço quando o aplicativo é iniciado ou retomado, salvando informações com uma frequência razoável. No entanto, nem sempre é possível evitar conflitos de dados. O aplicativo precisa fazer o possível para resolver conflitos de modo que os dados do usuário sejam preservados e ele tenha uma boa experiência.

Limites

Atualmente, os serviços relacionados a jogos do Google Play impõem limites de tamanho em dados binários e imagens de capa de 3 MB e 800 KB, respectivamente.

Metadados de jogos salvos

Os metadados estruturados de um jogo salvo contêm estas propriedades:

Propriedade Descrição
ID Uma string exclusiva gerada pelos serviços relacionados a jogos do Google Play para este jogo salvo. Use esse ID para se referir ao jogo salvo nos clientes do jogo.
Nome Um nome curto fornecido pelo desenvolvedor para o jogo salvo. Por exemplo, "Jogo salvo 1" ou "NomeDoJogador_Salvo1". Esse nome não aparece para os jogadores.
Descrição Uma descrição fornecida pelo desenvolvedor do jogo salvo.
Última modificação Carimbo de data/hora em milissegundos gerado pelos serviços relacionados a jogos do Google Play para a data da última atualização do jogo salvo.
Tempo jogado Um tempo fornecido pelo desenvolvedor (em milissegundos) que é mostrado no jogo salvo. Esse valor precisa representar quanto tempo o jogador passou no jogo salvo correspondente. Por exemplo, um valor de tempo jogado de 3600000 vai ser mostrado pelos serviços relacionados a jogos do Google Play como "1h".
Imagem da capa Uma propriedade opcional e fornecida pelo desenvolvedor que contém informações sobre a imagem de capa.

Implementações do cliente

Para saber como implementar Jogos salvos na sua plataforma, consulte os seguintes recursos: