跳轉到主要內容
從 XBOX 服務取得資訊有兩種方式。
  1. 使用稱為 XBOX 服務 API 或 XSAPI 的用戶端 API。它也稱為 XBOX Live API。
  2. 直接呼叫 XBOX 服務 REST 端點。它們也稱為 XBOX Live REST 端點。

使用 XSAPI 的優點

使用 XBOX 服務 API (XSAPI) 的優點包括:
  • 驗證、編碼以及 HTTP 傳送和接收的詳細資料都會為您處理。
  • 包裝函式 API 的引數和傳回的資料會以原生資料類型處理。您不需要執行 JSON 編碼和解碼。
  • 直接呼叫 Web 服務涉及多個非同步步驟,而包裝函式 API 會將這些步驟封裝起來。這讓遊戲程式碼更容易閱讀和撰寫。
  • 某些功能 (例如寫入遊戲事件) 只能在 XSAPI 中使用。

使用 XBOX 服務 REST 端點的優點

直接使用 XBOX 服務 REST 端點的優點包括:
  • 能夠從 Web 服務呼叫 XBOX 服務端點。
  • 能夠呼叫 XSAPI 中未包含的端點。它只包含我們認為遊戲會使用的 API。如果有任何遺漏,請透過論壇與我們連絡。
  • 透過 REST 端點提供的某些功能可能沒有對應的 XSAPI 包裝函式。
您的遊戲和應用程式不限於只使用其中一種方法。您可以使用 XSAPI 包裝函式,並在需要時仍直接呼叫 REST 端點。如需詳細資訊,請參閱 XBOX 服務 REST API 參考。

用戶端 API 集

XSAPI 公開支援各種客戶案例的用戶端 API。 重要:對於 GDK 開發,請只使用以 XSAPI C 為基礎的 API。此處包含的 XSAPI WinRT 和 C++11 API 僅供參考。
  • 以 XSAPI C 為基礎的 API (GDK);自 2018 年 6 月起推出
  • XSAPI WinRT API (僅限 XDK 和 XBOX Creators Program)
  • 以 XSAPI C++11 為基礎的 API (僅限 XDK 和 XBOX Creators Program)

以 XSAPI C 為基礎的 API

  • 支援 PC 和 XBOX 主機 GDK 遊戲。
  • 允許遊戲在呼叫 XSAPI 時控制記憶體配置。
  • 允許遊戲在呼叫 XSAPI 時完全控制執行緒處理。
  • 使用專為遊戲開發人員設計的新 HTTP 程式庫 libHttpClient。
若要深入了解,請參閱 XBOX Live C API 簡介。 如需 API 參考,請參閱 XSAPI C 參考。

另請參閱

XSAPI C API 簡介 XSAPI 參考 REST API 參考 libHttpClient
最後修改於 2026年10月8日