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

## 메서드 (1/3)

하나 이상의 로컬 사용자를 위한 매치메이킹 티켓을 생성합니다.

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

| 매개 변수            | 설명                                         |
| ---------------- | ------------------------------------------ |
| localUsers       | 티켓에 포함할 로컬 사용자와 로컬 사용자 속성의 배열입니다.          |
| queueName        | 티켓이 속하는 큐입니다.                              |
| timeoutInSeconds | 티켓에 대한 매치메이킹을 시도하는 시간(초)입니다. 기본값은 120초입니다. |

## 반환 값 (1/3)

결과 티켓 개체입니다.

## 설명 (1/3)

라이브러리는 자동으로, 그리고 비동기적으로, 티켓의 모든 로컬 사용자를 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 티켓 상태는 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status)를 통해 언제든지 쿼리할 수 있습니다. 티켓은 즉시 `MatchmakingTicketStatus.Creating` 상태로 시작합니다.

티켓이 완료되면 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 이 시점에는 매치가 발견되었거나 실패로 인해 티켓이 중지된 상태입니다. 성공 시, 발견된 매치는 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails)를 통해 쿼리할 수 있습니다.

이 작업의 일부로 로컬 사용자가 멤버로 포함되어 있는 기존 티켓은 모두 취소됩니다.

`configuration` 매개 변수의 `membersToMatchWith` 필드에 지정된 모든 원격 사용자가 [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId)를 통해 티켓에 참여할 때까지 매치는 발견될 수 없습니다.

***

## 메서드 (2/3)

하나 이상의 로컬 사용자를 위한 매치메이킹 티켓을 생성합니다.

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

| 매개 변수            | 설명                                         |
| ---------------- | ------------------------------------------ |
| localUser        | 티켓에 포함할 로컬 사용자와 로컬 사용자 속성입니다.              |
| queueName        | 티켓이 속하는 큐입니다.                              |
| timeoutInSeconds | 티켓에 대한 매치메이킹을 시도하는 시간(초)입니다. 기본값은 120초입니다. |

## 반환 값 (2/3)

결과 티켓 개체입니다.

## 설명 (2/3)

라이브러리는 자동으로, 그리고 비동기적으로, 티켓의 모든 로컬 사용자를 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 티켓 상태는 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status)를 통해 언제든지 쿼리할 수 있습니다. 티켓은 즉시 `MatchmakingTicketStatus.Creating` 상태로 시작합니다.

티켓이 완료되면 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 이 시점에는 매치가 발견되었거나 실패로 인해 티켓이 중지된 상태입니다. 성공 시, 발견된 매치는 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails)를 통해 쿼리할 수 있습니다.

이 작업의 일부로 로컬 사용자가 멤버로 포함되어 있는 기존 티켓은 모두 취소됩니다.

`configuration` 매개 변수의 `membersToMatchWith` 필드에 지정된 모든 원격 사용자가 [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId)를 통해 티켓에 참여할 때까지 매치는 발견될 수 없습니다.

***

## 메서드 (3/3)

하나 이상의 로컬 사용자를 위한 매치메이킹 티켓을 생성합니다.

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

| 매개 변수              | 설명                                         |
| ------------------ | ------------------------------------------ |
| localUsers         | 티켓에 포함할 로컬 사용자와 로컬 사용자 속성의 배열입니다.          |
| queueName          | 티켓이 속하는 큐입니다.                              |
| membersToMatchWith | 티켓에 참여할 것으로 예상되는 다른 특정 사용자입니다.             |
| timeoutInSeconds   | 티켓에 대한 매치메이킹을 시도하는 시간(초)입니다. 기본값은 120초입니다. |

## 반환 값 (3/3)

결과 티켓 개체입니다.

## 설명 (3/3)

라이브러리는 자동으로, 그리고 비동기적으로, 티켓의 모든 로컬 사용자를 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 티켓 상태는 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status)를 통해 언제든지 쿼리할 수 있습니다. 티켓은 즉시 `MatchmakingTicketStatus.Creating` 상태로 시작합니다.

티켓이 완료되면 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)가 제공됩니다. 이 시점에는 매치가 발견되었거나 실패로 인해 티켓이 중지된 상태입니다. 성공 시, 발견된 매치는 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails)를 통해 쿼리할 수 있습니다.

이 작업의 일부로 로컬 사용자가 멤버로 포함되어 있는 기존 티켓은 모두 취소됩니다.

`configuration` 매개 변수의 `membersToMatchWith` 필드에 지정된 모든 원격 사용자가 [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId)를 통해 티켓에 참여할 때까지 매치는 발견될 수 없습니다.

## 함께 보기

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


## Related topics

- [CreateServerBackfillTicket](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [Specifying attributes with your tickets](/ko/services/playfab/multiplayer/matchmaking/ticket-attributes.md)