MatchTicket (JSON)

Un objeto JSON que representa un vale de emparejamiento, que los jugadores usan para localizar a otros jugadores mediante el directorio de sesiones multijugador (MPSD). El objeto JSON MatchTicket tiene la siguiente especificación.

Miembro	Tipo	Descripción
serviceConfig	GUID	Identificador de configuración de servicio (SCID) de la sesión.
hopperName	string	Nombre del hopper en el que debe colocarse este vale.
giveUpDuration	entero con signo de 32 bits	Tiempo de espera máximo (número entero de segundos).
preserveSession	enumeración	Un valor que indica si la sesión debe reutilizarse como la sesión en la que realizar el emparejamiento. Los valores posibles son “always” o “never”.
ticketSessionRef	MultiplayerSessionReference	Objeto MultiplayerSessionReference de la sesión en la que el jugador o el grupo está jugando actualmente. Este miembro siempre es obligatorio.
ticketAttributes	matriz de objetos	Colección de atributos y valores proporcionados por el usuario sobre los vales de los jugadores.
players	matriz de objetos	Colección de objetos de jugador, cada uno con un contenedor de propiedades de atributos proporcionados por el usuario.

Sintaxis JSON de ejemplo

{
        "serviceConfig": "07617C5B-3423-4505-B6C6-10A16E1E5DDB",
        "hopperName": "TestHopper",
        "giveUpDuration": 10,
        "preserveSession": "never",
        "ticketSessionRef": {
        "scid": "AFFEABDF-0000-0000-0000-000000000001",
        "templateName": "TestTemplate",
        "sessionName": "5E551041-0000-0000-0000-000000000001"
    },
    "ticketAttributes": {
        "desiredMap": "Test Map",
        "desiredGameType": "Test GameType"
    },
    "players": [
        {
            "xuid": 123412345123,
            "playerAttributes": {
                "skill": 5,
                "ageRange": "teenager"
            }
        },
        {
          "xuid": 123412345124,
          "playerAttributes": {
              "skill": 15,
              "ageRange": "twenty-something"
          }
        }
      ]
    }
  
    

Consulte también

Elemento primario

Referencia de objetos de notación de objetos JavaScript (JSON)

Última modificación el 19 de octubre de 2026

⌘I