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

Objet JSON représentant un ticket de correspondance, utilisé par les joueurs pour trouver d'autres joueurs via l'annuaire de sessions multijoueurs (MPSD).

<a id="ID4EN" />

L'objet JSON MatchTicket a la spécification suivante.

| Membre | Type | Description |
| - | - | - |
| serviceConfig | GUID | Identificateur de configuration de service (SCID) de la session. |
| hopperName | string | Nom du hopper dans lequel ce ticket doit être placé. |
| giveUpDuration | entier signé 32 bits | Durée d'attente maximale (nombre entier de secondes). |
| preserveSession | énumération | Valeur indiquant si la session doit être réutilisée comme session de mise en correspondance. Les valeurs possibles sont "always" ou "never". |
| ticketSessionRef | MultiplayerSessionReference | Objet <b>MultiplayerSessionReference</b> de la session dans laquelle le joueur ou le groupe joue actuellement. Ce membre est toujours obligatoire. |
| ticketAttributes | tableau d'objets | Collection d'attributs et de valeurs fournis par l'utilisateur concernant les tickets des joueurs. |
| players | tableau d'objets | Collection d'objets player, chacun doté d'un conteneur de propriétés d'attributs fournis par l'utilisateur. |

<a id="ID4EW" />

## Exemple de syntaxe 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" />

## Voir aussi

<a id="ID4EGB" />

##### Parent

[Référence des objets JSON (JavaScript Object Notation)](/fr/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)