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

> player_inventory_item_added 事件。

當授與玩家物品時，就會觸發此事件。

## 屬性

| 名稱 | 類型 | 描述 |
| :- | :- | :- |
| Annotation | String | 物品欄物品的選擇性詳細資料。 |
| BundleContents | \[] | 作為套件組合的一部分，與此物品一同授與玩家之任何其他物品的目錄物品識別碼。 |
| CatalogVersion | String | 定義所新增物品的目錄版本。 |
| Class | String | 所新增物品的類別。 |
| CouponCode | String | 授與此物品的已兌換優惠券 (如果有的話)。 |
| DisplayName | String | 所新增物品的顯示名稱。 |
| Expiration | DateTime | 物品到期的時間。如果物品不會到期，則值為 null。 |
| InstanceId | String | 所新增物品欄物品的唯一執行個體識別碼。 |
| ItemId | String | 所新增物品欄物品的目錄物品識別碼。 |
| RemainingUses | uint32 | 物品的使用次數 (如果使用次數有限)。 |
| TitleId | String | 此玩家事件所套用之遊戲的識別碼。 |

## 通用屬性

所有 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。 |
| SourceType | [SourceType](/zh-TW/services/playfab/api-references/events/data-types/sourcetype) | 此事件的來源類型 (PlayFab 合作夥伴、其他後端，或來自 PlayFab API)。 |
| Timestamp | DateTime | 與此事件相關聯的時間 (UTC)。 |


## Related topics

- [事件](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [PlayFab 的 PlayStream 事件模型參考](/zh-TW/services/playfab/api-references/events/index.md)
- [character_inventory_item_added](/zh-TW/services/playfab/api-references/events/Character/character-inventory-item-added.md)
- [items_added](/zh-TW/services/playfab/api-references/events/Inventory/items-added.md)
- [Add Inventory Items](/api-reference/inventory/add-inventory-items.md)