Com os serviços relacionados a jogos do Google Play, você pode adicionar recursos de mídias sociais e modos multijogador aos seus jogos para um maior engajamento do público.
Selecione um recurso abaixo para conhecer os aspectos básicos e encontre a documentação sobre como implementar os serviços relacionados a jogos do Google Play.
Iniciar
Integrar o SDK dos serviços relacionados a jogos do Google PlayPara saber como integrar o SDK dos serviços relacionados a jogos do Google Play, acesse o site do Google Developers para ver instruções e exemplos sobre como começar.
Para usar os serviços relacionados a jogos do Google Play, é necessário criar uma lista de jogos no Play Console. A lista de jogos é separada da página Detalhes do app.
Veja como adicionar uma nova lista de jogos:
- Abra o Google Play Console.
- Acesse Configurações
> Projetos de jogos.
- No canto superior direito, clique em Adicionar novo jogo.
> Projetos de jogos.Recursos
ConquistaCom as conquistas, você ajuda a reter os jogadores oferecendo recompensas para a realização de metas estabelecidas no jogo. Os jogadores podem ganhar pontos de experiência (XP) para as conquistas atingidas durante o jogo.
Acesse o site do Google Developers para saber mais sobre as conquistas.
Observação: assim que você publicar uma conquista, não será possível excluí-la.
Adicionar conquistas
Há duas maneiras de criar conquistas usando o Google Play Console:
- Criar uma conquista: adicione definições e metadados para cada uma delas.
- Importar conquistas: importe definições e outros metadados de várias conquistas em uma única etapa.
Observação: use APIs para desbloquear conquistas para o jogador conectado. Isso vai revelar todas as recompensas ocultas para o jogador.
Criar uma conquista
Para criar uma conquista para um jogo novo e não publicado, siga estas etapas usando o Google Play Console:
- No Google Play Console, selecione um jogo.
- Na página Conquistas dos Serviços relacionados a jogos do Google Play (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Criar conquista.
- Na página Adicionar conquistas, preencha o formulário.
- Clique em Salvar como rascunho.
Depois disso, você precisa publicar o jogo.
Adicionar mais conquistas
Se você já tem conquistas e quer adicionar mais:
-
No Google Play Console, selecione um jogo.
-
Na página Conquistas dos Serviços relacionados a jogos do Google Play (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Adicionar conquistas.
Importar conquistas
Para adicionar várias conquistas ao jogo de uma só vez, siga estas etapas:
1. Crie um arquivo ZIP com suas conquistas.
1. 1 Faça upload do arquivo.
Para mais informações, consulte as diretrizes para arquivos ZIP.
Para importar conquistas:
- No Google Play Console, selecione um jogo.
- Na página Conquistas dos serviços relacionados a jogos do Google Play (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Conquistas), selecione Importar conquistas.
- Na página Importar conquistas, clique em Fazer upload.
- Selecione o arquivo ZIP.
- Clique em Salvar como rascunho.
- Depois de importar as conquistas, publique o jogo.
Publicar o jogo
Editar uma conquista
Para editar uma conquista já criada, selecione na guia Conquistas do Google Play Console. Você terá acesso ao mesmo formulário usado ao criar a conquista e vai poder editar qualquer um dos campos como quiser.
Quando terminar de editar uma conquista, clique no botão Salvar como rascunho. A conquista recém-editada estará em um estágio "pronta para testes". Se estiver funcionando corretamente, selecione Republicar na lista suspensa. Assim, seu jogo será republicado com todas as conquistas atualizadas.
Observação: quando uma conquista é publicada, o estado inicial (oculto ou revelado) e o tipo (incremental ou padrão) são fixos e não podem ser modificados.
Desfazer uma edição
Excluir uma conquista
Após a publicação da conquista, ela não poderá ser excluída.
Para excluir uma conquista em um estado pré-publicado, clique no botão Excluir na parte inferior do formulário.
Redefinir uma conquista
Só é possível redefinir os dados de progresso do jogador para conquistas de rascunho.
- Para redefinir conquistas no Google Play Console, clique no botão Redefinir progresso de conquista na parte inferior do formulário daquele evento.
- Para redefinir os dados de conquista de forma programática, chame os métodos de conquista da API Management.
Diretrizes relativas a ícones
Os ícones precisam ser criados como arquivos PNG, JPEG ou JPG de 512 x 512. Você só precisa nos fornecer o ícone para a conquista desbloqueada. Vamos gerar automaticamente uma versão em escala de cinza para o ícone revelado. Por esse motivo, recomendamos que os ícones incluam elementos coloridos para que os usuários possam distinguir facilmente entre conquistas reveladas e desbloqueadas.
Quando um ícone de conquista é exibido em um aviso do Android, ele aparece sobreposto por um círculo com os cantos externos ocultos. Confira se o ícone ainda é exibido de maneira adequada nessas circunstâncias.
Exemplo de ícone de conquista.
O mesmo ícone é usado em todas as localidades. Portanto, recomendamos não incluir texto nem conteúdo traduzido.
Diretrizes para arquivos ZIP
É possível importar várias conquistas de uma só vez usando um arquivo ZIP. Consulte a tabela para saber os nomes exatos a serem usados:
|
Nome do arquivo |
Obrigatório ou opcional |
Valores aceitos |
|
|
Obrigatório |
Metadados de cada conquista. Consulte Atributos. |
|
|
Opcional |
Fornece traduções para nomes e descrições de conquistas. |
|
|
Opcional |
Faz a correspondência entre conquistas e os arquivos de ícones. |
|
Opcional |
Ícones nos formatos PNG, JPEG ou JPG. |
Requisitos do arquivo ZIP:
- Sem subdiretórios.
- Nomes de arquivos exclusivos.
- Somente arquivos CSV, PNG, JPEG ou JPG.
- O arquivo CSV não pode ter uma linha de cabeçalho.
- Cada arquivo precisa ter menos de 1 MB.
- O total de arquivos precisa ser inferior a 203.
- O tamanho total do arquivo ZIP precisa ser inferior a 200 MB.
Formato AchievementsMetadata.csv
O arquivo AchievementsMetadata.csv contém os metadados de cada conquista. Ele precisa incluir as informações como valores separados por vírgula na seguinte ordem:
Esses campos são descritos na tabela a seguir:
|
Títulos de colunas do CSV |
Obrigatório ou opcional |
Valores aceitos |
|
Nome |
Obrigatório |
Máximo de 100 caracteres |
|
Descrição |
Opcional |
Máximo de 500 caracteres |
|
Valor incremental |
Opcional |
Verdadeiro ou falso |
|
Etapas necessárias |
Obrigatório se o valor incremental for "Verdadeiro". |
Número (sem frações ou decimais) |
|
Estado inicial |
Obrigatório |
Oculto ou revelado |
|
Pontos |
Obrigatório |
Número múltiplo de 5, com valor entre 5 e 200 |
|
Ordem da lista |
Opcional |
Número (sem frações ou decimais e maior que zero) |
Requisitos do arquivo AchievementsMetadata.csv:
- Cada linha precisa ter sete valores. Se você quiser omitir um valor, deixe o campo em branco.
- Os campos "Nome" e "Descrição" são usados como a localidade padrão.
- O campo "Nome" precisa ser exclusivo em todas as conquistas.
- Os campos a seguir não podem conter vírgulas: "Nome" e "Descrição".
Um exemplo de arquivo AchievementsMetadata.csv:
Achievement1,,True,100,Hidden,5,20
Achievement2,,False,,Revealed,10,30
Formato AchievementsLocalizations.csv
O arquivo AchievementsLocalizations.csv é opcional e configura todos os dados necessários para descrever cada conquista aos usuários em diferentes localidades. As conquistas são traduzidas de acordo com as localidades especificadas para o jogo.
Ele precisa incluir as informações como valores separados por vírgula na seguinte ordem:
Esses campos são descritos na tabela a seguir:
|
Títulos de colunas do CSV |
Obrigatório ou opcional |
Descrição |
Valores aceitos |
|
Nome |
Obrigatório |
Precisa corresponder à coluna "Nome" do |
Máximo de 100 caracteres |
|
Nome localizado |
Obrigatório |
O nome localizado da conquista. |
Máximo de 100 caracteres |
|
Descrição localizada |
Opcional |
A descrição localizada da conquista na localidade especificada. |
Máximo de 500 caracteres |
|
Localidade |
Obrigatório |
O código da localidade, como en-US. |
Adicione traduções para seu jogo antes de especificar uma localidade. Não é possível especificar a localidade padrão. Os códigos de localidade podem ser encontrados na lista de idiomas compatíveis. |
Requisitos do arquivo AchievementsLocalizations.csv:
- Os nomes das conquistas em um jogo precisam ser exclusivos por localidade. Por exemplo, se um jogo tiver suporte para as localidades en-US e fr-FR, uma conquista chamada "Conquista1" em en-US também pode ser chamada de "Conquista1" em fr-FR.
- Cada linha precisa ter quatro valores. Se você quiser omitir o valor da descrição localizada, deixe o campo em branco.
Um exemplo de arquivo AchievementsLocalizations.csv:
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Formato AchievementsIconMappings.csv
O arquivo AchievementsIconMappings.csv é opcional e é usado para fazer a correspondência entre suas conquistas e os ícones fornecidos. Ele precisa incluir as informações como valores separados por vírgula na seguinte ordem:
Esses campos são descritos na tabela a seguir:
|
Títulos de colunas do CSV |
Obrigatório ou opcional |
Descrição |
|
Nome |
Obrigatório |
Precisa corresponder à coluna "Nome" do |
|
Nome do arquivo do ícone |
Obrigatório |
O nome do arquivo do ícone. |
Requisitos do arquivo AchievementsIconMappings.csv:
- Cada linha precisa ter dois valores.
- Os arquivos de ícones só podem estar nos formatos PNG ou JPEG.
Um exemplo de arquivo AchievementsIconMappings.csv:
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
Arquivos de ícones
AchievementsIconMappings.csv precisam existir no arquivo ZIP atual que você importa. Para mais informações, consulte as diretrizes de ícones.Adicionar traduções para conquistas
Você pode especificar suas próprias traduções para conquistas associadas ao jogo. Antes de fazer isso, conclua as etapas descritas em Como adicionar traduções ao seu jogo.
Há duas maneiras de fazer isso:
- Usar a opção Importar conquistas para fazer upload de traduções de muitas conquistas novas de uma vez. Não é possível usar essa opção para conquistas que já existem.
- Adicionar traduções para cada conquista no seu jogo. Para adicionar sua própria tradução para cada conquista:
- No Google Play Console, abra a guia Conquistas do jogo e selecione uma delas.
- Na página de detalhes das conquistas, selecione um idioma adicionado anteriormente na guia Detalhes do jogo.
- Na página de detalhes desse idioma, atualize o formulário com as traduções.
- Clique em Salvar para armazenar os detalhes traduzidos da conquista.
Com os placares, você oferece aos jogadores uma forma de comparar a pontuação com os amigos e competir com os melhores jogadores.
Observação: as pontuações dos placares não podem ser redefinidas, mas é possível excluir ou ocultar um placar a qualquer momento.
Para ocultar pontuações suspeitas nos placares, ative a proteção contra adulteração de placar na página Placares do jogo no Play Console.
Criar um placar
Para criar um placar para um jogo novo e não publicado, siga estas etapas:
- No Google Play Console, selecione um jogo.
- Acesse Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Placares e clique no botão Criar placar.
- Preencha as informações necessárias.
- Clique em Salvar como rascunho para que seu placar fique disponível no estado "Rascunho".
- Depois que você publicar o jogo, todos os placares dele também serão publicados.
Criar um placar para um jogo publicado
Para criar outro placar de um jogo que já tenha sido publicado, siga as mesmas etapas acima. Para ver mais informações sobre como testar uma versão atualizada de um jogo, consulte Como publicar mudanças no seu jogo.
Após testar o placar e ter gostado do resultado, republique o jogo com os novos placares para que sejam exibidos no mundo todo.
Editar um placar
Para editar um placar que você já criou, clique nele na guia Placares do Google Play Console. O mesmo formulário usado ao criar o placar será exibido, e você vai poder editar qualquer um dos campos como quiser.
Ao terminar de editar um placar, clique no botão Salvar como rascunho. O placar recém-editado vai estar no estado "Rascunho" e pode ser testado.
Se estiver funcionando corretamente, selecione Publicar as mudanças na caixa na parte de cima do formulário. Assim, você pode publicar o jogo novamente para o público, com todos os placares atualizados.
Desfazer uma edição
Excluir um placar
É possível excluir os placares que estão no estado "Rascunho" ou publicados. Para excluir um placar no Google Play Console, acesse o formulário correspondente e clique em Excluir placar na parte de cima do formulário.
Como alternativa, você pode chamar Players.hide para ocultar o placar de um jogador no app.
Zerar um placar
Só é possível redefinir os dados de progresso de um jogador nos placares de rascunho.
- Para redefinir os placares no Google Play Console, clique em Redefinir progresso na parte de cima do formulário do evento.
- Para redefinir os dados do placar de forma programática, chame a API Management Scoresmethods.
Adicionar traduções para placares
Você pode especificar suas próprias traduções para placares associados ao seu jogo. Antes de fazer isso, conclua as etapas descritas em Como adicionar traduções ao seu jogo. Também é necessário criar um ou mais placares para o jogo.
Para adicionar suas traduções, abra a guia Placares do seu jogo no Google Play Console e selecione um. Na página de detalhes do placar, clique na guia de um idioma adicionado anteriormente na guia Detalhes do jogo. Na página desse idioma, edite o formulário com as traduções. Clique em Salvar para armazenar os detalhes traduzidos do placar.
Ocultar pontuações de placar
Os serviços relacionados a jogos do Google Play oferecem um recurso de proteção contra adulteração de placar que verifica se há pontuações suspeitas e as oculta automaticamente. Esse recurso está disponível apenas para jogos Android.
A proteção contra adulterações é ativada por padrão em novos placares criados para seu jogo Android, mas está desativada para placares já existentes. Para ativar esse recurso em placares já publicados, siga estas etapas:
- No Google Play Console, abra a guia Serviços relacionados a jogos e selecione o jogo na lista.
- Abra a guia Placares e selecione a instância do placar em que você quer ativar a proteção contra adulteração.
- Ative a opção Ativar proteção contra adulteração de placar.
- Clique em Salvar e continuar.
- Publicar o jogo.
Depois que a proteção é ativada para um placar no Google Play Console, pode levar até 24 horas para que ela entre em vigor. As pontuações enviadas antes da ativação não são ocultas retroativamente.
Em algumas situações, pode ser necessário desativar a proteção contra adulterações, por exemplo, se seu jogo for executado na Web e no Android e compartilhar placares nessas plataformas.
Acesse o site do Google Developers para saber como implementar jogos salvos.
Ativar Jogos salvos
Para ativar o serviço Jogos salvos, siga estas etapas no Play Console:
- No Google Play Console, selecione um jogo.
- Na página Configuração dos Serviços relacionados a jogos do Google Play (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração), selecione Editar propriedades.
- Ative a opção Jogos salvos.
- Clique em Salvar.
Depois de executar as etapas acima, pode levar até 24 horas para que o recurso seja ativado no seu jogo. Se você quiser testar o serviço Jogos salvos imediatamente, limpe os dados manualmente no app Google Play Services no dispositivo de teste.
Para limpar os dados em cache no Android, abra Configurações > Apps > Google Play Services, clique em Gerenciar espaço e em Limpar tudo.
Para ver mais informações sobre o serviço Jogos salvos, consulte o Guia de Jogos salvos.
Adicionar traduções
É possível definir suas próprias traduções para os detalhes do jogo, incluindo o nome de exibição, a descrição e os recursos gráficos. Você também pode especificar as próprias traduções para conquistas e placares associados ao jogo.
Para adicionar suas traduções para detalhes do jogo:
- No Google Play Console, selecione um jogo.
- Acesse a página Configuração dos Serviços relacionados a jogos do Google Play (Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração).
- Selecione Editar propriedades.
- Selecione Gerenciar traduções > Gerenciar suas traduções.
- Selecione os idiomas que quer disponibilizar e clique em Aplicar para confirmar a seleção. Na página Propriedades, os idiomas selecionados ficam disponíveis no seletor de idiomas.
- Selecione o idioma que você quer editar e preencha o formulário com as traduções do nome de exibição, da descrição e dos recursos gráficos.
- Clique em Salvar mudanças para armazenar os detalhes traduzidos do jogo.
Para mais informações sobre como adicionar traduções de conquistas e placares, acesse os guias de conquistas e placares.
Ao exibir strings de detalhes do jogo, placar e conquistas, os serviços relacionados a jogos do Google Play usam o idioma mais próximo daquele solicitado pelo usuário. Por exemplo, se a preferência de idioma do dispositivo do usuário estiver definida como francês (Canadá) (fr-CA), mas o jogo tiver suporte apenas para o inglês (Estados Unidos) (en-US) e francês (França) (fr-FR), os serviços relacionados a jogos do Google Play selecionam as strings fr-FR, já que esse é o idioma mais parecido.
Conceder permissões de edição a usuários
Para automatizar a configuração de apps e integrar versões a ferramentas e processos automatizados atuais, você pode usar a API Google Play Game Services Publishing. Veja como ativar o acesso a essa API usando o Play Console.
- Abra o Google Play Console.
- Acesse Configuração
- Caso ainda não o tenha feito, crie um projeto vinculado.
- Próximo à "API de configuração de jogos", clique no botão Ativar.
Gerenciar vários usuários
Se diversos usuários administrarem jogos na sua conta de desenvolvedor, será necessário gerenciar as permissões na página Usuários e permissões do Play Console.