> ## 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 SDK 產品

> 比較 PlayFab v1 獨立 SDK 與 v2 Unified SDK 產品線，並為新的或現有的遊戲專案選擇合適的用戶端程式庫。

**PlayFab Unified SDK (v2)** 是新一代的 PlayFab SDK。它將所有 PlayFab 用戶端程式庫整合成單一、一致的產品。它提供新式、簡化的開發體驗，具備統一的驗證、自動權杖管理，以及所有元件之間一致的 API。Unified SDK 是持續開發的主要重點，所有新功能、平台支援和改進都會優先以 v2 為目標。

**對於新專案**，如果目前支援的平台符合您的需求，建議您使用 **PlayFab Unified SDK (v2)**。使用 v1 獨立 SDK 的**現有專案**可以[移轉至 v2](/zh-TW/services/playfab/sdks/unified-sdk/migrating-from-v1)，以利用統一的架構。

**v1 獨立 SDK** 目前仍受支援，並為需要 v2 尚未支援之平台的專案提供更廣泛的平台涵蓋範圍。

<Info>
  v1 和 v2 SDK 不能在同一個專案中一起使用。如果您需要 v2 尚未支援的平台，請對所有元件使用 v1。
</Info>

## PlayFab Unified SDK (v2)

[PlayFab Unified SDK](/zh-TW/services/playfab/sdks/unified-sdk/overview) 以涵蓋所有 PlayFab 功能的單一、一致產品，取代個別 v1 SDK 套件的集合。您不需要個別下載、安裝和更新多個 SDK，只需使用一個包含您所需一切的 SDK。

### 包含的內容

Unified SDK 會將下列元件組合成單一安裝：

| 元件 | 描述 |
| - | - |
| **PlayFab Core** | 驗證、實體管理、遙測和記錄 |
| **PlayFab Services** | LiveOps、經濟、進度和資料分析 |
| **PlayFab GameSave** | 雲端存檔儲存和同步 |
| **PlayFab Multiplayer** | 大廳建立、配對和工作階段管理 |
| **PlayFab Party** | 即時網路、語音聊天和文字通訊，並整合 Azure AI 服務 |

### 主要優點

* **單一 SDK**：所有 PlayFab 功能只需一個安裝和更新程序，不需要再為 Services、Party 和 Multiplayer 管理個別套件
* **統一驗證**：只需驗證一次，即可取得適用於所有元件的單一 `PFEntityHandle`。不需要再於服務之間手動擷取和傳遞實體權杖
* **自動權杖管理**：背景權杖重新整理會自動處理實體權杖更新，避免在長時間遊戲過程中工作階段到期，而不需要任何因應措施程式碼
* **一致的程式設計模型**：所有元件都遵循標準化的初始化、API 呼叫、錯誤處理和非同步作業模式，只需學習一種模式，即可到處使用
* **自訂記憶體管理**：透過 `PFMemoryHooks` 插入您自己的記憶體配置器，以在資源受限或高效能的環境中進行精細控制
* **進階執行緒控制**：`XTaskQueue` 整合提供彈性的分派模式 (Manual、ThreadPool、SerializedThreadPool、Immediate)，讓您可以精確控制非同步工作的執行方式和位置
* **內建偵錯追蹤**：可延伸的追蹤系統，可從單一偵錯輸出監視所有元件的 API 要求、回應和錯誤
* **面向未來**：所有新的 PlayFab 功能、平台擴充和效能改進都只以 v2 為目標

<Tip>
  已經在使用 v1？如需逐步指南，請參閱[從 v1 移轉至 v2](/zh-TW/services/playfab/sdks/unified-sdk/migrating-from-v1)。移轉通常可以移除手動權杖管理，並統一各元件的初始化邏輯，從而簡化您的程式碼基底。
</Tip>

### 開發人員體驗比較

下列範例說明與 v1 相比，v2 如何簡化常見工作：

| 工作 | v1 (獨立 SDK) | v2 (Unified SDK) |
| - | - | - |
| **設定** | 分別下載和設定每個 SDK | 安裝一個包含所有元件的 SDK |
| **驗證** | 手動擷取實體權杖、在服務之間傳遞，並在到期前重新整理 | 呼叫一次登入、取得 `PFEntityHandle`，然後將其傳遞給任何元件 |
| **權杖重新整理** | 撰寫自訂重新整理邏輯以避免工作階段到期 | 在背景自動處理 |
| **錯誤處理** | 每個 SDK 的錯誤模式不同 | 所有元件的錯誤回報一致 |

## PlayFab 獨立 SDK (v1)

[v1 獨立 SDK](/zh-TW/services/playfab/sdks/sdk-overview) 由適用於不同 PlayFab 功能的個別 SDK 套件組成。雖然它們仍受到完整支援，但需要管理多個 SDK 安裝，並在元件之間進行手動協調。v1 SDK 會繼續收到重大修正，但新功能和平台支援只會針對 v2 開發。

### SDK 元件 (v1)

* [**PlayFab Services SDK**](/zh-TW/services/playfab/sdks/playfab-sdk-intro)：LiveOps、經濟、配對和資料分析
* [**PlayFab Party SDK**](/zh-TW/services/playfab/multiplayer/networking/party-sdks/overview)：網路和語音/文字聊天通訊
* [**PlayFab Lobby and Matchmaking SDK**](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)：大廳和配對功能

## 支援的平台

下表比較 v2 Unified SDK 與 v1 獨立 SDK 之間的平台支援：

| 平台 | v2 (Unified SDK) | v1 (獨立 SDK) |
| - | :-: | :-: |
| Windows (PC 和掌上型裝置) | ✅ 支援 | ✅ 支援 |
| XBOX (One、Series S/X、Cloud) | ✅ 支援 | ✅ 支援 |
| Steam Deck | ✅ 支援 | ❌ 目前不支援 |
| PlayStation 4 ¹ | ✅ 支援 | ✅ 支援 |
| PlayStation 5 ¹ | ✅ 支援 | ✅ 支援 |
| Nintendo Switch ¹ | ✅ 支援 | ✅ 支援 |
| Nintendo Switch 2 ¹ | ✅ 支援 | ✅ 支援 |
| Linux | ❌ 目前不支援 | ✅ 支援 |
| iOS | ❌ 目前不支援 | ✅ 支援 |
| Android | ❌ 目前不支援 | ✅ 支援 |
| macOS | ❌ 目前不支援 | ✅ 支援 |

<Note>
  存取 PlayStation® 和 Nintendo 平台 SDK 需要與各平台持有者簽署 NDA。如需詳細資料，請參閱[要求 SDK 和範例的存取權](/zh-TW/services/playfab/sdks/request-access-for-sdks-samples)。
</Note>

## 另請參閱

* [PlayFab Unified SDK (v2)](/zh-TW/services/playfab/sdks/unified-sdk/overview)
* [獨立 SDK 概觀 (v1)](/zh-TW/services/playfab/sdks/sdk-overview)
* [要求 SDK 和範例的存取權](/zh-TW/services/playfab/sdks/request-access-for-sdks-samples)


## Related topics

- [PlayFab Unified SDK](/zh-TW/services/playfab/sdks/unified-sdk/overview.md)
- [PlayFab Services SDK 2024 版本資訊](/zh-TW/services/playfab/release-notes/2024.md)
- [PlayFab Services SDK 2025 版本資訊](/zh-TW/services/playfab/release-notes/2025.md)
- [PlayFab Services SDK 2023 版本資訊](/zh-TW/services/playfab/release-notes/2023.md)
- [PlayFab Services SDK 2026 版本資訊](/zh-TW/services/playfab/release-notes/index.md)