Mettre à jour les succès gérés par le titre

Cette rubrique couvre les points suivants :

Déverrouiller un succès
Mettre à jour la progression de l’achèvement d’un succès

Déverrouiller un succès

Une fois vos succès configurés via Partner Center et publiés dans votre bac à sable de développement, votre titre peut les déverrouiller en appelant l’API XblAchievementsUpdateAchievementAsync. Pour plus d’informations, consultez l’exemple de code de la section suivante. Pour déverrouiller un succès, définissez percentComplete sur 100. Si l’utilisateur est en ligne, la demande est immédiatement envoyée au service Achievements des services XBOX et déclenche les expériences utilisateur suivantes.

L’utilisateur reçoit une notification de succès déverrouillé.
Le succès spécifié apparaît comme déverrouillé dans la liste des succès de l’utilisateur pour le titre.
Le succès déverrouillé est ajouté au flux d’activité de l’utilisateur.

L’expérience utilisateur est visuellement identique pour les succès, qu’ils utilisent les succès basés sur les événements ou les succès gérés par le titre.

Si l’utilisateur est hors connexion, la demande de déverrouillage est mise en file d’attente localement sur l’appareil de l’utilisateur. Lorsque la connectivité réseau est rétablie, la demande est automatiquement envoyée au service Achievements (aucune action du jeu n’est nécessaire pour la déclencher), et les expériences utilisateur précédentes se produisent comme décrit.

Mettre à jour la progression de l’achèvement d’un succès

Pour mettre à jour la progression d’un utilisateur vers le déverrouillage d’un succès, appelez XblAchievementsUpdateAchievementAsync. Définissez l’argument percentComplete sur un nombre entier compris entre 1 et 100. Pour plus d’informations, consultez l’exemple de code suivant. La progression d’un succès ne peut qu’augmenter. Si percentComplete est défini sur un nombre inférieur à la dernière valeur percentComplete du succès, la mise à jour est ignorée. Par exemple, si la valeur percentComplete du succès avait précédemment été définie sur 75, l’envoi d’une mise à jour avec une valeur de 25 est ignoré. Le succès reste affiché comme achevé à 75 pour cent. Si percentComplete est défini sur 100, le succès est déverrouillé. Si percentComplete est défini sur un nombre supérieur à 100, l’API se comporte comme si vous aviez défini le nombre sur exactement 100.

Mettre à jour les succès du titre actuel

Vous pouvez mettre à jour les succès du titre actuel en appelant XblAchievementsUpdateAchievementAsync, comme suit. API C plate

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = nullptr;
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock }; // Take over ownership of the XAsyncBlock*.
    auto result = XAsyncGetStatus(asyncBlock, false);
    if (SUCCEEDED(result))
    {
        // The achievement was updated.
    }
    else if (result == HTTP_E_STATUS_NOT_MODIFIED)
    {
        // The achievement wasn't updated.
    }
    else
    {
        // The achievement failed to update.
    }
};

HRESULT hr = XblAchievementsUpdateAchievementAsync(
    xboxLiveContext,
    xboxUserId,
    achievementId.c_str(),
    percentComplete,
    asyncBlock.get()
);
if (SUCCEEDED(hr))
{
    // The call succeeded, so release the std::unique_ptr ownership of XAsyncBlock* because the callback will take over ownership.
    // If the call fails, std::unique_ptr will keep ownership and delete XAsyncBlock*.
    asyncBlock.release();
}

Pour plus d’informations, consultez les rubriques suivantes :

Mettre à jour les succès d’un autre titre

Vous pouvez mettre à jour les succès d’un autre titleId à l’aide de XblAchievementsUpdateAchievementForTitleIdAsync, comme suit. API C plate

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = nullptr;
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock }; // Take over ownership of the XAsyncBlock*.
    auto result = XAsyncGetStatus(asyncBlock, false);
    if (SUCCEEDED(result))
    {
        // The achievement was updated.
    }
    else if (result == HTTP_E_STATUS_NOT_MODIFIED)
    {
        // The achievement wasn't updated.
    }
    else
    {
        // The achievement failed to update.
    }
};

HRESULT hr = XblAchievementsUpdateAchievementForTitleIdAsync(
    xboxLiveContext,
    xboxUserId,
    titleId,
    scid,
    achievementId.c_str(),
    percentComplete,
    asyncBlock.get()
);
if (SUCCEEDED(hr))
{
    // The call succeeded, so release the std::unique_ptr ownership of XAsyncBlock* because the callback will take over ownership.
    // If the call fails, std::unique_ptr will keep ownership and delete XAsyncBlock*.
    asyncBlock.release();
}

Pour plus d’informations, consultez les rubriques suivantes :

Retour en haut de cette rubrique.

XBOX Services

PlayFab

Déverrouiller un succès

Mettre à jour la progression de l’achèvement d’un succès

Mettre à jour les succès du titre actuel

Mettre à jour les succès d’un autre titre

​Déverrouiller un succès

​Mettre à jour la progression de l’achèvement d’un succès

​Mettre à jour les succès du titre actuel

​Mettre à jour les succès d’un autre titre

Déverrouiller un succès

Mettre à jour la progression de l’achèvement d’un succès

Mettre à jour les succès du titre actuel

Mettre à jour les succès d’un autre titre