> ## 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) Um objeto JSON que representa **MultiplayerSession**. O objeto JSON MultiplayerSession tem a especificação a seguir. | Membro | Tipo | Descrição | | - | - | - | | constants | object | Configurações somente leitura que são mescladas com o modelo de sessão para produzir as constantes da sessão. | | properties | object | Alterações a serem mescladas nas propriedades da sessão. | | members.me | object | Constantes e propriedades que funcionam de forma muito semelhante às suas equivalentes de nível superior. Qualquer método PUT exige que o usuário seja membro da sessão e adiciona o usuário, se necessário. Se "me" for especificado como null, o membro que está fazendo a solicitação será removido da sessão. | | members | object | Outros objetos que representam usuários a serem adicionados à sessão, indexados por um índice baseado em zero. O número de membros em uma solicitação sempre começa com 0, mesmo que a sessão já contenha membros. Os membros são adicionados à sessão na ordem em que aparecem na solicitação. As propriedades de membro só podem ser definidas pelo usuário ao qual pertencem. | | servers | object | Valores que indicam atualizações e adições ao conjunto de participantes de servidor associados à sessão. Se um servidor for especificado como null, essa entrada de servidor será removida da sessão. | ## Exemplo de sintaxe 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" } ``` ## Estrutura da solicitação Para obter a estrutura da solicitação associada a esta especificação JSON, consulte [MultiplayerSessionRequest (JSON)](/pt-BR/reference/live/rest/json/json-multiplayersessionrequest). ## Estrutura da resposta ```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 */ } } } } ``` ## Confira também ##### Pai [Referência de objetos JSON (JavaScript Object Notation)](/pt-BR/reference/live/rest/json/atoc-xboxlivews-reference-json) ## Related topics - [Multiplayer Session Directory 개요](/ko/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Información general de Multiplayer Session Directory](/es/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Multiplayer Session Directory の概要](/ja-jp/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [多人游戏会话目录概述](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)