发布服务器最近玩家

追加或更新组中所有用户的最近玩家（双向）。

此 API 允许游戏服务器追加到一组用户的最近玩家列表，并更新现有的最近玩家条目。组内的所有用户都被添加到彼此的最近玩家列表中（双向）。

最近玩家组示例： [ [A,B,C], [A,D], [E,F] ]。

A 遇到了 B、C 和 D。B 遇到了 A 和 C。D 只遇到了 A 等。

POST /titles/{titleId}/recentplayergroups/server

URI 参数

参数	In	必需	类型	说明
titleId	路径	TRUE	integer	要为其发送请求的游戏的 titleId。

名称	必需	类型	说明
授权	TRUE	integer	调用方必须提供采用 XBL 3.0 授权格式的 XToken。例如，授权: XBL3.0 x=2553948354698;>加密令牌<)
Content-Type	TRUE	字符串	ContentType 必须设置为 application/json

名称	必需	类型	说明
recentPlayerGroups	TRUE	RecentPlayerGroup[]	双向最近玩家组数组。应至少 1 个组，最多 20 个组。在每个组中，应至少有 2 个玩家，最多 100 个玩家。

名称	类型	说明
204 无内容		已成功发送最近玩家请求。
400 错误请求	ErrorResponse	处理请求时出错... 可能的错误代码：“RequestValidationError：请求验证失败。”、“AuthorizationError：不允许调用方访问资源。”
其他状态代码	ThrottledEntity	请求过多。标头重试-之后：整数

名称	类型	说明
id	字符串	另一个用户的 ID（XUID 基 10 整数）。
网络	网络	在其上遇到其他用户的网络。

最近玩家遇到的类型。此字段是可选的，并默认为默认值。默认值没有规定的含义 - 由调用方适当解释此值。

名称	类型	说明
debugMessage	字符串	可用于调试的错误消息的人工可读版本。
errorCode	字符串	错误代码枚举。

名称	类型	说明
XboxLive	字符串

组内的所有用户都在指定时间遇到了对方。每个组必须包含至少 2 个用户，最多 100 个用户。

名称	类型	说明
encounterType	EncounterType	最近玩家遇到的类型。此字段是可选的，并默认为默认值。默认值没有规定的含义 - 由调用方适当解释此值。
recentPlayers	BidirectionalRecentPlayer[]
timestamp	字符串

组内的所有用户都在指定时间遇到了对方。每个组必须包含至少 2 个用户，最多 100 个用户。

名称	类型	说明
recentPlayerGroups	RecentPlayerGroup	双向最近玩家组数组。应至少 1 个组，最多 20 个组。在每个组中，应至少有 2 个玩家，最多 100 个玩家。