> ## 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étodo (1 de 3)

Cria um tíquete de matchmaking para um ou mais usuários locais.

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

| parâmetro | descrição |
| - | - |
| localUsers | A matriz de usuários locais, juntamente com os atributos de usuário local, a serem incluídos no tíquete. |
| queueName | A fila à qual o tíquete pertence. |
| timeoutInSeconds | Por quanto tempo tentar fazer o matchmaking do tíquete, em segundos. O padrão é 120 segundos |

## Valor retornado (1 de 3)

O objeto de tíquete resultante.

## Comentários (1 de 3)

A biblioteca enviará, de forma automática e assíncrona, todos os usuários locais de um tíquete ao serviço de matchmaking. Sempre que o status do tíquete mudar, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. O status do tíquete pode ser consultado a qualquer momento por meio de [`Status`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). O tíquete começa imediatamente no estado `MatchmakingTicketStatus.Creating`.

Quando o tíquete for concluído, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. Nesse ponto, uma partida terá sido encontrada ou o tíquete terá sido interrompido devido a uma falha. Em caso de êxito, a partida encontrada pode ser consultada por meio de [`GetMatchDetails`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos os tíquetes existentes dos quais um usuário local seja membro serão cancelados como parte desta operação.

Uma partida não pode ser encontrada até que todos os usuários remotos especificados no campo `membersToMatchWith` do parâmetro `configuration` tenham ingressado no tíquete por meio de [`JoinMatchmakingTicketFromId`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Método (2 de 3)

Cria um tíquete de matchmaking para um ou mais usuários locais.

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

| parâmetro | descrição |
| - | - |
| localUser | O usuário local, juntamente com os atributos de usuário local, a ser incluído no tíquete. |
| queueName | A fila à qual o tíquete pertence. |
| timeoutInSeconds | Por quanto tempo tentar fazer o matchmaking do tíquete, em segundos. O padrão é 120 segundos |

## Valor retornado (2 de 3)

O objeto de tíquete resultante.

## Comentários (2 de 3)

A biblioteca enviará, de forma automática e assíncrona, todos os usuários locais de um tíquete ao serviço de matchmaking. Sempre que o status do tíquete mudar, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. O status do tíquete pode ser consultado a qualquer momento por meio de [`Status`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). O tíquete começa imediatamente no estado `MatchmakingTicketStatus.Creating`.

Quando o tíquete for concluído, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. Nesse ponto, uma partida terá sido encontrada ou o tíquete terá sido interrompido devido a uma falha. Em caso de êxito, a partida encontrada pode ser consultada por meio de [`GetMatchDetails`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos os tíquetes existentes dos quais um usuário local seja membro serão cancelados como parte desta operação.

Uma partida não pode ser encontrada até que todos os usuários remotos especificados no campo `membersToMatchWith` do parâmetro `configuration` tenham ingressado no tíquete por meio de [`JoinMatchmakingTicketFromId`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Método (3 de 3)

Cria um tíquete de matchmaking para um ou mais usuários locais.

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

| parâmetro | descrição |
| - | - |
| localUsers | A matriz de usuários locais, juntamente com os atributos de usuário local, a serem incluídos no tíquete. |
| queueName | A fila à qual o tíquete pertence. |
| membersToMatchWith | Os outros usuários específicos que devem ingressar no tíquete. |
| timeoutInSeconds | Por quanto tempo tentar fazer o matchmaking do tíquete, em segundos. O padrão é 120 segundos |

## Valor retornado (3 de 3)

O objeto de tíquete resultante.

## Comentários (3 de 3)

A biblioteca enviará, de forma automática e assíncrona, todos os usuários locais de um tíquete ao serviço de matchmaking. Sempre que o status do tíquete mudar, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. O status do tíquete pode ser consultado a qualquer momento por meio de [`Status`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). O tíquete começa imediatamente no estado `MatchmakingTicketStatus.Creating`.

Quando o tíquete for concluído, um [`OnMatchmakingTicketStatusChanged`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) será fornecido. Nesse ponto, uma partida terá sido encontrada ou o tíquete terá sido interrompido devido a uma falha. Em caso de êxito, a partida encontrada pode ser consultada por meio de [`GetMatchDetails`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos os tíquetes existentes dos quais um usuário local seja membro serão cancelados como parte desta operação.

Uma partida não pode ser encontrada até que todos os usuários remotos especificados no campo `membersToMatchWith` do parâmetro `configuration` tenham ingressado no tíquete por meio de [`JoinMatchmakingTicketFromId`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

## Confira também

* classe [MatchmakingTicket](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* struct [MatchUser](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* classe [PFEntityKey](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* classe [PlayFabMultiplayer](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* namespace [PlayFab.Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

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