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 associados aos dados binários que permitem aos serviços relacionados a jogos do Google Play apresentar Jogos Salvos na interface do usuário (UI) padrão da lista de Jogos Salvos e para apresentar informações úteis 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 configuração "Jogos salvos" padrão listar a interface do usuário (interface) fornecida pelo SDK do Play Games no jogo, a interface exibirá 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 poderá ler e gravar 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é quando a conectividade de rede é estabelecida. Após a reconexão, os serviços relacionados a jogos do Google Play atualiza de forma assíncrona os dados salvos do jogo 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
No momento, os serviços relacionados a jogos do Google Play aplicam limites de tamanho para dados binários e cobertura tamanhos de imagem 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 o item salvo jogo. 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 de quando o jogo salvo foi atualizado pela última vez. |
| 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 exibido pelos serviços relacionados a jogos do Google Play como "1 h". |
| 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 aprender a implementar Jogos salvos na sua plataforma, consulte os seguintes recursos: