> ## 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.

# Tratar uma alteração de estatística baseada em eventos

> Exemplo de código da XSAPI para assinar notificações de alteração de estatísticas baseadas em eventos do XBOX Live e limpar manipuladores usando o serviço Real-Time Activity.

Este tópico fornece código de exemplo para tratar uma alteração de estatística baseada em eventos.

**Para obter notificações sobre alterações de estatísticas baseadas em eventos**

1. [Adicionar um manipulador de alteração de estatística](#ID4EM1)
2. [Assinar a alteração de uma estatística específica](#ID4EM2)

**Para limpar**

1. [Remover um manipulador de alteração de estatística](#ID4EM3)
2. [Cancelar a assinatura da alteração de uma estatística específica](#ID4EM4)

<a id="ID4EM1" />

## Adicionar um manipulador de alteração de estatística

Registre um manipulador de eventos para notificações de alteração de estatística usando o código de exemplo a seguir.
O manipulador de eventos recebe um objeto [XblStatisticChangeEventArgs](/pt-BR/reference/live/xsapi-c/user_statistics_c/structs/xblstatisticchangeeventargs).

#### API C simples

```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
);
```

Para obter mais informações, veja o seguinte:

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

<a id="ID4EM2" />

## Assinar a alteração de uma estatística específica

Assine notificações de atualização de estatística por meio do manipulador `XblUserStatisticsSubscribeToStatisticChange` usando o código de exemplo a seguir.

#### API C simples

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

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

<a id="ID4EM3" />

## Remover um manipulador de alteração de estatística

Remova um manipulador de eventos para notificações de alteração de estatística usando o código de exemplo a seguir.

#### API C simples

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

<a id="ID4EM4" />

## Cancelar a assinatura da alteração de uma estatística específica

Cancele uma assinatura de alteração de estatística criada anteriormente usando o código de exemplo a seguir.

#### API C simples

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


## Related topics

- [Código de exemplo de estatísticas e leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-statslb-eb-howto-nav.md)
- [Configuração no portal de estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [Gravar um evento para alimentar uma estatística baseada em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [Configuração no portal de estatísticas em destaque baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)
- [Visão geral das regras de estatística baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)