Publicar grupo de jugadores recientes del servidor

Anexa a los jugadores recientes de todos los usuarios de un grupo o los actualiza (bidireccional). Esta API permite que un servidor de juego anexe a las listas de jugadores recientes de un conjunto de usuarios, y actualice las entradas de jugadores recientes existentes. Todos los usuarios de un grupo se agregan a las listas de jugadores recientes de los demás (bidireccional). Ejemplo de grupos de jugadores recientes: [ [A,B,C], [A,D], [E,F] ]. A se encontró con B, C y D. B se encontró con A y C. D solo se encontró con A, y así sucesivamente.

POST /titles/{titleId}/recentplayergroups/server

Parámetros de URI

Parámetro	En	Obligatorio	Tipo	Descripción
titleId	path	TRUE	integer	El titleId del juego para el que se envía la solicitud.

Encabezado de la solicitud

Nombre	Obligatorio	Tipo	Descripción
Authorization	TRUE	integer	El autor de la llamada debe proporcionar un XToken en el formato de autorización XBL 3.0. Por ejemplo, Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type	TRUE	string	ContentType debe establecerse en application/json

Cuerpo de la solicitud

Nombre	Obligatorio	Tipo	Descripción
recentPlayerGroups	TRUE	RecentPlayerGroup[]	La matriz de grupos bidireccionales de jugadores recientes. Debe haber al menos 1 grupo y como máximo 20 grupos. Dentro de cada grupo, debe haber al menos 2 jugadores y como máximo 100.

Respuestas

Nombre	Tipo	Descripción
204 No Content		La solicitud de jugadores recientes se envió correctamente.
400 Bad Request	ErrorResponse	Se produjo un error al procesar la solicitud. Códigos de error posibles: “RequestValidationError: The request validation has failed.”, ” AuthorizationError: The caller is not allowed to access the resource.”
Otros códigos de estado	ThrottledEntity	Demasiadas solicitudes. Encabezados Retry-After: integer

BidirectionalRecentPlayer

Nombre	Tipo	Descripción
id	string	El identificador (un XUID como entero en base 10) de otro usuario.
network	Network	La red en la que se encontró al otro usuario.

EncounterType

El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada.

Nombre	Tipo	Descripción
Default	string
Opponent	string
Teammate	string

ErrorResponse

Nombre	Tipo	Descripción
debugMessage	string	Versión legible del mensaje de error que se puede usar para depurar.
errorCode	string	Enumeración de códigos de error.

Network

Nombre	Tipo	Descripción
XboxLive	string

RecentPlayerGroup

Todos los usuarios de un grupo se han encontrado entre sí a la hora especificada. Cada grupo debe contener al menos 2 usuarios y como máximo 100.

Nombre	Tipo	Descripción
encounterType	EncounterType	El tipo de encuentro de jugadores recientes. Este campo es opcional y su valor predeterminado es Default. Default no tiene un significado prescrito; corresponde al autor de la llamada interpretar este valor de forma adecuada.
recentPlayers	BidirectionalRecentPlayer[]
timestamp	string

ServerRecentPlayerGroupsRequest

Todos los usuarios de un grupo se han encontrado entre sí a la hora especificada. Cada grupo debe contener al menos 2 usuarios y como máximo 100.

Nombre	Tipo	Descripción
recentPlayerGroups	RecentPlayerGroup	La matriz de grupos bidireccionales de jugadores recientes. Debe haber al menos 1 grupo y como máximo 20 grupos. Dentro de cada grupo, debe haber al menos 2 jugadores y como máximo 100.

ThrottledEntity

Nombre	Tipo	Descripción
currentRequests	string	Número actual de solicitudes: simultaneidad o frecuencia.
debugMessage	string	Versión legible del mensaje de limitación que se puede usar para depurar.
limitType	string	El tipo de límite, es decir, simultaneidad o frecuencia.
maxRequests	string	Número máximo de solicitudes permitidas: simultaneidad o frecuencia.
periodInSeconds	string	El período en segundos que se aplica cuando se superan los límites de frecuencia o simultaneidad.
version	string	Versión actual del contrato de limitación.

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

POST /titles/{titleId}/recentplayergroups/server

Publicar grupo de jugadores recientes del servidor

Parámetros de URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Definiciones

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity

​Publicar grupo de jugadores recientes del servidor

​Parámetros de URI

​Encabezado de la solicitud

​Cuerpo de la solicitud

​Respuestas

​Definiciones

​BidirectionalRecentPlayer

​EncounterType

​ErrorResponse

​Network

​RecentPlayerGroup

​ServerRecentPlayerGroupsRequest

​ThrottledEntity

Publicar grupo de jugadores recientes del servidor

Parámetros de URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Definiciones

BidirectionalRecentPlayer

EncounterType

ErrorResponse

Network

RecentPlayerGroup

ServerRecentPlayerGroupsRequest

ThrottledEntity