다음을 통해 공유


MultiplayerSessionRequest(JSON)

MultiplayerSession 개체 작업에 대해 전달된 요청 JSON 개체입니다.

MultiplayerSessionRequest JSON 개체 사양은 다음과 같습니다.

멤버 유형 설명
constants 개체 세션 템플릿에 병합되어 세션에 대한 상수를 만드는 읽기 전용 설정.
properties 개체 세션 속성에 병합되는 변경 사항.
members.me 개체 해당되는 상위 항목과 같이 작용하는 상수 및 속성. PUT 메서드에서 사용자는 세션의 멤버여야 하고, 필요한 경우 사용자를 추가합니다. "me"가 null로 지정된 경우 요청을 한 멤버는 세션에서 제거됩니다.
members 개체 세션에 추가할 사용자를 나타내는 다른 개체로, 0부터 시작하는 인덱스로 키 지정됩니다. 세션에 이미 멤버가 포함된 경우에도 요청 내 멤버의 수는 항상 0부터 시작합니다. 멤버는 요청에 표시된 순서대로 세션에 추가됩니다. 멤버 속성은 멤버가 속한 사용자만 설정할 수 있습니다.
servers 개체 세션의 연결된 서버 참가자 집합에 대한 업데이트 및 추가 사항을 나타내는 값. 서버가 null로 지정된 경우 해당 서버 항목은 세션에서 제거됩니다.

요청 구조

{
  "constants": { /* Property Bag */ },
  "properties": { /* Property Bag */ },
  "members": {
    // Requires a service principal. Existing members can be deleted by index.
    // Not available on large sessions.
    "5": null,

    // Reservation requests must start with zero. New users will get added in order to the end of the session's member list.
    // Large sessions don't support reservations.
    "reserve_0": {
      "constants": { /* Property Bag */ }
    },
    "reserve_1": {
      "constants": { /* Property Bag */ }
    },

    // Requires a user principal with a xuid claim. Can be 'null' to remove myself from the session.
    "me": {
      "constants": { /* Property Bag */ },
      "properties": { /* Property Bag */ },
    }
  },

  // Requires a server principal.
  "servers": {
    // Can be any name. The value can be 'null' to remove the server from the session.
    "name": {
      "constants": {  /* Property Bag */ },
      "properties": {  /* Property Bag */ }
    }
  }
}

참고 항목

부모

JSON(JavaScript Object Notation) 개체 참조

참조

MultiplayerSession(JSON)

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