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

Crea un vale de emparejamiento para uno o varios usuarios locales.

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

| parámetro        | descripción                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| localUsers       | La matriz de usuarios locales, junto con los atributos de usuario local, que se incluirán en el vale.        |
| queueName        | La cola a la que pertenece el vale.                                                                          |
| timeoutInSeconds | Cuánto tiempo se intentará buscar partida para el vale, en segundos. El valor predeterminado es 120 segundos |

## Valor devuelto (1 de 3)

El objeto de vale resultante.

## Comentarios (1 de 3)

La biblioteca enviará automáticamente, y de forma asincrónica, todos los usuarios locales de un vale al servicio de emparejamiento. Cada vez que cambie el estado del vale, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). El estado del vale se puede consultar en cualquier momento mediante [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). El vale comienza inmediatamente en el estado `MatchmakingTicketStatus.Creating`.

Cuando el vale se haya completado, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). En ese momento, se habrá encontrado una partida o el vale se habrá detenido debido a un error. En caso de éxito, la partida encontrada se puede consultar mediante [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos los vales existentes en los que un usuario local sea miembro se cancelarán como parte de esta operación.

No se puede encontrar una partida hasta que todos los usuarios remotos especificados en el campo `membersToMatchWith` del parámetro `configuration` se hayan unido al vale mediante [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Método (2 de 3)

Crea un vale de emparejamiento para uno o varios usuarios locales.

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

| parámetro        | descripción                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| localUser        | El usuario local, junto con los atributos de usuario local, que se incluirá en el vale.                      |
| queueName        | La cola a la que pertenece el vale.                                                                          |
| timeoutInSeconds | Cuánto tiempo se intentará buscar partida para el vale, en segundos. El valor predeterminado es 120 segundos |

## Valor devuelto (2 de 3)

El objeto de vale resultante.

## Comentarios (2 de 3)

La biblioteca enviará automáticamente, y de forma asincrónica, todos los usuarios locales de un vale al servicio de emparejamiento. Cada vez que cambie el estado del vale, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). El estado del vale se puede consultar en cualquier momento mediante [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). El vale comienza inmediatamente en el estado `MatchmakingTicketStatus.Creating`.

Cuando el vale se haya completado, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). En ese momento, se habrá encontrado una partida o el vale se habrá detenido debido a un error. En caso de éxito, la partida encontrada se puede consultar mediante [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos los vales existentes en los que un usuario local sea miembro se cancelarán como parte de esta operación.

No se puede encontrar una partida hasta que todos los usuarios remotos especificados en el campo `membersToMatchWith` del parámetro `configuration` se hayan unido al vale mediante [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

***

## Método (3 de 3)

Crea un vale de emparejamiento para uno o varios usuarios locales.

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

| parámetro          | descripción                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------ |
| localUsers         | La matriz de usuarios locales, junto con los atributos de usuario local, que se incluirán en el vale.        |
| queueName          | La cola a la que pertenece el vale.                                                                          |
| membersToMatchWith | Los otros usuarios específicos que se espera que se unan al vale.                                            |
| timeoutInSeconds   | Cuánto tiempo se intentará buscar partida para el vale, en segundos. El valor predeterminado es 120 segundos |

## Valor devuelto (3 de 3)

El objeto de vale resultante.

## Comentarios (3 de 3)

La biblioteca enviará automáticamente, y de forma asincrónica, todos los usuarios locales de un vale al servicio de emparejamiento. Cada vez que cambie el estado del vale, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). El estado del vale se puede consultar en cualquier momento mediante [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). El vale comienza inmediatamente en el estado `MatchmakingTicketStatus.Creating`.

Cuando el vale se haya completado, se proporcionará un [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged). En ese momento, se habrá encontrado una partida o el vale se habrá detenido debido a un error. En caso de éxito, la partida encontrada se puede consultar mediante [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails).

Todos los vales existentes en los que un usuario local sea miembro se cancelarán como parte de esta operación.

No se puede encontrar una partida hasta que todos los usuarios remotos especificados en el campo `membersToMatchWith` del parámetro `configuration` se hayan unido al vale mediante [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId).

## Consulte también

* clase [MatchmakingTicket](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* estructura [MatchUser](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* clase [PFEntityKey](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* clase [PlayFabMultiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* espacio de nombres [PlayFab.Multiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [CreateServerBackfillTicket](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [Especificación de atributos con los tickets](/es/services/playfab/multiplayer/matchmaking/ticket-attributes.md)