> ## 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.

# 멀티플레이어 서비스 구성

> 세션 템플릿, SmartMatch 호퍼 및 서비스 구성의 사용자 지정 초대 문자열을 포함하여 타이틀에 대한 XBOX 멀티플레이어 서비스를 구성합니다.

이 항목에서는 세션 템플릿, SmartMatch 호퍼 및 사용자 지정 초대 문자열 구성을 포함하는 멀티플레이어 서비스를 구성하는 방법을 설명합니다. 타이틀에서 XBOX 서비스를 활용하려면 먼저 타이틀의 서비스 구성을 정의해야 합니다. 서비스 구성은 XBOX 서비스 클라우드에 존재하며 XBOX 서비스가 게임을 실행하는 장치와 상호 작용하는 방식을 정의합니다.

멀티플레이어 서비스의 다음 세 가지 측면을 구성할 수 있습니다.

* 세션 템플릿
* SmartMatch 호퍼
* 사용자 지정 초대 문자열

## 세션 템플릿

XBOX 멀티플레이어 서비스를 사용하면 플레이어가 세션을 만들고 참여하며, 동일한 세션의 다른 플레이어와 세션 메시지를 교환하고 플레이 결과를 세션에 게시할 수 있습니다. 결과를 게시하면 세션이 정리되고 세션의 모든 플레이어에 대한 순위표가 업데이트됩니다.

예를 들어, 멀티플레이어 세션은 두 명의 플레이어 간의 체스 게임이 될 수 있습니다. 멀티플레이어 세션의 또 다른 예로는 많은 수의 플레이어가 플레이하는 액션 및 어드벤처 타이틀의 지속적인 세션이 될 수 있습니다. 게임이 새 멀티플레이어 세션을 만들 때는 미리 정의된 세션 템플릿을 기반으로 만듭니다. 이 템플릿은 본질적으로 세션을 설명하는 속성을 포함하는 JSON 개체입니다.

새 세션 템플릿을 만들 때 다음 표에 표시된 값을 정의해야 합니다.

| 필드               | 설명                                                                                     |
| ---------------- | -------------------------------------------------------------------------------------- |
| 세션 이름            | 멀티플레이어 세션 템플릿을 특징짓는 이름을 만듭니다. 쉽게 기억하고 인식할 수 있는 이름을 선택하세요. 이름은 최대 100자의 텍스트 문자열이어야 합니다. |
| 계약 버전            | 이 값은 시스템에서 자동으로 채워지며 JSON 계약의 현재 시스템 버전을 나타냅니다. 이 값을 편집하지 마세요.                         |
| 세션 템플릿(JSON 텍스트) | 멀티플레이어 세션과 관련된 다양한 속성을 설명하는 JSON 데이터를 지정합니다.                                           |

JSON 텍스트의 기초로 사용할 수 있는 여러 미리 정의된 템플릿을 포함하여 멀티플레이어 세션 템플릿에 대한 자세한 내용은 [멀티플레이어 세션 템플릿](/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates)을 참조하세요.

<Info>타이틀이 최종 인증을 통과한 후에는 해당 타이틀의 기존 멀티플레이어 세션을 더 이상 변경하거나 삭제할 수 없습니다.</Info>

## SmartMatch 호퍼

SmartMatch 호퍼는 XBOX 멀티플레이어 서비스에 대한 선택적 추가 항목입니다. SmartMatch 호퍼는 XBOX 서버 기반 매치메이킹 서비스의 이름입니다. 다음 정보를 기반으로 플레이어를 함께 그룹화하는 방법을 제공합니다.

* 타이틀에서 제공
* 플레이어 통계에 저장됨
* 플레이어의 기본 설정에서
* Quality of Service(QoS)에서

