다음을 통해 공유

XblMultiplayerManagerFindMatch

  • 아티클

매치 메이킹 요청을 서버에 제출합니다.

구문

HRESULT XblMultiplayerManagerFindMatch(  
         const char* hopperName,  
         const char* attributesJson,  
         uint32_t timeoutInSeconds  
)

매개 변수

hopperName _In_z_
형식: char*

이 요청에 대한 호퍼의 이름입니다.

attributesJson _In_opt_z_
형식: char*

선택 사항. 이 요청에 대한 매치 티켓의 특성(JSON 문자열)입니다.

timeoutInSeconds _In_
형식: uint32_t

사용자가 매치에 참가할 때까지 대기하는 최대 시간(초)입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

비고

이 함수는 로비 세션에 대한 매치 메이킹 요청을 MPM(멀티 플레이어 관리자)에 제출합니다. 이 함수를 사용하려면 먼저 타이틀에 대한 서비스 구성에서 호퍼를 구성해야 합니다. 호퍼는 SmartMatch에서 플레이어를 매치시키는 데 사용되는 규칙을 정의합니다. 호퍼에 대한 자세한 내용은 매치 메이킹 개요를 참조하십시오. 로비 세션이 없는 경우, XblMultiplayerManagerInitialize가 호출되지 않았거나 로컬 사용자가 이 함수를 호출하기 전에 로비 세션에 추가되지 않은 경우 오류가 발생합니다. 매치 메이킹이 이미 진행 중인 경우에도 오류가 발생합니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::FindMatchCompleted로 설정된 멀티 플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.

요구 사항

헤더: multiplayer_manager_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

multiplayer_manager_c
XblMultiplayerManagerEstimatedMatchWaitTime