> ## 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# 圖片" 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](/zh-TW/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](/zh-TW/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 的快速入門](/zh-TW/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

- [PlayFab SDK](/zh-TW/services/playfab/sdks/playfab-sdk-intro.md)
- [舊版 C++ PlayFab SDK](/zh-TW/services/playfab/sdks/playfab-cpp/index.md)
- [PlayFab Unified SDK](/zh-TW/services/playfab/sdks/unified-sdk/overview.md)
- [PlayFab Party SDK](/zh-TW/services/playfab/multiplayer/networking/party-sdks/overview.md)
- [PlayFab SDK 產品](/zh-TW/services/playfab/sdks/sdk-products.md)