다음을 통해 공유

GET(/serviceconfigs/{scid}/hoppers/{name}/stats)

  • 아티클

호퍼의 통계를 가져옵니다.

중요:
이 메서드는 계약 103 이상에서 사용하기 위한 것이며 모든 요청마다 X-Xbl-Contract-Version: 103 이상의 헤더 요소가 필요합니다.

설명

이 HTTP/REST 메서드는 서비스 구성 ID(SCID) 레벨에서 명명된 호퍼의 통계를 가져옵니다. 이 메서드는 Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync API로 래핑될 수 있습니다.

URI 매개 변수

매개 변수 형식 설명
scid GUID 세션에 대한 서비스 구성 식별자(SCID).
이름 문자열 호퍼의 이름입니다.

Authorization

유형 필수 설명 누락된 경우 응답
XUID(사용자 ID) 예 요청하는 사용자는 티켓에서 참조한 티켓 세션의 멤버여야 합니다. 403
권한 및 장치 유형 예 사용자의 deviceType이 콘솔로 설정된 경우 클레임에 멀티 플레이어 권한이 있는 사용자만 이 매치 메이킹 서비스에 대해 호출할 수 있습니다. 403
타이틀 ID/구입 증명/장치 유형 예 매치되는 타이틀은 지정된 타이틀 클레임, 장치 유형 조합에 대한 매치 메이킹을 허용해야 합니다. 403

HTTP 상태 코드

이 서비스는 MPSD에 적용할 때 HTTP 상태 코드를 반환합니다.

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

응답 본문

멤버 유형 설명
hopperName 문자열 선택한 호퍼의 이름.
waitTime 32비트 부호 있는 정수 호퍼에 대한 평균 매칭 시간(초 단위 정수).
population 32비트 부호 있는 정수 호퍼에서 매치를 대기 중인 플레이어 수.

샘플 응답

{
      "hopperName":"contosoawesome2",
      "waitTime":30,
      "population":1
    }

참고 항목

부모

/serviceconfigs/{scid}/hoppers/{name}/stats