跳轉到主要內容
本指南說明如何將 PlayFab Unified SDK 整合至您的 Windows 專案、初始化 SDK,以及驗證玩家。這是進行 PlayFab API 呼叫的基礎。

必要條件

開始之前,請完成快速入門設定中的設定步驟,以設定您的開發環境和專案。

您將完成的工作

完成本快速入門之後,您將會:
  • 在您的 Windows 專案中設定 PlayFab Unified SDK
  • 使用您的遊戲識別碼初始化 SDK
  • 使用 XBOX 或 Steam 驗證玩家
  • 取得用於進行 API 呼叫的實體控制代碼
  • 正確地清除資源

本快速入門內容

  1. 初始化 SDK
  2. 驗證玩家
  3. 清除資源

步驟 1:初始化 SDK

包含必要的標頭

首先,在您的專案中包含必要的 PlayFab 和 XBOX Game Runtime 標頭:

初始化 XBOX Gaming Runtime Services

PlayFab Unified SDK 需要 XBOX Game Runtime。請先將其初始化:

初始化 PlayFab Core

初始化 PlayFab SDK 並建立服務設定控制代碼。將 ABCDEF 取代為您實際的 PlayFab 遊戲識別碼:
您可以在 Game Manager 儀表板中遊戲的設定下找到您的遊戲識別碼。

步驟 2:驗證玩家

PlayFab 要求在進行 API 呼叫之前先驗證玩家。SDK 會根據您的平台和需求提供數種驗證方法。

選擇您的驗證方法

選項 A:使用 XBOX 登入 (建議用於 Windows/XBOX)

使用 PFAuthenticationLoginWithXUserAsync 以 XBOX 使用者帳戶登入。這是 Windows 和 XBOX 應用程式的建議方法。

選項 B:使用 Steam 登入

對於整合 Steam 的遊戲,請使用 PFAuthenticationLoginWithSteamAsync 搭配 Steam 驗證票證。
登入時傳回的 PFEntityHandle 是所有後續 PlayFab API 呼叫的必要項目。請在應用程式的整個存留期間保持此控制代碼可用。

步驟 3:清除資源

當您的應用程式關閉時,請正確地清除所有資源,以防止記憶體流失並確保正常終止:
一律以初始化的相反順序清除資源,以確保正確關閉。

後續步驟

現在您已初始化 SDK 並驗證了玩家,可以開始呼叫 PlayFab 服務:

進行您的第一次 API 呼叫

核心概念

進階驗證

  • 多平台驗證 - 支援多個驗證提供者
  • 自訂識別碼驗證 - 使用您自己的驗證系統
  • 帳戶連結 - 將多種驗證方法連結至一個帳戶

疑難排解

常見問題和解決方案:

參考文件

最後修改於 2026年10月8日