구문
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
server PFEntityKey*
서버 엔터티입니다.
configuration PFMatchmakingServerBackfillTicketConfiguration*
백필 티켓 구성입니다.
asyncContext void*선택 사항 이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.
ticket PFMatchmakingTicketHandle*라이브러리에서 할당된 출력 결과 티켓 개체입니다.
반환 값
형식: HRESULT 호출에 성공한 경우S_OK이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 기능을 사용하려면 PFMatchmaking.h를 포함하기 전에 PFMULTIPLAYER_INCLUDE_SERVER_APIS를 정의해야 합니다.라이브러리는 자동으로 그리고 비동기적으로 서버 백필 티켓을 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 PFMatchmakingTicketStatusChangedStateChange가 제공됩니다. 티켓 상태는 언제든지 PFMatchmakingTicketGetStatus()를 통해 쿼리할 수 있습니다. 티켓은 즉시
PFMatchmakingTicketStatus::Creating 상태에서 시작합니다. 티켓이 완료되면 PFMatchmakingTicketStatusChangedStateChange가 제공됩니다. 그 시점에 백필 티켓에 대한 매치가 발견되었거나 실패로 인해 티켓이 중지되었습니다. 성공 시, 발견된 매치는 PFMatchmakingTicketGetMatch()를 통해 쿼리할 수 있습니다. PFMatchmakingMatchDetails의
regionPreferences에는 서버가 위치한 지역만 포함됩니다. 구성에 지정된 사용자에 대해 이미 너무 많은 티켓이 있어 티켓 생성에 실패하는 경우, 라이브러리는 미해결 티켓을 투명하게 취소한 다음 티켓 생성을 다시 시도합니다.
이 함수는 게임 서버 엔터티 토큰을 설정하기 위해 PFMultiplayerSetEntityToken()에 대한 이전 호출이 있어야 합니다.