Xbox 服务 API 概述
可通过两种方法从 Xbox 服务获取信息。
- 使用客户端 API，即 Xbox 服务 API，即 XSAPI。 它也被称为 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 中的终结点。 XSAPI 仅包括我们认为游戏将会使用的 API，因此，如果缺少任何内容，请通过论坛告知我们。
- 某些通过 REST 终结点提供的功能可能没有相应的 XSAPI 包装器。
你的游戏和应用并不仅限于使用这些方法之一。 你可以使用 XSAPI 包装器，并且仍可根据需要直接调用 REST 终结点。 有关详细信息，请参阅 Xbox 服务 REST API 参考。
客户端 API 集
Xbox Live 服务 API (XSAPI) 公开支持各种客户方案的客户端 API。
重要提示：对于 GDK 开发，应仅使用基于 XSAPI C 的 API。 此处包含的 XSAPI WinRT 和 C+11 API 仅提供信息用。
- 基于 XSAPI C 的 API (GDK)–2018 年 6 月新增
- XSAPI WinRT API（仅限 XDK 和 Xbox 创意者计划）
- 基于 XSAPI C++11 的 API（仅限 XDK 和 Xbox 创意者计划）
基于 XSAPI C 的 API
- 支持电脑和 Xbox 主机 GDK 游戏。
- 允许游戏在调用 XSAPI 时控制内存分配。
- 允许游戏在调用 XSAPI 时完全控制线程处理。
- 使用专为游戏开发者设计的新 HTTP 库 libHttpClient。
若要了解详细信息，请参阅介绍 Xbox Live C API。
有关 API 参考，请参阅 XSAPI C 参考。