POST (/serviceconfigs/{scid}/hoppers/{hoppername})

아티클
05/09/2023

지정된 매치 티켓을 만듭니다.

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

비고
URI 매개 변수
Authorization
HTTP 상태 코드
요청 본문
응답 본문

설명

이 HTTP/REST 메서드는 서비스 구성 ID(SCID) 수준에서 특정 이름의 호퍼에 대한 매치 티켓을 만듭니다. 이 메서드는 Microsoft.Xbox.Services.Matchmaking.MatchmakingService.CreateMatchTicketAsync 메서드로 래핑될 수 있습니다.

URI 매개 변수

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

Authorization

유형	필수	설명	누락된 경우 응답
권한 및 장치 유형	예	사용자의 deviceType이 콘솔로 설정된 경우 클레임에 멀티 플레이어 권한이 있는 사용자만 이 매치 메이킹 서비스에 대해 호출할 수 있습니다.	403
장치 유형	예	사용자의 deviceType이 없거나 콘솔이 아닌 장치로 설정된 경우 매치되는 타이틀은 콘솔 전용 타이틀이 아니어야 합니다.	403
타이틀 ID/구입 증명/장치 유형	예	매치되는 타이틀은 지정된 타이틀 클레임, 장치 유형 조합에 대한 매치 메이킹을 허용해야 합니다.	403

HTTP 상태 코드

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

요청 본문

필수 멤버

멤버	유형	설명
serviceConfig	GUID	세션의 SCID입니다.
hopperName	문자열	호퍼의 이름입니다.
giveUpDuration	32비트 부호 있는 정수	최대 대기 시간(초 단위 정수).
preserveSession	열거형	세션이 매치에서 세션으로 재사용되는지 여부를 나타내는 값입니다. 가능한 값은 "always" 및 "never"입니다.
ticketSessionRef	MultiplayerSessionReference	플레이어 또는 그룹이 현재 플레이 중인 세션에 대한 MultiplayerSessionReference 개체입니다.
ticketAttributes	개체 모음입니다.	플레이어 그룹에 대해 사용자가 제공한 속성 및 값입니다.

금지된 멤버

요청에서 다른 모든 멤버는 금지됩니다.

샘플 요청

ticketSessionRef 개체가 참조하는 세션은 매치 티켓을 만들기 전에 생성되어야 하며 세션에는 플레이어별 속성에 따라 매치할 플레이어가 있어야 합니다. 각 플레이어는 MPSD에 대해 세션을 생성하거나 참가해야 하며, 세션에 연결된 매치 속성을 추가해야 합니다. 매치 속성은 각 플레이어의 matchAttrs라는 사용자 지정 속성 필드에 배치됩니다.

생성 또는 참가 요청은 https://sessiondirectory.xboxlive.com/serviceconfigs/{scid}/sessiontemplates/{templatename}/sessions/{sessionname}에 제출되며 다음과 같은 모습일 수 있습니다.

{
   "members": {
     "me": {
       "constants": {
         "system": {
           "xuid": 2535285330879750
         }
      },
      "properties": {
         "custom": {
           "matchAttrs": {
             "skill": 5,
             "ageRange": "teenager"
           }
         }
      }
    }
  }
}

세션이 생성되면 타이틀에서 매치 메이킹 서비스를 호출하여 해당 세션의 티켓을 만들 수 있습니다.

참고: 타이틀은 사용자가 호출을 재시도할 수 있지만 데이터가 실패할 경우 자동으로 호출을 재시도하지 않아야 합니다.

POST /serviceconfigs/{scid}/hoppers/{hoppername}

{
  "giveUpDuration":10,
  "preserveSession": "never",
  "ticketSessionRef": {
     "scid": "ABBACDDC-0000-0000-0000-000000000001",  
     "templateName": "TestTemplate",
     "name": "5E55104-0000-0000-0000-000000000001"
  },
  "ticketAttributes": {
    "desiredMap": "Test Map",
    "desiredGameType": "Test GameType"
  }
}

응답 본문

멤버	유형	설명
ticketId	GUID	생성 중인 티켓 ID입니다.
waitTime	32비트 부호 있는 정수	호퍼에 대한 평균 대기 시간(초 단위 정수)입니다.

{
  "ticketId":"0584338f-a2ff-4eb9-b167-c0e8ddecae72",
  "waitTime":60
}

참고 항목

부모

/serviceconfigs/{scid}/hoppers/{hoppername}

다음을 통해 공유