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

# PlayFabMultiplayer.CreateMatchmakingTicket

> PlayFabMultiplayer.CreateMatchmakingTicket

## Méthode (1 sur 3)

Crée un ticket de matchmaking pour un ou plusieurs utilisateurs locaux.

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, uint timeoutInSeconds = 120)
```

| paramètre | description |
| - | - |
| localUsers | Le tableau des utilisateurs locaux, avec les attributs des utilisateurs locaux, à inclure dans le ticket. |
| queueName | La file d'attente à laquelle appartient le ticket. |
| timeoutInSeconds | Durée, en secondes, pendant laquelle tenter le matchmaking du ticket. La valeur par défaut est de 120 secondes |

## Valeur renvoyée (1 sur 3)

L'objet ticket résultant.

## Remarques (1 sur 3)

La bibliothèque soumet automatiquement et de manière asynchrone tous les utilisateurs locaux d'un ticket au service de matchmaking. Chaque fois que l'état du ticket change, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. L'état du ticket peut être interrogé à tout moment via [`Status`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). Le ticket démarre immédiatement dans l'état `MatchmakingTicketStatus.Creating`.

Lorsque le ticket est terminé, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. À ce stade, une correspondance a été trouvée ou le ticket s'est arrêté en raison d'un échec. En cas de réussite, la correspondance trouvée peut être interrogée via [`GetMatchDetails`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Tous les tickets existants dont un utilisateur local est membre sont annulés dans le cadre de cette opération.

Aucune correspondance ne peut être trouvée tant que tous les utilisateurs distants spécifiés dans le champ `membersToMatchWith` du paramètre `configuration` n'ont pas rejoint le ticket via [`JoinMatchmakingTicketFromId`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Méthode (2 sur 3)

Crée un ticket de matchmaking pour un ou plusieurs utilisateurs locaux.

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(MatchUser localUser, string queueName, 
    uint timeoutInSeconds = 120)
```

| paramètre | description |
| - | - |
| localUser | L'utilisateur local, avec ses attributs, à inclure dans le ticket. |
| queueName | La file d'attente à laquelle appartient le ticket. |
| timeoutInSeconds | Durée, en secondes, pendant laquelle tenter le matchmaking du ticket. La valeur par défaut est de 120 secondes |

## Valeur renvoyée (2 sur 3)

L'objet ticket résultant.

## Remarques (2 sur 3)

La bibliothèque soumet automatiquement et de manière asynchrone tous les utilisateurs locaux d'un ticket au service de matchmaking. Chaque fois que l'état du ticket change, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. L'état du ticket peut être interrogé à tout moment via [`Status`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). Le ticket démarre immédiatement dans l'état `MatchmakingTicketStatus.Creating`.

Lorsque le ticket est terminé, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. À ce stade, une correspondance a été trouvée ou le ticket s'est arrêté en raison d'un échec. En cas de réussite, la correspondance trouvée peut être interrogée via [`GetMatchDetails`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Tous les tickets existants dont un utilisateur local est membre sont annulés dans le cadre de cette opération.

Aucune correspondance ne peut être trouvée tant que tous les utilisateurs distants spécifiés dans le champ `membersToMatchWith` du paramètre `configuration` n'ont pas rejoint le ticket via [`JoinMatchmakingTicketFromId`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Méthode (3 sur 3)

Crée un ticket de matchmaking pour un ou plusieurs utilisateurs locaux.

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, List<PFEntityKey> membersToMatchWith, uint timeoutInSeconds = 120)
```

| paramètre | description |
| - | - |
| localUsers | Le tableau des utilisateurs locaux, avec les attributs des utilisateurs locaux, à inclure dans le ticket. |
| queueName | La file d'attente à laquelle appartient le ticket. |
| membersToMatchWith | Les autres utilisateurs spécifiques censés rejoindre le ticket. |
| timeoutInSeconds | Durée, en secondes, pendant laquelle tenter le matchmaking du ticket. La valeur par défaut est de 120 secondes |

## Valeur renvoyée (3 sur 3)

L'objet ticket résultant.

## Remarques (3 sur 3)

La bibliothèque soumet automatiquement et de manière asynchrone tous les utilisateurs locaux d'un ticket au service de matchmaking. Chaque fois que l'état du ticket change, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. L'état du ticket peut être interrogé à tout moment via [`Status`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). Le ticket démarre immédiatement dans l'état `MatchmakingTicketStatus.Creating`.

Lorsque le ticket est terminé, un [`OnMatchmakingTicketStatusChanged`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) est fourni. À ce stade, une correspondance a été trouvée ou le ticket s'est arrêté en raison d'un échec. En cas de réussite, la correspondance trouvée peut être interrogée via [`GetMatchDetails`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Tous les tickets existants dont un utilisateur local est membre sont annulés dans le cadre de cette opération.

Aucune correspondance ne peut être trouvée tant que tous les utilisateurs distants spécifiés dans le champ `membersToMatchWith` du paramètre `configuration` n'ont pas rejoint le ticket via [`JoinMatchmakingTicketFromId`](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

## Voir aussi

* classe [MatchmakingTicket](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* structure [MatchUser](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* classe [PFEntityKey](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* classe [PlayFabMultiplayer](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* espace de noms [PlayFab.Multiplayer](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [CreateServerBackfillTicket](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [Create Matchmaking Ticket](/api-reference/matchmaking/create-matchmaking-ticket.md)
