GameSession (JSON)
멀티플레이어 세션에 대한 게임 데이터를 나타내는 JSON 개체입니다. GameSession JSON 개체는 다음 사양을 가집니다.| 멤버 | 형식 | 설명 |
|---|---|---|
| creationTime | DateTime | 세션이 만들어진 날짜와 시간(UTC)입니다. |
| customData | 8비트 부호 없는 정수의 배열 | 게임별 세션 데이터 1024바이트입니다. 이 값은 서버에 불투명합니다. |
| displayName | string | 게임 세션의 표시 이름으로, 최대 길이는 128자입니다. 이 값은 서버에 불투명합니다. |
| hasEnded | 부울 값 | 세션이 종료되었으면 true, 그렇지 않으면 false입니다. 이 필드를 true로 설정하면 게임 세션이 읽기 전용으로 표시되어 세션에 더 이상 데이터가 제출되지 않도록 합니다. |
| isClosed | 부울 값 | 세션이 닫혀 있고 더 이상 플레이어를 추가할 수 없으면 true, 그렇지 않으면 false입니다. 이 값이 true이면 세션 참여 요청이 거부됩니다. |
| maxPlayers | 32비트 부호 있는 정수 | 세션에 동시에 참여할 수 있는 최대 플레이어 수입니다. 값의 범위는 2-16입니다. 세션에 최대 플레이어 수가 포함되면 세션 참여를 위한 추가 요청이 거부됩니다. |
| playersCanBeRemovedBy | PlayerAcl | 세션에서 다른 플레이어를 제거할 수 있는 플레이어를 나타내는 값입니다. 가능한 값은 NoOne, Self 및 AnyPlayer입니다. |
| roster | player 개체의 배열 | 세션에 있는 플레이어의 배열입니다. 로스터에는 현재 플레이어와 이전에 세션에 있었지만 떠난 플레이어가 포함됩니다. 로스터의 플레이어 순서는 절대 변경되지 않습니다. 새 플레이어는 배열의 끝에 추가됩니다. |
| seatsAvailable | 32비트 부호 있는 정수 | 최대 플레이어 수에 도달하기 전에 여전히 세션에 참여할 수 있는 플레이어 수입니다. 이 값은 읽기 전용이며 항상 maxPlayers 필드 값보다 작습니다. |
| sessionId | string | 세션이 만들어질 때 MPSD에서 할당한 세션 ID입니다. 이 값은 일반적으로 세션에 저장된 정보에 액세스할 때 URI에 포함됩니다. |
| titleId | 32비트 부호 없는 정수 | 게임 세션을 만드는 타이틀의 ID입니다. |
| variant | 32비트 부호 있는 정수 | 게임 배리언트입니다. 이 값은 서버에 불투명합니다. |
| visibility | VisibilityLevel | 세션 표시 여부를 나타내는 값입니다. 가능한 값은 PlayersCurrentlyInSession, PlayersEverInSession 및 Everyone입니다. |
샘플 JSON 구문
{
"sessionId": "702e5aaf-e7bd-4a7c-abea-9dd4be10edec",
"titleId": 1297287259,
"variant": 1,
"displayName": "Contoso Cards",
"creationTime": "2011-06-23T17:13:06Z",
"customData": null,
"maxPlayers": 4,
"seatsAvailable": 4,
"isClosed": false,
"hasEnded": false,
"roster": [],
"visibility": "PlayersCurrentlyInSession",
"playersCanBeRemovedBy": "Self",
}