PUT (/serviceconfigs//sessiontemplates//sessions/)

세션을 만들거나, 업데이트하거나, 조인합니다.

중요:
이 URI 메서드는 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

설명
URI 매개 변수
HTTP 상태 코드
요청 본문
응답 본문

설명

이 HTTP/REST 메서드는 전송되는 동일한 JSON 요청 본문 템플릿의 하위 집합에 따라 세션을 만들고, 조인하거나, 업데이트합니다. 성공하면 서버에서 반환된 응답을 포함하는 MultiplayerSession 개체를 반환합니다. 이 개체의 특성은 전달된 MultiplayerSession 개체의 특성과 다를 수 있습니다. 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.WriteSessionAsync로 래핑될 수 있습니다. 세션 생성 및 업데이트 작업은 적용할 변경 내용을 나타내는 application/json 본문과 함께 PUT을 사용합니다. 이 작업은 idempotent이므로, 동일한 변경 내용을 여러 번 적용해도 추가 효과가 없습니다. JSON 요청 본문은 세션 데이터 구조를 반영합니다. 모든 필드와 하위 필드는 선택 사항입니다. PUT 메서드의 세션 생성 또는 조인 모드에 대한 와이어 형식은 다음과 같습니다.

참고:
이 패턴을 사용할 때 주의하십시오. 업데이트는 세션의 현재 상태에 관계없이 무조건 적용됩니다.

PUT /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001 HTTP/1.1
         Content-Type: application/json

PUT 메서드의 세션 업데이트 모드에 대한 와이어 형식은 다음과 같습니다.

PUT /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001 HTTP/1.1
         Content-Type: application/json

세션 속성을 업데이트하기 위한 PUT 메서드의 와이어 형식은 다음과 같습니다. 이는 아래 개체만 속성으로 포함된 본문이 있는 세션 URI에 대한 PUT 작업과 동일합니다. 차이점은 세션이 존재하지 않으면 이 작업이 오류 코드 404 Not Found를 반환한다는 것입니다. 이 작업은 If-Match 헤더를 지원합니다.

PUT /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001/properties HTTP/1.1
         Content-Type: application/json

         { "system": { }, "custom": { } }

URI 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | --- | | scid| GUID| 서비스 구성 식별자(SCID). 세션 식별자의 파트 1입니다.| | sessionTemplateName| string| 세션 템플릿의 현재 인스턴스 이름입니다. 세션 식별자의 파트 2입니다.| | sessionName| GUID| 세션의 고유 ID입니다. 세션 식별자의 파트 3입니다.|

HTTP 상태 코드

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

요청 본문

다음은 세션을 만들거나 조인하기 위한 샘플 요청 본문입니다. 다음 요청 본문 멤버는 선택 사항입니다. 요청에서 다른 모든 가능한 멤버는 허용되지 않습니다. | 멤버| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | | constants| object| 세션 템플릿과 병합되어 세션의 상수를 생성하는 읽기 전용 설정입니다. | | properties | object | 세션 속성에 병합할 변경 사항입니다.| | members.me | object| 최상위 대응 요소와 매우 유사하게 작동하는 상수 및 속성입니다. 모든 PUT 메서드는 사용자가 세션의 멤버여야 하며, 필요한 경우 사용자를 추가합니다. “me”가 null로 지정된 경우 요청을 만드는 멤버는 세션에서 제거됩니다. | | members | object| 세션에 추가할 사용자를 나타내는 다른 개체이며, 0부터 시작하는 인덱스로 키가 지정됩니다. 요청의 멤버 수는 세션에 이미 멤버가 포함된 경우에도 항상 0에서 시작합니다. 멤버는 요청에 나타나는 순서대로 세션에 추가됩니다. 멤버 속성은 해당 멤버가 속한 사용자만 설정할 수 있습니다. | | servers | object| 세션의 연결된 서버 참가자 집합에 대한 업데이트 및 추가를 나타내는 값입니다. 서버가 null로 지정된 경우 해당 서버 항목이 세션에서 제거됩니다. |

{
  "properties": {
    "custom": {"KANWE": "MGMSY"},
    "system": {}
  },
  "constants": {
    "custom": {},
    "system": {"visibility": "open"}
  },
  "members": {
    "reserve_0": {
    "constants": {
      "custom": {"type": "leader"},
      "system": {"xuid": "5500461"} }}
   }
}

응답 본문

세션을 만들거나 조인하기 위한 샘플 응답 본문:

{
  "contractVersion": 104,
  "correlationId": "0FE81338-EE96-46E3-A3B5-2DBBD6C41C3B",
  "nextTimer": "2009-06-15T13:45:30.0900000Z",

  "initializing": {
    "stage": "measuring",
    "stageStartTime": "2009-06-15T13:45:30.0900000Z",
    "episode": 1
  },

  "hostCandidates": [ "ab90a362", "99582e67" ],

  "constants": {
    "system": {"visibility": "open"},
    "custom": {}
  },

  "properties": {
     "system": { "turn": [] },
     "custom": { "myProperty": "myValue" }
  },

  "members": {
      "1": {
        "properties": {
        "system": { },
        "custom": { }
      },

      "constants": {
        "system": { "xuid": "5500461" },
        "custom": { }
      }

      "gamertag": "stacy",
      "deviceToken": "9f4032ba7",
      "reserved": true,
      "activeTitleId": "8397267",
      "joinTime": "2009-06-15T13:45:30.0900000Z",
      "turn": true,
      "initializationFailure": "latency",
      "initializationEpisode": 1,
      "next": 4
    },
  },

  "membersInfo": {
      "first": 1,
      "next": 4,
      "count": 1,
      "accepted": 0
  },

  "servers": {
      "name": {
        "constants": { },
        "properties": { }
      }
  }
}

함께 보기

상위

/serviceconfigs//sessiontemplates//sessions/

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

PUT (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

PUT (/serviceconfigs//sessiontemplates//sessions/)

설명

URI 매개 변수

HTTP 상태 코드

요청 본문

응답 본문

함께 보기

상위

​PUT (/serviceconfigs//sessiontemplates//sessions/)

​설명

​URI 매개 변수

​HTTP 상태 코드

​요청 본문

​응답 본문

​함께 보기

상위

PUT (/serviceconfigs//sessiontemplates//sessions/)

설명

URI 매개 변수

HTTP 상태 코드

요청 본문

응답 본문

함께 보기