張貼伺服器最近玩家群組

附加至或更新群組內所有使用者的最近玩家 (雙向)。此 API 可讓遊戲伺服器附加至一組使用者的最近玩家清單，並更新現有的最近玩家項目。群組內的所有使用者都會新增至彼此的最近玩家清單 (雙向)。最近玩家群組範例：[ [A,B,C], [A,D], [E,F] ]。 A 遇到了 B、C 和 D。B 遇到了 A 和 C。D 只遇到了 A，依此類推。

POST /titles/{titleId}/recentplayergroups/server

URI 參數

參數	位置	必要	類型	描述
titleId	path	TRUE	integer	傳送要求的目標遊戲 titleId。

要求標頭

名稱	必要	類型	描述
Authorization	TRUE	integer	呼叫者必須以 XBL 3.0 授權格式提供 XToken。例如，Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType 必須設定為 application/json

要求本文

名稱	必要	類型	描述
recentPlayerGroups	TRUE	RecentPlayerGroup[]	雙向最近玩家群組的陣列。應至少有 1 個群組，最多 20 個群組。每個群組內應至少有 2 位玩家，最多 100 位。

回應

名稱	類型	描述
204 No Content		已成功傳送最近玩家要求。
400 Bad Request	ErrorResponse	處理要求時發生錯誤。可能的錯誤碼：“RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
其他狀態碼	ThrottledEntity	要求過多。標頭 Retry-After: integer

BidirectionalRecentPlayer

名稱	類型	描述
id	string	另一位使用者的識別碼 (十進位整數 XUID)。
network	Network	遇到另一位使用者的網路。

EncounterType

最近玩家相遇的類型。此欄位為選擇性，預設為 Default。Default 沒有規定的意義，由呼叫者自行適當解讀此值。

名稱	類型	描述
Default	string
Opponent	string
Teammate	string

ErrorResponse

名稱	類型	描述
debugMessage	string	可用於偵錯的人類可讀錯誤訊息版本。
errorCode	string	錯誤碼列舉。

Network

名稱	類型	描述
XboxLive	string

RecentPlayerGroup

群組內的所有使用者都在指定的時間彼此相遇。每個群組必須包含至少 2 位、最多 100 位使用者。

名稱	類型	描述
encounterType	EncounterType	最近玩家相遇的類型。此欄位為選擇性，預設為 Default。Default 沒有規定的意義，由呼叫者自行適當解讀此值。
recentPlayers	BidirectionalRecentPlayer[]
timestamp	string

ServerRecentPlayerGroupsRequest

群組內的所有使用者都在指定的時間彼此相遇。每個群組必須包含至少 2 位、最多 100 位使用者。

名稱	類型	描述
recentPlayerGroups	RecentPlayerGroup	雙向最近玩家群組的陣列。應至少有 1 個群組，最多 20 個群組。每個群組內應至少有 2 位玩家，最多 100 位。

ThrottledEntity

名稱	類型	描述
currentRequests	string	目前的要求數 - 並行或速率。
debugMessage	string	可用於偵錯的人類可讀節流訊息版本。
limitType	string	限制類型，即並行或速率。
maxRequests	string	允許的最大要求數 - 並行或速率。
periodInSeconds	string	超過速率或並行限制時套用的期間 (以秒為單位)。
version	string	目前的節流合約版本。

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

張貼伺服器最近玩家群組

張貼伺服器最近玩家群組

URI 參數

要求標頭

要求本文

回應

定義

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity

​張貼伺服器最近玩家群組

​URI 參數

​要求標頭

​要求本文

​回應

​定義

​BidirectionalRecentPlayer

​EncounterType

​ErrorResponse

​Network

​RecentPlayerGroup

​ServerRecentPlayerGroupsRequest

​ThrottledEntity

張貼伺服器最近玩家群組

URI 參數

要求標頭

要求本文

回應

定義

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity