> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # MultiplayerSession (JSON) > MultiplayerSession (JSON) # MultiplayerSession (JSON) Objeto JSON que representa el objeto **MultiplayerSession**. El objeto JSON MultiplayerSession tiene la siguiente especificación. | Miembro | Tipo | Descripción | | - | - | - | | constants | object | Configuraciones de solo lectura que se combinan con la plantilla de sesión para generar las constantes de la sesión. | | properties | object | Cambios que se combinarán con las propiedades de la sesión. | | members.me | object | Constantes y propiedades que funcionan de forma muy similar a sus equivalentes de nivel superior. Cualquier método PUT requiere que el usuario sea miembro de la sesión y agrega al usuario si es necesario. Si "me" se especifica como null, el miembro que realiza la solicitud se quita de la sesión. | | members | object | Otros objetos que representan a los usuarios que se van a agregar a la sesión, identificados por un índice de base cero. El número de miembros de una solicitud siempre comienza en 0, incluso si la sesión ya contiene miembros. Los miembros se agregan a la sesión en el orden en que aparecen en la solicitud. Las propiedades de miembro solo puede establecerlas el usuario al que pertenecen. | | servers | object | Valores que indican actualizaciones y adiciones al conjunto de participantes de servidor asociados a la sesión. Si un servidor se especifica como null, esa entrada de servidor se quita de la sesión. | ## Ejemplo de sintaxis JSON ```json theme={null} { "properties": { "system": { "turn": [] }, "custom": { "KANWE": "MGMSY" } }, "constants": { "system": { "visibility": "open" }, "custom": {} }, "servers": {}, "members": { "first": 0, "end": 1, "count": 1, "accepted": 0, "0": { "next": 1, "pending": true, "properties": { "system": {}, "custom": {} }, "constants": { "system": { "xuid": 5500461 }, "custom": { "8216": "WXMRJ" } } } }, "key": "8d050174-412b-4d51-a29b-d55a34edfdb7~integration~bcd0088d76a94c60be4b75f139243a1f" } ``` ## Estructura de la solicitud Para conocer la estructura de solicitud asociada a esta especificación JSON, consulte [MultiplayerSessionRequest (JSON)](https://devdocs.xbox.com/es/reference/live/rest/json/json-multiplayersessionrequest). ## Estructura de la respuesta ```json theme={null} { // The contract version of this rendering of the session. A function of the contract version of the request and constants/system/version. "contractVersion": 107, // The branch and change number of the session as of this rendering. "branch": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862", "changeNumber": 5, // Use for tracing. // If an empty session is deleted and then restarted, the correlation ID will remain the same. "correlationId": "0fe81338-ee96-46e3-a3b5-2dbbd6c41c3b", // The time that the session began. // If an empty session is deleted and then restarted, this time will be the time of the restart. "startTime": "2009-06-15T13:45:30.0900000Z", // If any timeouts are in progress, this is the time that the next one will fire. "nextTimer": "2009-06-15T13:45:30.0900000Z", // Present during member initialization. // The "stage" goes from "joining" to "measuring" to "evaluating". // If episode #1 fails, then "stage" is set to "failed" and the session cannot be initialized. // Otherwise, when an initialization episode completes, the "initializing" object is removed. // If "autoEvaluate" is set, "evaluating" is skipped. If neither "metrics" nor "measurementServerAddresses" is set, "measuring" is skipped. "initializing": { "stage": "measuring", "stageStartTime": "2009-06-15T13:45:30.0900000Z", "episode": 1 }, // Set after the "measuring" stage of initialization episode #1, if "peerToHostRequirements" is set and no /properties/system/host is set. // Cleared once a /properties/system/host is set. // Host candidates are device tokens listed in order, order of preference. "hostCandidates": [ "ab90a362", "99582e67" ], "constants": { /* Property Bag */ }, "properties": { /* Property Bag */ }, "members": { // On large sessions, at most one entry is present, "me". "1": { "constants": { /* Property Bag */ }, "properties": { /* Property Bag */ }, // Only if the member has accepted. Optional (not set if no gamertag claim was found). "gamertag": "stacy", // This is set when the member uploads a secure device address. It's a case-insensitive string that can be used for equality comparisons. "deviceToken": "9f4032ba7", // This is set to "open", "moderate", or "strict" when the member uploads a V1.x secure device address. "nat": "strict", // This value is removed once the user does their first PUT to the session. "reserved": true, // If the member is active, this is the title in which they are active, in decimal. "activeTitleId": "8397267", // The time the user joined the session. If "reserved" is true, the time the reservation was made. "joinTime": "2009-06-15T13:45:30.0900000Z", // Present if this member is in the /properties/system/turn array, otherwise not. "turn": true, // Set when transitioning out of the "joining" or "measuring" stage if this member doesn't pass. // In order of precedence, could be set to "timeout", "latency", "bandwidthdown", "bandwidthup", "network", "group", or "episode". // The "network" value means the network configuration and/or conditions (such as conflicting NAT) prevented the QoS metrics from being measured. // The only possible value at the end of "joining" is "group". (On timeout from "joining", the reservation is removed.) // The "episode" value is set after a failed "evaluation" stage on all members of the initialization episode that didn't fail during "joining" or "measuring". "initializationFailure": "latency", // If "memberInitialization" is set and the member was added with "initialize": true, this is set to the initialization episode that the member will participate in. // One is a special value used for the members added to a new session at create time. // Removed when the initialization episode ends. "initializationEpisode": 1, // The next member's index, which is the same as 'next' below if there's no more. "next": 4 }, "4": { "next": 5 /* etc */ } }, "membersInfo": { "first": 1, // The first member's index. "next": 5, // The index that the next member added will get. "count": 2, // The number of members. "accepted": 1 // The number of members that are no longer 'reserved'. }, "servers": { "name": { "constants": { /* Property Bag */ }, "properties": { /* Property Bag */ } } } } ``` ## Consulte también ##### Elemento primario [Referencia de objetos de notación de objetos JavaScript (JSON)](https://devdocs.xbox.com/es/reference/live/rest/json/atoc-xboxlivews-reference-json) ## Related topics - [Multiplayer Session Directory overview](https://devdocs.xbox.com/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Multiplayer Session Directory 개요](https://devdocs.xbox.com/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Visão geral do Multiplayer Session Directory](https://devdocs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Información general de Multiplayer Session Directory](https://devdocs.xbox.com/es/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Vue d'ensemble de Multiplayer Session Directory](https://devdocs.xbox.com/fr-CA/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)