> ## 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/zh-CN/services/playfab/api-references/events/data-types/entitylineage.md) | 此实体所属的父实体。 |
| SequenceId | String | 余额变更的序列 ID，用于确保更新按顺序处理。 |
| VirtualCurrencyBalances | Object | 变更后的新虚拟货币余额。仅显示已更新的货币。 |
| VirtualCurrencyContainerId | String | 余额发生变化的容器。 |
| VirtualCurrencyPreviousBalances | Object | 变更前的旧虚拟货币余额。仅显示已更新的货币。 |

## 通用属性

所有 V1 PlayStream 事件均格式化为 JSON 对象，并共享以下通用属性：

| 名称 | 类型 | 说明 |
| :- | :- | :- |
| EntityId | String | 此事件适用的实体（title、player 等）的标识符。 |
| EntityType | String | 此事件适用的实体（player、title 等）的类型。如果 PlayFab 需要对此实体执行操作，则 EntityType 必须为 "player"、"character" 或 "title"。要求 PlayFab 当前不解析的任何实体类型都应加上命名空间前缀（如 "com.mygame.guild"），因为 PlayFab 可能随时开始解析根实体。 |
| EventId | String | PlayFab 为此事件分配的唯一标识符。 |
| EventName | String | 此事件的名称。 |
| EventNamespace | String | 分配给此事件的命名空间。例如："com.myprogram.ads" |
| Source | String | 此 PlayStream 事件的来源名称；如果事件源自我们，则为 PlayFab。 |
| SourceType | [SourceType](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/data-types/sourcetype.md) | 此事件的来源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。 |
| Timestamp | DateTime | 与此事件关联的时间（UTC）。 |


## Related topics

- [PlayStream 事件模型参考](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/index.md)
- [player_virtual_currency_balance_changed](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Player/player-virtual-currency-balance-changed.md)
- [character_virtual_currency_balance_changed](https://docs.xbox.com/zh-CN/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)