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

## 메서드(1/2)

티켓 ID와 큐 이름을 사용하여 하나 이상의 로컬 사용자를 매치메이킹 티켓에 참여시킵니다.

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

| 매개 변수              | 설명                                |
| ------------------ | --------------------------------- |
| localUsers         | 티켓에 포함할 로컬 사용자와 로컬 사용자 특성의 배열입니다. |
| ticketId           | 참여할 티켓의 ID입니다.                    |
| queueName          | 티켓이 속한 큐입니다.                      |
| membersToMatchWith | 티켓에 참여할 것으로 예상되는 다른 특정 사용자입니다.    |

## 반환값(1/2)

결과 티켓 개체입니다.

## 설명(1/2)

라이브러리는 자동으로 그리고 비동기적으로 모든 로컬 사용자를 매치메이킹 서비스의 티켓에 참여하도록 제출합니다. 티켓 상태가 변경될 때마다 [`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.Joining` 상태로 시작합니다.

티켓이 완료되면 [`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)를 통해 쿼리할 수 있습니다.

이 작업의 일부로 로컬 사용자가 멤버로 있는 기존의 모든 티켓이 취소됩니다.

***

## 메서드(2/2)

티켓 ID와 큐 이름을 사용하여 하나 이상의 로컬 사용자를 매치메이킹 티켓에 참여시킵니다.

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

| 매개 변수              | 설명                             |
| ------------------ | ------------------------------ |
| localUser          | 티켓에 포함할 로컬 사용자와 로컬 사용자 특성입니다.  |
| ticketId           | 참여할 티켓의 ID입니다.                 |
| queueName          | 티켓이 속한 큐입니다.                   |
| membersToMatchWith | 티켓에 참여할 것으로 예상되는 다른 특정 사용자입니다. |

## 반환값(2/2)

결과 티켓 개체입니다.

## 설명(2/2)

라이브러리는 자동으로 그리고 비동기적으로 모든 로컬 사용자를 매치메이킹 서비스의 티켓에 참여하도록 제출합니다. 티켓 상태가 변경될 때마다 [`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.Joining` 상태로 시작합니다.

티켓이 완료되면 [`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)를 통해 쿼리할 수 있습니다.

이 작업의 일부로 로컬 사용자가 멤버로 있는 기존의 모든 티켓이 취소됩니다.

## 함께 보기

* 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

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