Pular para o conteúdo principal
Este tópico descreve as diferenças entre conquistas baseadas em eventos e gerenciadas pelo título. As conquistas baseadas em eventos eram chamadas anteriormente de “conquistas na nuvem” ou “Achievements 2013”. As conquistas gerenciadas pelo título eram chamadas anteriormente de “Achievements 2017”. As conquistas gerenciadas pelo título são mais simples do que as conquistas baseadas em eventos, pois usam chamadas diretas, configuração simples e solução de problemas local. O serviço de conquistas gerenciadas pelo título usa um modelo de chamada direta para desbloquear conquistas em novos jogos dos serviços XBOX no XBOX, Windows 10, Android e iOS.
[!NOTE] Recomendamos usar conquistas gerenciadas pelo título para configurar novos títulos.

Introdução

As conquistas baseadas em eventos permitem que você alimente os dados dos recursos dos serviços XBOX, como estatísticas de usuário, conquistas, Rich Presence e multijogador, enviando eventos de telemetria do jogo. Isso oferece muitos benefícios. Por exemplo, um único evento pode atualizar dados de vários recursos dos serviços XBOX, a configuração dos serviços XBOX fica no servidor em vez de no cliente, entre muitos outros benefícios. Nos anos seguintes ao lançamento das conquistas baseadas em eventos, os desenvolvedores compartilharam consistentemente o seguinte feedback.
  1. Desbloquear conquistas com um padrão de chamada direta seria mais fácil. Muitos desenvolvedores criam jogos para várias plataformas e gerações, e um padrão de chamada direta facilita o suporte a várias plataformas. O suporte a chamadas diretas de desbloqueio facilitaria suas necessidades de desenvolvimento de jogos multiplataforma e reduziria o tempo de desenvolvimento.
  2. Configurar conquistas baseadas em eventos é complexo demais. Com o serviço de conquistas baseadas em eventos, a lógica de desbloqueio de uma conquista deve ser configurada nos serviços XBOX para que os serviços saibam como interpretar os dados de estatísticas do título e quando desbloquear a conquista para um usuário. Isso era feito usando uma nova seção “Achievement Rules” da configuração de uma conquista. Embora ter a lógica de desbloqueio na nuvem possa ser poderoso, o requisito adicional de configuração acrescenta complexidade ao design e à criação das conquistas de um título.
  3. O mecanismo de desbloqueio baseado na nuvem é difícil de depurar. Embora o serviço de conquistas baseadas em eventos introduza recursos úteis, ele também pode tornar mais difícil para os desenvolvedores de jogos validar e solucionar problemas com suas conquistas. Isso ocorre porque os desbloqueios de conquistas são disparados indiretamente por regras que ficam no serviço, em vez de serem controlados diretamente pelo próprio jogo.
Os desenvolvedores de jogos também compartilharam o feedback de que valorizam alguns dos recursos introduzidos pelas conquistas baseadas em eventos, como os seguintes:
  1. Recursos de experiência do usuário, como progressão de conquistas, atualizações em tempo real, recompensas de arte conceitual e publicação de desbloqueios em um feed de atividades.
  2. Melhorias de configuração, como uma configuração de serviço em vez de uma configuração local que precisa ser incluída no pacote do jogo (como gameconfig, XLAST e SPA).
  3. A capacidade de editar facilmente as cadeias de caracteres e imagens das conquistas após o lançamento do jogo.
As conquistas gerenciadas pelo título substituem o serviço de conquistas baseadas em eventos e tornam ainda mais fácil configurar conquistas, integrar desbloqueios e atualizações ao código do jogo e validar que as conquistas estão funcionando conforme o esperado.

O que muda com as conquistas gerenciadas pelo título

Requisitos do título

Os requisitos a seguir se aplicam a qualquer título que vá usar o serviço de conquistas gerenciadas pelo título.
  1. Não pode ter sido lançado com conquistas baseadas em eventos. Títulos que já foram lançados e estão usando o serviço de conquistas baseadas em eventos não são elegíveis. Para obter mais informações, veja Por que os títulos existentes não podem “migrar” para o serviço de conquistas gerenciadas pelo título?
  2. Deve usar o XBOX One Software Development Kit de agosto de 2016 ou posterior.
  3. Deve fazer parte de um programa de desenvolvedores gerenciado, como o ID@XBOX. O serviço de conquistas gerenciadas pelo título não está disponível para o Creators Program nem para plataformas legadas, incluindo XBOX 360, Windows 8.x ou anterior, ou Windows Phone 8 ou anterior.

