可通过两种方法从 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 中未包含的终结点。 它仅包括我们认为游戏将使用的 API。 如果缺少任何内容,请通过论坛与我们联系。
- 通过 REST 终结点提供的某些功能可能没有相应的 XSAPI 包装器。
你的游戏和应用不仅限于使用其中一种方法。 你可以使用 XSAPI 包装器,并且仍可根据需要直接调用 REST 终结点。 有关详细信息,请参阅 Xbox 服务 REST API 参考。
客户端 API 集
XSAPI 公开支持各种客户方案的客户端 API。
重要提示:对于 GDK 开发,请仅使用基于 XSAPI C 的 API。 此处包含 XSAPI WinRT 和 C++11 API,仅供你了解。
- 基于 XSAPI C 的 API (GDK) ;new 截至 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 参考。