- 使用稱為 XBOX 服務 API 或 XSAPI 的用戶端 API。它也稱為 XBOX Live API。
- 直接呼叫 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 包裝函式。
用戶端 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。
