PFMultiplayerCreateServerBackfillTicket
서버 백필 티켓을 생성합니다.
구문
HRESULT PFMultiplayerCreateServerBackfillTicket(
PFMultiplayerHandle handle,
const PFEntityKey* server,
const PFMatchmakingServerBackfillTicketConfiguration* configuration,
void* asyncContext,
PFMatchmakingTicketHandle* ticket
)
매개 변수
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()를 통해 쿼리할 수 있습니다.
regionPreferences
PFMatchmakingMatchDetails의 에는 서버가 있는 지역만 포함됩니다.
구성에 지정된 사용자에 대한 티켓이 너무 많기 때문에 티켓 만들기가 실패하면 라이브러리는 해당 미해결 티켓을 투명하게 취소한 다음 티켓 만들기를 다시 시도합니다.
이 함수를 사용하려면 게임 서버 엔터티 토큰을 설정하기 위해 PFMultiplayerSetEntityToken() 에 대한 이전 호출이 수행되어야 합니다.
요구 사항
헤더: PFMatchmaking.h