> ## 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.

# MatchTicket (JSON)

> MatchTicket (JSON)

# MatchTicket (JSON)

Um objeto JSON que representa um tíquete de correspondência, usado pelos jogadores para localizar outros jogadores por meio do diretório de sessões multijogador (MPSD).

<a id="ID4EN" />

O objeto JSON MatchTicket tem a especificação a seguir.

| Membro | Tipo | Descrição |
| - | - | - |
| serviceConfig | GUID | Identificador de configuração de serviço (SCID) da sessão. |
| hopperName | string | Nome do hopper no qual este tíquete deve ser colocado. |
| giveUpDuration | inteiro com sinal de 32 bits | Tempo máximo de espera (número inteiro de segundos). |
| preserveSession | enumeração | Um valor que indica se a sessão deve ser reutilizada como a sessão na qual a correspondência será feita. Os valores possíveis são "always" ou "never". |
| ticketSessionRef | MultiplayerSessionReference | Objeto <b>MultiplayerSessionReference</b> da sessão na qual o jogador ou grupo está jogando no momento. Este membro é sempre obrigatório. |
| ticketAttributes | matriz de objetos | Coleção de atributos e valores fornecidos pelo usuário sobre os tíquetes dos jogadores. |
| players | matriz de objetos | Coleção de objetos de jogador, cada um com um recipiente de propriedades de atributos fornecidos pelo usuário. |

<a id="ID4EW" />

## Exemplo de sintaxe JSON

```json theme={null}
{
        "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"
          }
        }
      ]
    }
  
    
```

<a id="ID4EEB" />

## Confira também

<a id="ID4EGB" />

##### Pai

[Referência de objetos JSON (JavaScript Object Notation)](/pt-BR/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [MatchmakingTicketMatchMember](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketMatchMember/overview.md)
- [ticket_completed](/services/playfab/api-references/events/Matchmaking/ticket-completed.md)
- [MatchmakingTicketMatchMember.AttributesJSON](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketMatchMember/AttributesJSON.md)
- [Cancel Matchmaking Ticket](/api-reference/matchmaking/cancel-matchmaking-ticket.md)