서버 백필 티켓을 생성합니다.
public static MatchmakingTicket CreateServerBackfillTicket(PFEntityKey server, string queueName,
List<MatchUser> matchMembers, MultiplayerServerDetails serverDetails,
uint timeoutInSeconds = 300)
| 매개 변수 | description |
|---|---|
| server | 서버 엔터티입니다. |
| queueName | 티켓이 속한 큐입니다. |
| matchMembers | 현재 매치 중인 멤버입니다. |
| serverDetails | 티켓이 있는 PlayFab Multiplayer Server에 대한 세부 정보입니다. 서버 세부 정보는 선택 사항입니다. 매치 완료 시 클라이언트에 서버 세부 정보를 제공할 필요가 없는 경우 이 값은 null일 수 있습니다. 마찬가지로 클라이언트에 제공할 필요가 없는 서버 세부 정보의 필드는 비어 있거나 null일 수 있습니다. |
| timeoutInSeconds | 티켓 매치 메이킹을 시도하는 기간(초)입니다. 기본값은 300초입니다. |
반환 값
결과 티켓 개체입니다.
설명
라이브러리는 자동으로 비동기적으로 매치 메이킹 서비스에 서버 백필 티켓을 제출합니다. 티켓 상태가 변경될 때마다 OnMatchmakingTicketStatusChanged이(가) 제공됩니다. 티켓 상태는 Status을(를) 통해 언제든지 쿼리할 수 있습니다. 티켓은 MatchmakingTicketStatus.Creating 상태에서 즉시 시작됩니다.
티켓이 완료되면 OnMatchmakingTicketStatusChanged이(가) 제공됩니다. 이 시점에서 백필 티켓에 대한 일치 항목이 발견되었거나 실패로 인해 티켓이 중지됩니다. 성공하면 찾은 일치 항목을 GetMatchDetails을(를) 통해 쿼리할 수 있습니다. regionPreferences 내 regionPreferences에는 서버가 있는 지역만 포함됩니다.
이 함수를 사용하려면 SetEntityToken에 대한 이전 호출로 게임 서버 엔터티 토큰을 설정했어야 합니다.
이 메서드는 통합된 플랫폼 간 헤더에 있지만 Windows 및 Xbox용으로만 구현됩니다. 이러한 메서드는 다른 플랫폼에서는 오류를 반환합니다.
참고 항목
- 클래스 MatchmakingTicket
- 클래스 PFEntityKey
- 구조체 MatchUser
- 클래스 MultiplayerServerDetails
- 클래스 PlayFabMultiplayerServer
- 네임스페이스 PlayFab.Multiplayer