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

# C# PlayFab SDK

> .NET 게임, 도구 및 클라우드 서비스를 위한 PlayFab C# SDK 개요와 다운로드 링크, NuGet 패키지, 빠른 시작 가이드를 제공합니다.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/c-sharp/csharp1.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=aa7627d062ecb9ac2066615074906e13" alt="C# Image" width="800" height="250" data-path="images/playfab/sdks/c-sharp/csharp1.png" />

이 C# SDK는 .NET 환경에서 사용됩니다. 클라우드, Windows 및 .NET에서 지원되는 기타 플랫폼에서 실행되도록 설계된 게임 서비스, 도구 및 애플리케이션을 주로 대상으로 구축되었습니다.

## 다운로드 링크

* [C# PlayFab SDK GitHub 저장소](https://github.com/PlayFab/CSharpSDK)
* [C# PlayFab SDK용 NuGet 패키지](https://www.nuget.org/packages/PlayFabAllSDK/)
* [C# PlayFab SDK 빠른 다운로드 링크](https://aka.ms/playfabCsharpsdkdownload)

이 SDK는 오픈 소스 도구인 [SDKGenerator](/services/playfab/sdks/sdkgenerator)를 사용하여 생성됩니다. 최신 API 변경 사항을 반영하기 위해 일반적으로 격주로 SDK를 빌드합니다.

## 이 SDK의 주요 구성 요소

이 C# PlayFab SDK 패키지는 세 가지 API 조합으로 구성됩니다.

1. PlayFabClientSDK - 클라이언트 라이브러리만 포함하며 게임 클라이언트에 통합하도록 설계되었습니다.
2. PlayFabServerSDK - 서버 및 관리자 API만 포함하며 사용자 지정 로직 서버 또는 빌드 프로세스에 통합하도록 설계되었습니다.
3. PlayFabSDK - 모든 API(클라이언트, 서버, 관리자)를 하나의 SDK에 포함하며, 단위 테스트 프로젝트도 포함합니다.

## 이 SDK를 사용해서는 안 되는 경우

프로젝트에 더 적합한 특정 SDK가 있는 경우 C# PlayFab SDK를 사용해서는 안 됩니다.

다음에 대한 특정 PlayFab SDK가 제공됩니다.

* [Unity PlayFab SDK GitHub 저장소](https://github.com/PlayFab/UnitySDK)

여러 PlayFab SDK의 전체 목록은 [PlayFab SDK](/services/playfab/sdks/playfab-sdk-intro)를 참조하세요.

## SDK 사용하기

이 네이티브 C# 프로젝트는 다음 두 가지 방식으로 사용할 수 있습니다.

* 게임 유지 관리를 위한 관리 도구
  * 일반적으로 동기 호출을 연속해서 수행합니다.
  * 각 API 호출은 실행되는 동안 프로그램을 잠그지만, 이러한 유형의 프로그램에서는 문제가 되지 않습니다.
  * 예제 코드에서 `loginTask.Wait()`에 대한 주석을 참조하세요. 이 동기화 패턴은 도구에서 API 호출을 수행할 때 흔히 사용됩니다.

* 네이티브 C#로 작성된 실제 게임
  * API 호출의 비동기적 특성과 C# async/await 기능 키워드를 활용해야 합니다. 비동기 프로그래밍에 대한 자세한 내용은 [Asynchronous Programming with async and await (C#)](https://learn.microsoft.com/en-us/dotnet/csharp/async)을 참조하세요.

## 프로젝트에 SDK 추가

* [C# 클라이언트 SDK 추가 빠른 시작](/services/playfab/sdks/c-sharp/quickstart)

또는 NuGet Package Manager를 사용하여 Visual Studio 프로젝트에 NuGet 패키지를 설치할 수 있습니다. 지침은 [Visual Studio에서 패키지 설치 및 사용](https://learn.microsoft.com/en-us/nuget/quickstart/install-and-use-a-package-in-visual-studio)을 참조하세요. 자세한 내용은 [NuGet 시작하기](https://learn.microsoft.com/en-us/nuget/what-is-nuget)를 참조하세요.


## Related topics

- [C# PlayFab SDK](/services/playfab/sdks/c-sharp/index.md)
- [PlayFab SDK](/zh-CN/services/playfab/sdks/playfab-sdk-intro.md)
- [Legacy C++ PlayFab SDK](/services/playfab/sdks/playfab-cpp/index.md)
- [旧版 C++ PlayFab SDK](/zh-CN/services/playfab/sdks/playfab-cpp/index.md)
- [PlayFab Services SDK](/services/playfab/sdks/c/index.md)