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

> PlayFabMultiplayer.JoinMatchmakingTicketFromId

## Método (1 de 2)

Ingressa um ou mais usuários locais em um tíquete de matchmaking usando uma ID de tíquete e um nome de fila.

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(IList<MatchUser> localUsers, 
    string ticketId, string queueName, IList<PFEntityKey> membersToMatchWith)
```

| 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. |
| ticketId | A ID do tíquete no qual ingressar. |
| queueName | A fila à qual o tíquete pertence. |
| membersToMatchWith | Os outros usuários específicos que devem ingressar no tíquete. |

## Valor retornado (1 de 2)

O objeto de tíquete resultante.

## Comentários (1 de 2)

A biblioteca enviará, de forma automática e assíncrona, todos os usuários locais para ingressar no tíquete no 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.Joining`.

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.

***

## Método (2 de 2)

Ingressa um ou mais usuários locais em um tíquete de matchmaking usando uma ID de tíquete e um nome de fila.

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(MatchUser localUser, string ticketId, 
    string queueName, IList<PFEntityKey> membersToMatchWith)
```

| parâmetro | descrição |
| - | - |
| localUser | O usuário local, juntamente com os atributos de usuário local, a ser incluído no tíquete. |
| ticketId | A ID do tíquete no qual ingressar. |
| queueName | A fila à qual o tíquete pertence. |
| membersToMatchWith | Os outros usuários específicos que devem ingressar no tíquete. |

## Valor retornado (2 de 2)

O objeto de tíquete resultante.

## Comentários (2 de 2)

A biblioteca enviará, de forma automática e assíncrona, todos os usuários locais para ingressar no tíquete no 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.Joining`.

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.

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

- [PlayFabMultiplayer.CreateMatchmakingTicket](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateMatchmakingTicket.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.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)
- [MatchmakingTicketStatus](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketStatus.md)