Pular para o conteúdo principal

​
XblAchievementsUpdateAchievementAsync

Permite que o progresso das conquistas seja atualizado e que conquistas sejam desbloqueadas.

​
Sintaxe

​
Parâmetros

xboxLiveContext   _In_
Tipo: XblContextHandle Um identificador de contexto do Xbox Live criado com XblContextCreateHandle. xboxUserId   _In_
Tipo: uint64_t A ID de usuário do XBOX do jogador. achievementId   _In_z_
Tipo: char* A ID da conquista codificada em UTF-8, conforme definida pelo XDP ou pelo Dev Center. percentComplete   _In_
Tipo: uint32_t A porcentagem de conclusão da conquista para indicar o progresso. Os valores válidos vão de 1 a 100. Defina como 100 para desbloquear a conquista. O progresso será definido pelo servidor como o valor mais alto enviado async   _In_
Tipo: XAsyncBlock* AsyncBlock alocado pelo chamador.

​
Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

​
Comentários

Esta API funciona mesmo offline no PC e no XBOX One. As atualizações offline serão publicadas pelo sistema quando a conexão for restabelecida, mesmo que o título não esteja em execução. O resultado da operação assíncrona pode ser obtido chamando XAsyncGetStatus dentro do retorno de chamada do AsyncBlock ou após a conclusão do AsyncBlock. Se a conquista já tiver sido desbloqueada ou se o valor de progresso for menor ou igual ao atualmente registrado no servidor, XAsyncGetStatus() dentro do retorno de chamada retornará HTTP_E_STATUS_NOT_MODIFIED (0x80190130L).

​
Chamada REST

V2 POST /users/xuid()/achievements//update

​
Requisitos

Cabeçalho: achievements_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

​
Confira também

achievements_c
Última modificação em 6 de outubro de 2026

Tópicos relacionados

Wrappers de API C# do Unity para o GDKAtualizando conquistas gerenciadas pelo títuloXblAchievementsManagerAddLocalUserEstatísticas e conquistasXblAchievementsUpdateAchievementForTitleIdAsync