Perguntas frequentes

Se meu título usa estatísticas baseadas em eventos, também preciso usar conquistas baseadas em eventos?

Não. Recomendamos usar conquistas gerenciadas pelo título lado a lado com estatísticas baseadas em eventos.

Por que os desafios não têm suporte no serviço de conquistas gerenciadas pelo título?

Os dados de uso dos jogos XBOX mostraram que a implementação e a apresentação atuais dos desafios não atendem a uma necessidade da maioria dos desenvolvedores de jogos. Continuaremos reunindo contribuições e feedback dos desenvolvedores para que possamos oferecer recursos futuros que atendam às necessidades deles.

Ainda posso adicionar novas conquistas com atualizações de conteúdo se meu título estiver usando o serviço de conquistas gerenciadas pelo título?

Sim. A política de conquistas é a mesma para todos os serviços. Para obter mais informações, veja XR-055: Conquistas e gamerscore.

Por que os títulos existentes não podem “migrar” para o serviço de conquistas gerenciadas pelo título?

Para a grande maioria dos títulos existentes, uma “migração” para o serviço de conquistas gerenciadas pelo título exigiria mais do que atualizar suas configurações de serviço e trocar as gravações de eventos por chamadas de desbloqueio de conquistas. Somente essas alterações já seriam muito caras e trariam um risco significativo de erros e comportamentos indesejados que poderiam deixar as conquistas irreparavelmente quebradas. Além disso, a maioria dos títulos existentes também tem usuários com dados existentes. Tentar converter um jogo ativo que já usa o serviço de conquistas baseadas em eventos seria um esforço muito caro, tanto para o desenvolvedor quanto para o XBOX, e colocaria em grande risco os perfis e as experiências de jogo dos usuários existentes.

Se meu título foi lançado usando o serviço de conquistas baseadas em eventos, algum conteúdo para download (DLC) futuro do título pode mudar para conquistas gerenciadas pelo título?

Todas as conquistas de um título devem usar o mesmo serviço de conquistas. O serviço de conquistas usado pelo jogo base deve ser usado para todas as conquistas futuras do título.

Ao testar conquistas na minha sandbox de desenvolvedor, posso combinar o serviço de conquistas gerenciadas pelo título com o serviço de conquistas baseadas em eventos?

Não. Todas as conquistas de um título devem usar o mesmo serviço de conquistas.

O serviço de conquistas gerenciadas pelo título oferece suporte a desbloqueios de conquistas offline?

Se o título desbloquear uma conquista enquanto o dispositivo estiver offline, a API colocará automaticamente em fila as solicitações de desbloqueio offline. As solicitações de desbloqueio são sincronizadas automaticamente com os serviços XBOX quando o dispositivo restabelece a conectividade de rede, de forma semelhante à experiência offline do serviço de conquistas baseadas em eventos. Os desbloqueios de conquistas não ocorrem enquanto o usuário está offline.

Vejo um novo evento AchievementUpdate no Partner Center. Se meu título usa esse evento, isso significa que ele tem conquistas gerenciadas pelo título?

O evento base AchievementUpdate é exigido pelos serviços XBOX para fins de back-end. Você pode ignorar esse evento base com segurança. Se o seu título configurar um evento usando esse tipo de evento base, essas gravações de eventos serão ignoradas pelos serviços XBOX. Os títulos criados com o serviço de conquistas baseadas em eventos devem continuar configurando seus eventos usando os outros tipos de evento base. Os títulos criados com o serviço de conquistas gerenciadas pelo título não precisam configurar nenhum evento para fins de conquistas.

Como posso redefinir os dados de conquistas de um usuário de teste?

Você pode usar a ferramenta XblPlayerDataReset para redefinir os dados do jogador do XBOX de um usuário de teste, incluindo conquistas. Veja a documentação do XblPlayerDataReset para obter detalhes sobre como usar a ferramenta.
Última modificação em 20 de outubro de 2026