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

# PlayFab Multiplayer Unity 플러그인 개요

> 지원되는 Unity 버전 및 통합 참고 사항을 포함하여 Lobby 및 Matchmaking C++ SDK를 래핑하는 PlayFab Multiplayer Unity 플러그인의 개요.

PlayFab Multiplayer Unity SDK 플러그인은 Unity 게임 개발자의 편의를 위해 만들어진 네이티브 PlayFabMultiplayer C++ 라이브러리 위에 있는 Unity C# 래퍼입니다.

이를 통해 Unity 게임에서 PlayFab Multiplayer 서비스를 사용할 수 있습니다. 현재 여기에는 Lobby 및 Matchmaking이 포함됩니다. 여러 플랫폼에서 게임을 개발하도록 설계되었습니다.

PlayFab Multiplayer Unity 플러그인은 PlayFab "코어" Unity SDK와 함께 작동합니다. PlayFab "코어" Unity SDK는 경제, 리더보드 등과 같은 다른 PlayFab 기능을 제공합니다. 자세한 내용은 [PlayFab Unity SDK](https://github.com/PlayFab/UnitySDK) 및 [PlayFab Unity SDK 문서](/services/playfab/sdks/unity3d)를 참조하세요.

PlayFab Multiplayer Unity 플러그인은 Unity Asset 패키지로 다운로드할 수 있습니다.

## PlayFab Multiplayer Unity 플러그인이 제공하는 API 기능은 무엇인가요?

* Lobby
* Matchmaking
* 다음 플랫폼에 대한 지원:
  * GDK:
    * XBOX Series X|S
    * XBOX One
    * PC
  * Windows
* 위 플랫폼 전반의 크로스 플레이 지원

## PlayFab Multiplayer Unity 플러그인에 포함된 것은 무엇인가요?

* `PlayFabMultiplayer` 클래스가 제공하는 Unity C#으로 작성된 상위 수준 Multiplayer API 및 사용자의 Unity 게임을 PlayFabMultiplayer 라이브러리와 통합하기 위한 프리팹
* 기본 네이티브(C++) Multiplayer 라이브러리 API에 대한 관리 코드 인터페이스를 제공하는 C# interop 계층. 상위 수준 C# API에서 사용됩니다.
* 각 지원 플랫폼에 대한 기본 네이티브(C++) PlayFabMultiplayer 바이너리:
  * GDK용 Multiplayer DLL 라이브러리
  * Windows용 Multiplayer DLL 라이브러리
* PlayFab "코어" Unity SDK 플러그인(필요한 경우 독립적으로 업데이트 가능)

## PlayFab Multiplayer Unity 플러그인 버전 및 플랫폼 간 호환성

PlayFab Multiplayer Unity 플러그인은 플랫폼에 따라 여러 배포 지점(Git 저장소)에서 게시되어 다운로드할 수 있게 됩니다. 일부 배포 지점에 대한 액세스는 제한되어 있습니다. Microsoft 담당자에게 요청을 보내야 하며 추가 단계가 포함될 수 있습니다.

서로 다른 배포 지점에서 다운로드한 버전 간의 호환성에 대한 더 나은 지침을 제공하고, 기본 네이티브 라이브러리의 특정 버전에 대한 참조를 반영하기 위해, PlayFab Multiplayer Unity 플러그인은 사용자 지정 버전 관리 체계를 따릅니다.

### PlayFab Multiplayer Unity 플러그인 버전 관리 체계

```
X.X.X.Y-(distribution-point-indicator).Z
```

예를 들어, `1.2.0.3-gdk.0`(액세스가 제한된 GDK 저장소에서 다운로드한 버전) 또는 `1.2.0.3-ps5.0`(액세스가 제한된 PS5™ 저장소에서 다운로드한, PlayStation®5 전용 Multiplayer 바이너리가 있는 버전).

버전 구성 요소:

* `X.X.X` - 지원되는 모든 플랫폼 전반에서 기본 PlayFabMultiplayer 라이브러리의 가장 낮은 버전입니다. 이는 기본 C++ 라이브러리 버전과의 일반적인 참조 일관성을 위해 사용됩니다. 위 예제에서는 각 플랫폼에 포함된 PlayFabMultiplayer 라이브러리 버전이 `1.2.0` 이상입니다.
* `Y` - 지정된 X.X.X 버전 부분에 대한 Multiplayer Unity C# 계층의 모든 수정 사항의 증분 인덱스입니다.
* `(distribution-point-indicator)` - 특정 PlayFab Multiplayer Unity 플러그인 패키지가 다운로드된 배포 지점을 추적하기 위한 니모닉 코드입니다. 배포 지점에 따라 다릅니다. 예: `gdk`(GDK 개발자를 위한 액세스 제한된 Microsoft Azure DevOps 저장소), `ps5`(PS5 개발자를 위한 액세스 제한된 Microsoft Azure DevOps 저장소) 등.
* `Z` - 배포 지점 고유의 수정 사항의 증분 인덱스입니다(예: 특정 플랫폼에 대해서만 업데이트/패치된 Multiplayer 바이너리).

버전 구성 요소의 숫자가 높을수록 왼쪽에서 오른쪽으로의 중요도에 따라 최신 버전을 의미합니다.

"PlayStation"은 Sony Interactive Entertainment Inc.의 등록 상표 또는 상표입니다.

"PS5"는 Sony Interactive Entertainment Inc.의 등록 상표 또는 상표입니다.

### 서로 다른 배포 지점의 버전 간 호환성

PlayFab Multiplayer Unity 플러그인이 다운로드된 배포 지점에 관계없이, **버전의 처음 네 숫자(`X.X.X.Y`)가 동일한 경우** 다른 배포 지점에서 다운로드한 PlayFab Multiplayer Unity 플러그인과 완전히 호환됨이 보장됩니다. 서로 다른 배포 지점의 호환 버전은 공유 코드가 동일해야 하므로, 서로를 덮어쓰거나 손상시킬 위험 없이 어떤 순서로든 사용자의 Unity 프로젝트에 가져올 수 있습니다. 다만 각각에는 특정 플랫폼에 특정한 일부 추가(공유되지 않은) 파일이 있을 수 있으며, 이들은 겹치지 않아야 합니다.

예를 들어, GDK, PS5 및 Switch를 대상으로 하는 경우, 다음의 모든 PlayFab Multiplayer Unity 플러그인 버전을 Unity 프로젝트에 어떤 순차적 순서로든 가져올 수 있습니다.

* `1.2.0.3-gdk.0`(다른 파일과 함께 GDK용 Multiplayer 바이너리 가져오기)
* `1.2.0.3-ps5.0`(다른 파일과 함께 PS5용 Multiplayer 바이너리 가져오기)
* `1.2.0.3-sw.0`(다른 파일과 함께 Switch용 Multiplayer 바이너리 가져오기)

이러한 각 플러그인에 포함된 공유(크로스 플랫폼) Unity C# 코드는 동일합니다.

## 어떤 Unity 버전이 지원되나요?

Unity 2017부터 시작하여 Unity의 모든 최신 버전을 지원하려고 노력하지만, 선택은 각 특정 플랫폼에 사용 가능한 Unity 개발 애드온의 가용성에 의해 제한될 수 있습니다. 해당 Unity 문서를 참조하세요. 이는 결국 플랫폼 SDK 선택도 제한할 수 있습니다.

일반적으로 각 플랫폼에 사용 가능한 Unity 개발 애드온의 가장 최신 버전 중 하나로 PlayFab Multiplayer Unity 플러그인을 테스트합니다. Unity Editor, Unity 애드온 또는 플랫폼 SDK의 새 버전에서 발생하는 빌드 또는 런타임 문제를 보고해 주시기를 권장합니다.


## Related topics

- [PlayFab Unreal GSDK 플러그인 개요](/ko/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Multiplayer Unity 플러그인 빠른 시작](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [Unity용 PlayFab Multiplayer 시작하기](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-sdk-getting-started.md)
- [PlayFab for Unreal Engine 개요](/ko/services/playfab/sdks/unified-unreal/overview.md)
- [Party Unity plugin quickstart](/ko/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)