As conquistas podem ser uma ótima maneira de aumentar o engajamento dos usuários no seu jogo. Você pode implementar conquistas para incentivar os jogadores a testar recursos que talvez não fossem normalmente usados ou abordar o jogo com diferentes estilos. As conquistas também podem ser uma maneira divertida de os jogadores compararem o progresso entre si e se envolverem em uma competição amigável.
Para saber como implementar conquistas na sua plataforma, consulte Implementações de clientes.
Atributos
Para entender como as conquistas funcionam, é preciso conhecer alguns dos atributos associados a elas.
Estes elementos básicos são associados a cada conquista:
- O ID é uma string exclusiva gerada pelo Google Play Console. Você vai usar esse ID exclusivo para se referir à conquista nos clientes de jogos.
- Name é um nome curto da conquista (por exemplo, "Pieman"). O valor pode ter até 100 caracteres.
- Description é uma descrição concisa da sua conquista. Normalmente, isso informa ao jogador como ganhar a conquista (por exemplo, "Faça uma torta de limão antes do pôr do sol"). O valor pode ter até 500 caracteres.
- Icon é um ícone quadrado associado à conquista. Para acessar práticas recomendadas ao criar ícones de conquista, consulte a seção Diretrizes de ícones.
- List order é a ordem em que as conquistas bloqueadas aparecem quando um jogador visualiza aquelas associadas ao seu jogo. Ela pode estar em qualquer ordem que você quiser. As conquistas desbloqueadas aparecem na parte de cima da lista na ordem em que foram alcançadas.
Estado
As conquistas podem estar em um de três estados diferentes:
- Uma conquista oculta significa que os detalhes sobre ela não aparecem para o jogador. Os serviços relacionados a jogos do Google Play oferecem uma descrição genérica de marcador de posição e um ícone para a conquista quando ela está em um estado oculto. Recomendamos deixar uma conquista oculta se ela tiver uma informação que você não quer revelar sobre seu jogo muito cedo (por exemplo, "Descobrir que você era um fantasma o tempo todo!").
- Uma conquista revelada significa que o jogador sabe sobre a conquista, mas ainda não a ganhou. A maioria das conquistas começa no estado revelado.
- Uma conquista desbloqueada significa que o jogador ganhou a conquista. Uma conquista pode ser desbloqueada off-line. Quando o jogo fica on-line, ele é sincronizado com os serviços relacionados a jogos do Google Play para atualizar o estado desbloqueado da conquista.
Conquistas incrementais
As conquistas podem ser designadas como padrão ou incrementais. Geralmente, uma conquista incremental envolve um progresso gradual do jogador em direção à conquista em um período mais longo. À medida que o jogador avança para a conquista incremental, é possível informar o progresso parcial dele aos serviços relacionados a jogos do Google Play.
O Google Play Services monitora as informações de progresso, alerta o jogo quando o jogador atende aos critérios necessários para desbloquear essa conquista e informa ao jogador o quanto falta para atingir a meta.
As conquistas incrementais são cumulativas em sessões de jogo, e o progresso não pode ser removido ou redefinido dentro do jogo. Por exemplo, "Vencer 50 jogos" seria qualificada como uma conquista incremental. "Vencer três jogos seguidos" não seria, porque o progresso do jogador seria redefinido quando ele perdesse um jogo. "Ter 5 mil fichas de pôquer" também não se qualifica, porque o jogador pode ganhar e perder fichas ao jogar. Quanto às duas últimas conquistas, cabe a você decidir como acompanhar o estado ou a vitória de todas as conquistas do jogador e desbloquear as conquistas padrão, quando o jogador as ganhar.
Ao criar uma conquista incremental, é preciso definir o número total de etapas necessárias para desbloqueá-la. Esse número precisa estar entre 2 e 10 mil. À medida que o usuário progride para desbloquear a conquista, informe aos serviços relacionados a jogos do Google Play o número de etapas adicionais que ele realizou. Quando o número total de etapas atinge o valor de desbloqueio, a conquista é desbloqueada (mesmo que tenha sido ocultada). Não é necessário armazenar o progresso cumulativo do usuário.
Pontos
As conquistas estão associadas a uma pontuação. A pontuação do jogador precisa ser um múltiplo de 5, e um jogo nunca pode ter um total de mais de mil pontos para todas as conquistas, embora possa ter menos. Além disso, nenhuma realização única pode ter mais de 200 pontos.
Monitorar pontos de experiência (XP)
Os jogadores podem ganhar níveis no Perfil de jogo ao ganhar conquistas em jogos ativados no Play Games. Para cada ponto associado a uma conquista, o jogador recebe 100 pontos de experiência (XP) quando ganha a conquista. Resumindo:
XP for an achievement = 100 * (point value for the achievement)
Os serviços relacionados a jogos do Google Play rastreiam os XP recebidos por cada jogador e enviam uma notificação ao app Google Play Games quando o jogador ganha pontos suficientes para "subir de nível". Os jogadores podem visualizar o nível e o histórico de XP na página de perfil no app Google Play Games.
Conquistas mínimas
Um jogo que integra as conquistas precisa ter pelo menos cinco conquistas antes da publicação. É possível testar com menos de cinco conquistas, mas recomendamos que você tenha pelo menos cinco conquistas criadas antes de publicar seu jogo.
Conquistas máximas
O número de conquistas tem um limite de pontos e de distribuição. Com um número máximo de mil pontos e atribuídos cinco pontos a cada conquista, o número máximo de conquistas é 200. No entanto, se forem atribuídos mais pontos às conquistas, o número de conquistas disponíveis vai diminuir.
Adicionar conquistas
Há duas maneiras de criar conquistas usando o Google Play Console:
- Criar uma conquista: adicione definições e metadados para cada conquista.
- Importar conquistas: importe definições e outros metadados de várias conquistas em uma única etapa.
Criar uma conquista
Para criar uma conquista para um jogo novo e não publicado, siga estas etapas:
- No Google Play Console, selecione um jogo.
- Na página Serviços relacionados a jogos do Google Play: conquistas (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 de criar uma conquista, 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 Serviços relacionados a jogos do Google Play: conquistas (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:
- Crie um arquivo ZIP com suas conquistas.
- Enviar o arquivo.
Para mais informações, consulte as diretrizes para arquivos ZIP.
Para importar conquistas:
- No Google Play Console, selecione um jogo.
- Na página Serviços relacionados a jogos do Google Play - Conquistas (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
Depois que você testar e publicar o jogo, todas as conquistas dele também serão publicadas.
Editar uma conquista
Para editar uma conquista já criada, selecione-a na guia Conquistas do Google Play Console. Nesse momento, 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", e você vai poder testá-la. Se estiver funcionando corretamente, selecione Republicar na lista suspensa. Assim, seu jogo será republicado com todas as conquistas atualizadas.
Desfazer uma edição
Se você não gostar da conquista atual e quiser voltar a ela como estava antes, selecione Reverter na lista suspensa do Google Play Console. Assim, todas as suas conquistas serão revertidas para a versão publicada anteriormente.
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 da conquista.
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
Achievementsda 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 isso, recomendamos que os ícones de conquista incluam elementos coloridos para que os usuários possam distinguir 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.
O mesmo ícone é usado em todas as localidades. Portanto, recomendamos não incluir texto ou conteúdo localizado em um ícone.
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 |
|---|---|---|
AchievementsMetadata.csv
|
Obrigatório | Metadados de cada conquista. Consulte Atributos. |
AchievementsLocalizations.csv
|
Opcional | Fornece traduções para nomes e descrições de conquistas. |
AchievementsIconMappings.csv
|
Opcional | Faz a correspondência entre conquistas e os arquivos de ícones. |
| 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.
- Os arquivos CSV não podem ter uma linha de cabeçalho.
- Cada arquivo precisa ter menos de 1 MB.
- O arquivo ZIP não pode conter mais de 203 arquivos.
- 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:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
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 | True ou False
|
| Etapas necessárias | Obrigatório se Incremental Value for True.
|
Número (sem frações ou decimais) |
| Estado inicial | Obrigatório | Hidden ou Revealed
|
| 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
NameeDescriptionsão usados como a localidade padrão. - O campo
Nameprecisa ser exclusivo em todas as conquistas. - Os campos a seguir não podem conter vírgulas:
NameeDescription.
Exemplo de arquivo AchievementsMetadata.csv:
Achievement1,Achievement One,True,100,Hidden,5,20
Achievement2,Achievement Two,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:
Name, Localized name, Localized description, locale
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 Name de AchievementsMetadata.csv.
|
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 compatíveis 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.
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 o ícone fornecido. Ele precisa incluir as informações como valores separados por vírgula na seguinte ordem:
Name, icon filename
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 Name de AchievementsMetadata.csv.
|
| 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.
Exemplo de arquivoAchievementsIconMappings.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
Os ícones mencionados no arquivo 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 seu jogo. Antes de fazer isso, conclua as etapas descritas em Como adicionar traduções ao seu jogo.
Há duas maneiras de fazer isso:
Use 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 fazer upload de traduções de 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 a guia de um idioma adicionado anteriormente na guia Detalhes do jogo.
- Na página de detalhes desse idioma, edite o formulário com as traduções.
- Clique em Salvar para armazenar os detalhes traduzidos da conquista.
Implementações do cliente
Para saber como implementar conquistas na sua plataforma, consulte os seguintes recursos: