player_inventory_item_added - XBOX Game Development Documentation

このイベントは、アイテムがプレイヤーに付与されたときにトリガーされます。

Properties

Name	Type	Description
Annotation	String	インベントリアイテムに関する任意の詳細情報。
BundleContents	[]	このアイテムと共にバンドルの一部としてプレイヤーに付与された他のアイテムのカタログアイテム ID。
CatalogVersion	String	追加されたアイテムが定義されているカタログのバージョン。
Class	String	追加されたアイテムのクラス。
CouponCode	String	アイテムを付与した引き換えクーポン (存在する場合)。
DisplayName	String	追加されたアイテムの表示名。
Expiration	DateTime	アイテムの有効期限。アイテムが失効しない場合は null になります。
InstanceId	String	追加されたインベントリアイテムの一意のインスタンス ID。
ItemId	String	追加されたインベントリアイテムのカタログアイテム ID。
RemainingUses	uint32	使用回数に制限がある場合の、そのアイテムの残り使用回数。
TitleId	String	このプレイヤーイベントが適用されるタイトルの ID。

Common Properties

すべての V1 PlayStream イベントは JSON オブジェクトとして書式設定されており、次の共通プロパティを共有します。

Name	Type	Description
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年8月13日

関連トピック

PlayFab の PlayStream イベントモデルリファレンス character_inventory_item_added items_added player_tag_added player_added_title

⌘I