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

# player_vc_item_purchased

> player_vc_item_purchased event.

玩家使用虚拟货币购买时触发此事件。

## 属性

| 名称             | 类型     | 描述                 |
| :------------- | :----- | :----------------- |
| CatalogVersion | String | 购买该物品所依据的目录版本。     |
| CurrencyCode   | String | 用于购买该物品的货币。        |
| ItemId         | String | 已购买目录物品的标识符。       |
| PurchaseId     | String | 购买交易的唯一标识符。        |
| Quantity       | int32  | 已购买物品的数量。          |
| StoreId        | String | 购买物品所在的 StoreId。   |
| TitleId        | String | 此玩家事件适用的游戏 ID。     |
| UnitPrice      | uint32 | 每件物品支付的价格，以虚拟货币表示。 |

## 常用属性

所有 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](/services/playfab/api-references/events/data-types/sourcetype) | 此事件的源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。                                                                                                                                          |
| Timestamp      | DateTime                                                                    | 与此事件关联的时间（UTC）。                                                                                                                                                                     |


## Related topics

- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [character_vc_item_purchased](/zh-CN/services/playfab/api-references/events/Character/character-vc-item-purchased.md)
- [items_purchased](/zh-CN/services/playfab/api-references/events/Inventory/items-purchased.md)
- [item_purchased](/zh-CN/services/playfab/api-references/events/CatalogV2/item-purchased.md)
- [ItemPurchasedCurrency 数据类型](/zh-CN/services/playfab/api-references/events/data-types/itempurchasedcurrency.md)