매치메이킹은 이제 서버 기반입니다. 플레이어는 서비스에 요청을 제공한 다음 나중에 일치가 발견되면 알림을 받을 수 있습니다. 이는 매치메이킹 프로세스가 발생하는 동안 플레이어가 타이틀에서 기다릴 필요가 없다는 것을 의미합니다. 그들은 자유롭게 타이틀의 싱글플레이어 부분을 플레이하거나 심지어 다른 타이틀을 플레이할 수 있으며 여전히 매치메이킹의 후보가 될 수 있습니다. 이 접근 방식은 일치를 찾기 전에 플레이어의 임계 질량을 달성할 필요를 없앱니다.

<Note>매치메이킹 호퍼는 이전에 정의된 세션 템플릿을 기반으로 해야 합니다.</Note>

새 SmartMatch 호퍼를 만들 때 다음 표에 표시된 값을 정의해야 합니다.

| 필드           | 설명                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------ |
| 이름           | 매치메이킹 호퍼를 특징짓는 이름을 입력합니다. 쉽게 기억하고 인식할 수 있는 이름을 선택하세요. 이름은 최대 140자의 텍스트 문자열입니다.                                     |
| 최소 그룹 크기     | 허용 가능한 최소 플레이어 수를 지정합니다. 최솟값은 1입니다.                                                                                |
| 최대 그룹 크기     | 허용 가능한 최대 플레이어 수를 지정합니다. 최댓값은 256입니다.                                                                              |
| 규칙 확장 주기     | 기본값은 3이며 일반적인 플레이어 인구에 대해서는 변경하지 않아야 합니다.                                                                          |
| 순위 호퍼        | 호퍼가 순위 호퍼로 표시되면 해당 호퍼의 플레이어가 서로 차단했더라도 함께 매치될 수 있습니다. 이는 플레이어가 자신보다 더 큰 스킬 레벨을 가진 다른 플레이어를 차단하는 것을 방지하는 데 도움이 됩니다. |
| 세션에서 자동 업데이트 | 이 필드가 활성화되면 세션의 멤버 목록 또는 멤버의 사용자 지정 속성에 대한 변경 사항이 이전에 제출된 티켓에 자동으로 전파됩니다.                                          |

<Info>타이틀이 최종 인증을 통과한 후에는 해당 타이틀의 기존 매치메이킹 호퍼를 더 이상 변경하거나 삭제할 수 없습니다.</Info>

## 사용자 지정 초대 문자열

타이틀이 플레이어에게 멀티플레이어 게임에 참여하도록 초대장을 보낼 때 기본 초대 문자열 대신 사용자 지정 초대 텍스트 문자열을 표시하도록 선택할 수 있습니다. 새 사용자 지정 초대 문자열을 만들 때 다음 표의 값을 정의해야 합니다.

| 필드 | 설명                                                                                           |
| -- | -------------------------------------------------------------------------------------------- |
| ID | 사용자 지정 초대 문자열의 식별자입니다. `custominvitestrings_`가 ID의 시작 부분에 자동으로 추가됩니다. 이 문자열의 최대 길이는 100자입니다. |
| 값  | 사용자 지정 초대 알림에 표시되는 사용자 지정 초대 문자열의 텍스트입니다. 이 문자열의 최대 길이는 100자입니다.                             |

## 추가 정보

멀티플레이어 서비스 구성에 대한 자세한 내용은 다음 항목을 참조하세요.

| 항목 이름                                                                                          | 설명                                                            |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [멀티플레이어 세션 템플릿](/services/xbox-services/multiplayer/mpsd/concepts/live-session-templates)      | 멀티플레이어 세션 템플릿에 대한 간략한 개요를 제공하고 복사하여 수정할 수 있는 여러 템플릿 예제를 제공합니다 |
| [세션 템플릿 상수](/services/xbox-services/multiplayer/mpsd/concepts/live-session-template-constants) | 멀티플레이어 세션 템플릿의 미리 정의된 요소를 설명합니다                               |
| [멀티플레이어에 대규모 세션 사용](/services/xbox-services/multiplayer/mpsd/concepts/live-large-sessions)     | 대규모 세션을 언제 어떻게 사용할지 설명합니다                                     |
