> ## 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) 生成。我们通常每两周构建一次 SDK,以跟上最新的 API 变更。

## 此 SDK 的主要组件

此 C# PlayFab SDK 包由三种不同的 API 组合组成。

1. PlayFabClientSDK - 仅包含客户端库,面向集成到游戏客户端。
2. PlayFabServerSDK - 仅包含服务器和管理 API,面向集成到你的自定义逻辑服务器或构建流程。
3. PlayFabSDK - 在单一 SDK 中包含所有 API(客户端、服务器和管理),外加一个单元测试项目。

## 何时不应使用此 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 关键字特性。有关异步编程的详细信息,请参见[使用 async 和 await 的异步编程 (C#)](https://learn.microsoft.com/en-us/dotnet/csharp/async)。

## 将 SDK 添加到你的项目

* [添加 C# 客户端 SDK 快速入门](/services/playfab/sdks/c-sharp/quickstart)

或者,你可以使用 NuGet 包管理器将 NuGet 包安装到 Visual Studio 项目中。相关说明请参见[在 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)