XblMatchmakingCreateMatchTicketAsync
매치 메이킹 요청을 서버로 전송하고 티켓 ID와 함께 매치 티켓을 반환합니다. 작업이 완료되면 XblMatchmakingCreateMatchTicketResult를 호출하여 결과를 가져옵니다.
구문
HRESULT XblMatchmakingCreateMatchTicketAsync(
XblContextHandle xboxLiveContext,
XblMultiplayerSessionReference ticketSessionReference,
const char* matchmakingServiceConfigurationId,
const char* hopperName,
const uint64_t ticketTimeout,
XblPreserveSessionMode preserveSession,
const char* ticketAttributesJson,
XAsyncBlock* asyncBlock
)
매개 변수
xboxLiveContext _In_
형식: XblContextHandle
로컬 사용자용 Xbox Live 컨텍스트입니다.
ticketSessionReference _In_
형식: XblMultiplayerSessionReference
매치에 사용할 멀티 플레이 세션입니다.
matchmakingServiceConfigurationId _In_
형식: char*
매치에 대한 서비스 구성 ID입니다.
hopperName _In_
형식: char*
호퍼의 이름입니다.
ticketTimeout _In_
형식: uint64_t
플레이어의 세션 참가 최대 대기 시간입니다.
preserveSession _In_
형식: XblPreserveSessionMode
세션 보존 여부를 나타냅니다.
ticketAttributesJson _In_
형식: char*
세션에 대한 티켓 특성입니다. (선택 사항)
asyncBlock _In_
형식: XAsyncBlock*
이 작업에 대한 AsyncBlock입니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
비고
매치 티켓 개체에는 티켓 ID 및 대기 시간과 같은 서버에서 반환된 정보가 포함되며, 티켓 데이터 개체의 타이틀에서 가져온 지정된 데이터의 복사본도 포함됩니다.
REST 호출
V103 POST /serviceconfigs/{serviceConfigId}/hoppers/{hopperName}을 호출합니다.
요건
헤더: matchmaking_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib