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

# player_virtual_currency_balance_changed

> player_virtual_currency_balance_changed event.

玩家的虚拟货币余额发生变化时触发此事件。

## 属性

| 名称 | 类型 | 描述 |
| :- | :- | :- |
| OrderId | String | 触发余额变化的订单 ID |
| TitleId | String | 此玩家事件适用的游戏 ID。 |
| VirtualCurrencyBalance | int32 | 变化后的新虚拟货币余额。 |
| VirtualCurrencyName | String | 余额发生变化的虚拟货币。 |
| VirtualCurrencyPreviousBalance | int32 | 变化前的旧虚拟货币余额。 |

## 常用属性

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

| 名称 | 类型 | 描述 |
| :- | :- | :- |
| EntityId | String | 此事件适用的实体（游戏、玩家等）的标识符。 |
| 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

- [使用奖品表](https://docs.xbox.com/zh-CN/services/playfab/community/leaderboards/tournaments-leaderboards/using-prize-tables.md)
- [针对整个玩家细分的批量操作](https://docs.xbox.com/zh-CN/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)
- [PlayStream 事件模型参考](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/index.md)
- [character_virtual_currency_balance_changed](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Character/character-virtual-currency-balance-changed.md)
- [entity_virtual_currency_balances_changed](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/General/entity-virtual-currency-balances-changed.md)