player_ranked_on_leaderboard_version - XBOX Game Development Documentation

當排行榜版本變更時，就會觸發此事件，並為排名最前的玩家產生事件，數量上限由「Leaderboard version change top rank events sent」設定所定義。

屬性

名稱	類型	描述
LeaderboardSource	LeaderboardSource	排行榜值的來源。
Rank	uint32	玩家在排行榜上的排名。
TitleId	String	此玩家事件所套用之遊戲的識別碼。
Value	int32	玩家的排行榜值。
Version	uint32	玩家所排名之排行榜的版本。對於玩家統計資料排行榜，此值與統計資料的版本相符。
VersionChangeBehavior	LeaderboardVersionChangeBehavior	版本變更時，與排行榜值相關的行為。

通用屬性

所有 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