XBOX 服务 API 概述

有两种方法可以从 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 开发，仅使用基于 C 的 XSAPI。XSAPI WinRT 和 C++11 API 仅供你参考。

• 基于 C 的 XSAPI (GDK)；2018 年 6 月新增
• XSAPI WinRT API（仅限 XDK 和 XBOX Creators 计划）
• 基于 C++11 的 XSAPI（仅限 XDK 和 XBOX Creators 计划）

​

基于 C 的 XSAPI

• 支持 PC 和 XBOX 控制台 GDK 标题。
• 允许标题在调用 XSAPI 时控制内存分配。
• 允许标题在调用 XSAPI 时完全控制线程处理。
• 使用为游戏开发人员设计的新的 HTTP 库 libHttpClient。

要了解更多信息，请参阅 XBOX Live C API 简介。 有关 API 参考，请参阅 XSAPI C 参考。

​

另请参阅

XSAPI C API 简介 XSAPI 参考 REST API 参考 libHttpClient