character_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。
PlayerId	String
RemainingUses	uint32	使用回数に制限がある場合、アイテムの残り使用回数。
TitleId	String

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 イベントモデルリファレンス player_inventory_item_added items_added PFCharacterInventory character_consumed_item

⌘I