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

# entity_virtual_currency_balances_changed

> entity_virtual_currency_balances_changed 이벤트입니다.

이 이벤트는 엔터티의 가상 화폐 잔액이 변경될 때 트리거됩니다.

## 속성

| 이름 | 형식 | 설명 |
| :- | :- | :- |
| EntityChain | String | 이 엔터티에 대한 소유권 체인입니다. |
| EntityLineage | [EntityLineage](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/entitylineage.md) | 이 엔터티가 하위 항목인 엔터티입니다. |
| SequenceId | String | 업데이트가 순서대로 처리되도록 하는 잔액 변경의 시퀀스 ID입니다. |
| VirtualCurrencyBalances | Object | 변경 후의 새 가상 화폐 잔액입니다. 업데이트된 통화만 표시됩니다. |
| VirtualCurrencyContainerId | String | 잔액이 변경된 컨테이너입니다. |
| VirtualCurrencyPreviousBalances | Object | 변경 전의 기존 가상 화폐 잔액입니다. 업데이트된 통화만 표시됩니다. |

## 공통 속성

모든 V1 PlayStream 이벤트는 JSON 객체 형식이며 다음과 같은 공통 속성을 공유합니다:

| 이름 | 형식 | 설명 |
| :- | :- | :- |
| EntityId | String | 이 이벤트가 적용되는 엔터티(타이틀, 플레이어 등)의 식별자입니다. |
| EntityType | String | 이 이벤트가 적용되는 엔터티(플레이어, 타이틀 등)의 유형입니다. PlayFab이 이 엔터티에 대해 작업을 수행하려면 EntityType이 'player', 'character' 또는 'title' 중 하나여야 합니다. PlayFab이 현재 구문 분석하지 않는 엔터티 유형에는 네임스페이스('com.mygame.guild' 등)를 접두사로 붙여야 하며, PlayFab이 언제든지 루트 엔터티를 구문 분석하기 시작할 수 있기 때문입니다. |
| EventId | String | 이 이벤트에 대해 PlayFab이 할당한 고유 식별자입니다. |
| EventName | String | 이 이벤트의 이름입니다. |
| EventNamespace | String | 이 이벤트에 할당된 네임스페이스입니다. 예: 'com.myprogram.ads' |
| Source | String | 이 PlayStream 이벤트의 소스 이름이며, 이벤트가 PlayFab에서 시작된 경우 PlayFab이 됩니다. |
| SourceType | [SourceType](https://docs.xbox.com/ko/services/playfab/api-references/events/data-types/sourcetype.md) | 이 이벤트의 소스 유형입니다(PlayFab 파트너, 다른 백엔드 또는 PlayFab API에서). |
| Timestamp | DateTime | 이 이벤트와 연결된 시간(UTC)입니다. |


## Related topics

- [PlayStream 이벤트 모델 참조](https://docs.xbox.com/ko/services/playfab/api-references/events/index.md)
- [player_virtual_currency_balance_changed](https://docs.xbox.com/ko/services/playfab/api-references/events/Player/player-virtual-currency-balance-changed.md)
- [character_virtual_currency_balance_changed](https://docs.xbox.com/ko/services/playfab/api-references/events/Character/character-virtual-currency-balance-changed.md)
- [Subtract User Virtual Currency](https://docs.xbox.com/api-reference/player-item-management/subtract-user-virtual-currency.md)
- [Add User Virtual Currency](https://docs.xbox.com/api-reference/player-item-management/add-user-virtual-currency.md)