player_inventory_item_added - XBOX Game Development Documentation

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

屬性

名稱	類型	描述
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	此事件的來源類型 (PlayFab 合作夥伴、其他後端，或來自 PlayFab API)。
Timestamp	DateTime	與此事件相關聯的時間 (UTC)。

最後修改於 2026年10月6日

⌘I