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

# CreateServerBackfillTicket

> CreateServerBackfillTicket

# PlayFabMultiplayer.PlayFabMultiplayerServer.CreateServerBackfillTicket 메서드

서버 백필 티켓을 생성합니다.

```csharp theme={null}
public static MatchmakingTicket CreateServerBackfillTicket(PFEntityKey server, string queueName, 
    List<MatchUser> matchMembers, MultiplayerServerDetails serverDetails, 
    uint timeoutInSeconds = 300)
```

| 매개 변수            | 설명                                                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| server           | 서버 엔터티입니다.                                                                                                                                                                                       |
| queueName        | 티켓이 속하는 큐입니다.                                                                                                                                                                                    |
| matchMembers     | 현재 매치에 있는 멤버입니다.                                                                                                                                                                                 |
| serverDetails    | 티켓이 대상으로 하는 PlayFab Multiplayer Server에 대한 세부 정보입니다. 서버 세부 정보는 선택 사항입니다. 매치 완료 시 클라이언트에 서버 세부 정보를 제공할 필요가 없으면, 이 값은 null일 수 있습니다. 마찬가지로 서버 세부 정보 필드 중 클라이언트에 제공할 필요가 없는 항목은 비어 있거나 null일 수 있습니다. |
| timeoutInSeconds | 티켓에 대한 매치메이킹을 시도하는 시간(초)입니다. 기본값은 300초입니다.                                                                                                                                                       |

## 반환 값

결과 티켓 개체입니다.

## 설명

라이브러리는 자동으로, 그리고 비동기적으로, 서버 백필 티켓을 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 [`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)를 통해 쿼리할 수 있습니다. regionPreferences의 `regionPreferences`에는 서버가 위치한 지역만 포함됩니다.

이 함수를 사용하려면 게임 서버 엔터티 토큰을 설정하기 위해 [`SetEntityToken`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/SetEntityToken)이 이전에 호출되어 있어야 합니다.

이 메서드는 통합된 크로스 플랫폼 헤더에는 존재하지만, Windows와 XBOX에 대해서만 구현되어 있습니다. 다른 플랫폼에서는 오류를 반환합니다.

## 함께 보기

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


## Related topics

- [PlayFab 릴리스 노트 2020](/ko/services/playfab/release-notes/2020.md)
- [서버 백필 티켓 사용 - REST API](/ko/services/playfab/multiplayer/matchmaking/backfill-tickets.md)
- [로비와 매치메이킹을 함께 사용](/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [PlayFabMultiplayerServer class](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/overview.md)
- [PFMultiplayerCreateServerBackfillTicket](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreateserverbackfillticket.md)