Gérer un changement de statistique basée sur les événements

Cette rubrique fournit un exemple de code pour gérer un changement de statistique basée sur les événements. Les exemples sont des fragments de code C++ qui utilisent l’API C plate de l’API des services XBOX (XSAPI). XSAPI transmet les mises à jour de statistiques au moyen du service Real-Time Activity (RTA) et gère les abonnements RTA pour vous.

Avant de commencer

Les fragments de code partagent une même portée et supposent ce qui suit :

xboxLiveContext est un XblContextHandle pour l’utilisateur connecté. Pour en créer un, appelez XblContextCreateHandle.
xboxUserId est l’ID utilisateur XBOX (XUID) de type uint64_t du joueur dont vous voulez recevoir les mises à jour de statistiques.
scid est un const char* qui contient l’ID de configuration de service (SCID) de votre titre.
TotalPuzzlesSolved est un exemple de nom de statistique. Remplacez-le par le nom d’une statistique basée sur les événements configurée pour votre titre.
LogToScreen est une fonction de journalisation de style printf de votre application.

Pour recevoir des notifications sur les changements de statistiques basées sur les événements

Ajoutez un gestionnaire de changement de statistique.
Suivez les statistiques dont vous voulez recevoir les mises à jour.

Pour nettoyer

Arrêtez le suivi des statistiques.
Supprimez un gestionnaire de changement de statistique.

Ajouter un gestionnaire de changement de statistique

Inscrivez un gestionnaire d’événements pour les notifications de changement de statistique à l’aide de l’exemple de code suivant. Le gestionnaire d’événements reçoit un objet XblStatisticChangeEventArgs. Si xboxLiveContext ou le gestionnaire est null, XblUserStatisticsAddStatisticChangedHandler retourne 0 et n’inscrit pas le gestionnaire.

void* context{ nullptr };
XblFunctionContext statisticChangedFunctionContext = XblUserStatisticsAddStatisticChangedHandler(
    xboxLiveContext,
    [](XblStatisticChangeEventArgs eventArgs, void* context) 
    {
        // Handle stat change. 
        LogToScreen("Statistic changed callback: stat changed (%s = %s)",
            eventArgs.latestStatistic.statisticName, 
            eventArgs.latestStatistic.value); 
    },
    context
);

if (statisticChangedFunctionContext == 0)
{
    LogToScreen("XblUserStatisticsAddStatisticChangedHandler failed.");
}

Suivre les statistiques dont vous voulez recevoir les mises à jour

Votre gestionnaire reçoit des mises à jour uniquement pour les statistiques que vous suivez. Appelez XblUserStatisticsTrackStatistics avec les utilisateurs et les noms de statistiques dont vous voulez recevoir les mises à jour. Vous pouvez modifier l’ensemble des statistiques suivies à tout moment, indépendamment de vos gestionnaires.

const char* statisticNames[] = { "TotalPuzzlesSolved" };

HRESULT hr = XblUserStatisticsTrackStatistics(
    xboxLiveContext,
    &xboxUserId,
    1,
    scid,
    statisticNames,
    _countof(statisticNames)
);

if (FAILED(hr))
{
    LogToScreen("XblUserStatisticsTrackStatistics failed: 0x%08X", static_cast<unsigned int>(hr));
}

XblUserStatisticsSubscribeToStatisticChange et XblUserStatisticsUnsubscribeFromStatisticChange sont dépréciées. Elles fonctionnent toujours, mais elles seront supprimées dans une version future et, selon les paramètres de votre compilateur, leurs appels peuvent produire des avertissements de dépréciation. Utilisez plutôt XblUserStatisticsTrackStatistics et XblUserStatisticsStopTrackingStatistics.

Arrêter le suivi des statistiques

Lorsque vous n’avez plus besoin des mises à jour de certaines statistiques, appelez XblUserStatisticsStopTrackingStatistics avec les mêmes utilisateurs, le même SCID et les mêmes noms de statistiques que ceux que vous avez suivis.

hr = XblUserStatisticsStopTrackingStatistics(
    xboxLiveContext,
    &xboxUserId,
    1,
    scid,
    statisticNames,
    _countof(statisticNames)
);

if (FAILED(hr))
{
    LogToScreen("XblUserStatisticsStopTrackingStatistics failed: 0x%08X", static_cast<unsigned int>(hr));
}

Pour arrêter plutôt les mises à jour de toutes les statistiques que vous suivez pour un ensemble d’utilisateurs, appelez XblUserStatisticsStopTrackingUsers au lieu de XblUserStatisticsStopTrackingStatistics.

hr = XblUserStatisticsStopTrackingUsers(
    xboxLiveContext,
    &xboxUserId,
    1
);

if (FAILED(hr))
{
    LogToScreen("XblUserStatisticsStopTrackingUsers failed: 0x%08X", static_cast<unsigned int>(hr));
}

XSAPI compte les requêtes de suivi. Si vous suivez la même statistique pour un utilisateur plus d’une fois, appelez une fonction d’arrêt du suivi le même nombre de fois pour arrêter les mises à jour.

Supprimer un gestionnaire de changement de statistique

Supprimez un gestionnaire d’événements pour les notifications de changement de statistique à l’aide de l’exemple de code suivant.

XblUserStatisticsRemoveStatisticChangedHandler(
    xboxLiveContext,
    statisticChangedFunctionContext
);

XBOX Services

PlayFab

Gérer un changement de statistique basée sur les événements

Avant de commencer

Ajouter un gestionnaire de changement de statistique

Suivre les statistiques dont vous voulez recevoir les mises à jour

Arrêter le suivi des statistiques

Supprimer un gestionnaire de changement de statistique

Voir aussi

​Avant de commencer

​Ajouter un gestionnaire de changement de statistique

​Suivre les statistiques dont vous voulez recevoir les mises à jour

​Arrêter le suivi des statistiques

​Supprimer un gestionnaire de changement de statistique

​Voir aussi

Avant de commencer

Ajouter un gestionnaire de changement de statistique

Suivre les statistiques dont vous voulez recevoir les mises à jour

Arrêter le suivi des statistiques

Supprimer un gestionnaire de changement de statistique

Voir aussi