> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MatchTicket (JSON)

> MatchTicket (JSON)

# MatchTicket (JSON)

플레이어가 멀티플레이어 세션 디렉터리(MPSD)를 통해 다른 플레이어를 찾기 위해 사용하는 매치 티켓을 나타내는 JSON 개체입니다.

MatchTicket JSON 개체는 다음 사양을 가집니다.

| 멤버 | 형식 | 설명 |
| - | - | - |
| serviceConfig | GUID | 세션의 서비스 구성 식별자(SCID)입니다. |
| hopperName | string | 이 티켓이 배치될 호퍼의 이름입니다. |
| giveUpDuration | 32비트 부호 있는 정수 | 최대 대기 시간(정수 초 단위)입니다. |
| preserveSession | 열거형 | 세션이 매치될 세션으로 재사용되어야 하는지를 나타내는 값입니다. 가능한 값은 "always" 또는 "never"입니다. |
| ticketSessionRef | MultiplayerSessionReference | 플레이어 또는 그룹이 현재 플레이하고 있는 세션에 대한 **MultiplayerSessionReference** 개체입니다. 이 멤버는 항상 필수입니다. |
| ticketAttributes | 개체 배열 | 플레이어의 티켓에 대해 사용자가 제공한 특성 및 값의 컬렉션입니다. |
| players | 개체 배열 | 각각 사용자 제공 특성의 속성 백을 가지는 플레이어 개체의 컬렉션입니다. |

## 샘플 JSON 구문

```json theme={null}
{
        "serviceConfig": "07617C5B-3423-4505-B6C6-10A16E1E5DDB",
        "hopperName": "TestHopper",
        "giveUpDuration": 10,
        "preserveSession": "never",
        "ticketSessionRef": {
        "scid": "AFFEABDF-0000-0000-0000-000000000001",
        "templateName": "TestTemplate",
        "sessionName": "5E551041-0000-0000-0000-000000000001"
    },
    "ticketAttributes": {
        "desiredMap": "Test Map",
        "desiredGameType": "Test GameType"
    },
    "players": [
        {
            "xuid": 123412345123,
            "playerAttributes": {
                "skill": 5,
                "ageRange": "teenager"
            }
        },
        {
          "xuid": 123412345124,
          "playerAttributes": {
              "skill": 15,
              "ageRange": "twenty-something"
          }
        }
      ]
    }
  
    
```

## 함께 보기

##### 상위

[JSON(JavaScript Object Notation) 개체 참조](/ko/reference/live/rest/json/atoc-xboxlivews-reference-json)


## Related topics

- [Using SmartMatch matchmaking](/services/xbox-services/multiplayer/matchmaking/concepts/live-matchmaking-how-tos.md)
- [Matchmaking overview](/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview.md)
- [Multiplayer tasks](/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Multiplayer concepts overview](/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)
- [Matchmaking quickstart](/services/playfab/multiplayer/matchmaking/quickstart.md)