跳轉到主要內容
本教學課程說明如何使用 PlayFab SDK 存取、辨識和處理 API 錯誤。 此處所述的做法同樣適用於管理、伺服器和用戶端 SDK,但模式高度取決於您選擇的語言。 簡單來說,您選擇的模式對任何 SDK (管理/伺服器/用戶端) 都有效,但實作細節將取決於您的程式設計語言和環境。

攔截和存取錯誤

PlayFab SDK 通常會透過傳回錯誤物件來回報錯誤。下列程式碼片段展示如何偵測和存取錯誤。
一般而言,如果錯誤物件已定義 (不是 null),就表示發生了錯誤。接著我們可以進一步檢查錯誤。

檢查錯誤

檢查錯誤最常見的方式,是透過程式碼辨識錯誤。如全域 API 方法錯誤碼中所述,每個產生的錯誤都包含人類可讀的錯誤碼和數字錯誤碼。
錯誤碼本身就足以辨識錯誤並據此處理。
讓我們以 LoginWithEmailAddress API 方法為例。如此方法的文件中所述,執行時可能會擲回下列內部錯誤:
  • InvalidTitleId 1004
  • AccountNotFound 1001
  • InvalidEmailOrPassword 1142
  • RequestViewConstraintParamsNotAllowed 1303
下列方法說明如何檢查和辨識此類錯誤。

處理錯誤

識別錯誤後,處理/復原策略取決於錯誤類型和性質。像無效引數這類錯誤,即使重試也永遠不會成功。必須修正要求,該 API 呼叫才會成功。 有一部分錯誤可以套用重試策略。可重試的錯誤類型在全域 API 方法錯誤碼中有說明。 套用重試策略時,請務必符合下列需求:
  • 每次重試時,重試之間的延遲應以指數方式增加。這可以增加呼叫成功的機會,並防止您的遊戲對 PlayFab 伺服器發出大量垃圾要求 (這將導致更多呼叫被拒絕)。
  • 您應有選擇性地套用此重試策略,只對值得重試的錯誤碼使用。
如需可安全重試的錯誤碼清單,請參閱我們的全域 API 方法錯誤碼教學課程。
最後修改於 2026年10月8日