character_virtual_currency_balance_changed - XBOX Game Development Documentation

角色的虚拟货币余额发生变化时触发此事件。

属性

名称	类型	说明
OrderId	String	触发余额变更的订单 ID。
PlayerId	String
TitleId	String
VirtualCurrencyBalance	int32	变更后的新虚拟货币余额。
VirtualCurrencyName	String	余额发生变化的虚拟货币。
VirtualCurrencyPreviousBalance	int32	变更前的旧虚拟货币余额。

通用属性

所有 V1 PlayStream 事件均格式化为 JSON 对象，并共享以下通用属性：

名称	类型	说明
EntityId	String	此事件适用的实体（title、player 等）的标识符。
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	此事件的来源类型（PlayFab 合作伙伴、其他后端或来自 PlayFab API）。
Timestamp	DateTime	与此事件关联的时间（UTC）。

最后修改于 2026年8月13日

相关主题

PlayFab 的 PlayStream 事件模型参考 player_virtual_currency_balance_changed entity_virtual_currency_balances_changed 使用奖品表 PFGetPlayerCombinedInfoResultPayload

⌘I