> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestion d'un changement de statistique basée sur les événements

> Exemple de code XSAPI pour s'abonner aux notifications de changement de statistiques XBOX Live basées sur les événements et nettoyer les gestionnaires à l'aide du service Real-Time Activity.

Cette rubrique fournit un exemple de code pour gérer un changement de statistique basée sur les événements.

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

1. [Ajouter un gestionnaire Stat-changed](#ID4EM1)
2. [S'abonner au changement d'une statistique spécifique](#ID4EM2)

**Pour nettoyer**

1. [Supprimer un gestionnaire Stat-changed](#ID4EM3)
2. [Se désabonner du changement d'une statistique spécifique](#ID4EM4)

<a id="ID4EM1" />

## Ajouter un gestionnaire Stat-changed

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](/fr/reference/live/xsapi-c/user_statistics_c/structs/xblstatisticchangeeventargs).

#### API C plate (Flat C API)

```cpp theme={null}
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
);
```

Pour plus d'informations, consultez les éléments suivants :

* [XblStatisticChangeEventArgs](/fr/reference/live/xsapi-c/user_statistics_c/structs/xblstatisticchangeeventargs)
* [XblUserStatisticsAddStatisticChangedHandler](/fr/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsaddstatisticchangedhandler)

<a id="ID4EM2" />

## S'abonner au changement d'une statistique spécifique

Abonnez-vous aux notifications de mise à jour de statistique via le gestionnaire `XblUserStatisticsSubscribeToStatisticChange` à l'aide de l'exemple de code suivant.

#### API C plate (Flat C API)

```cpp theme={null}
XblRealTimeActivitySubscriptionHandle subscriptionHandle{ nullptr };

HRESULT hr = XblUserStatisticsSubscribeToStatisticChange(
    xboxLiveContext,
    xboxUserId,
    scid,
    statisticName.c_str(),
    &subscriptionHandle
);
```

<a id="ID4EM3" />

## Supprimer un gestionnaire Stat-changed

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

#### API C plate (Flat C API)

```cpp theme={null}
XblUserStatisticsRemoveStatisticChangedHandler(
        xboxLiveContext,
        statisticChangedFunctionContext
);
```

<a id="ID4EM4" />

## Se désabonner du changement d'une statistique spécifique

Annulez un abonnement aux changements de statistique créé précédemment à l'aide de l'exemple de code suivant.

#### API C plate (Flat C API)

```cpp theme={null}
hr = XblUserStatisticsUnsubscribeFromStatisticChange(
    xboxLiveContext,
    statisticChangeSubscriptionHandle
);
```


## Related topics

- [Statistiques basées sur les événements et statistiques gérées par le titre](/fr/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm.md)
- [Écrire un événement pour alimenter une statistique basée sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Vue d'ensemble des règles de statistique basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)
- [Programmation du service RTA](/fr/services/xbox-services/fundamentals/rta/how-to/live-programming-rta.md)
- [Obtenir les statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)