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

# 이벤트 기반 통계 변경 처리

> Real-Time Activity 서비스를 사용하여 XBOX Live 이벤트 기반 통계 변경 알림을 구독하고 핸들러를 정리하기 위한 XSAPI 예제 코드.

이 항목에서는 이벤트 기반 통계 변경을 처리하는 예제 코드를 제공합니다.

**이벤트 기반 통계 변경에 대한 알림을 받으려면**

1. [통계 변경 핸들러 추가](#ID4EM1)
2. [특정 통계 변경 구독](#ID4EM2)

**정리하려면**

1. [통계 변경 핸들러 제거](#ID4EM3)
2. [특정 통계 변경 구독 취소](#ID4EM4)

<a id="ID4EM1" />

## 통계 변경 핸들러 추가

다음 예제 코드를 사용하여 통계 변경 알림에 대한 이벤트 핸들러를 등록합니다.
이벤트 핸들러는 [XblStatisticChangeEventArgs](/reference/live/xsapi-c/user_statistics_c/structs/xblstatisticchangeeventargs) 객체를 받습니다.

#### 플랫 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
);
```

자세한 내용은 다음을 참조하세요.

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

<a id="ID4EM2" />

## 특정 통계 변경 구독

다음 예제 코드를 사용하여 `XblUserStatisticsSubscribeToStatisticChange` 핸들러를 통해 통계 업데이트 알림을 구독합니다.

#### 플랫 C API

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

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

<a id="ID4EM3" />

## 통계 변경 핸들러 제거

다음 예제 코드를 사용하여 통계 변경 알림에 대한 이벤트 핸들러를 제거합니다.

#### 플랫 C API

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

<a id="ID4EM4" />

## 특정 통계 변경 구독 취소

다음 예제 코드를 사용하여 이전에 만든 통계 변경 구독을 취소합니다.

#### 플랫 C API

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


## Related topics

- [이벤트 기반 통계 및 순위표 예제 코드](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-statslb-eb-howto-nav.md)
- [이벤트 기반 통계 가져오기](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)
- [이벤트 기반 통계 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
- [이벤트 기반 주요 통계 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)
- [이벤트 기반 통계 규칙 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)