次の方法で共有


Xbox サービス API の概要

Xbox サービスから情報を取得するには、2 つの方法があります。

  1. Xbox Live Services 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 Live REST エンドポイントを直接使用する方法には、以下の利点があります:

  • Web サービスの Xbox サービス エンドポイントを呼び出す機能
  • XSAPI に含まれていないエンドポイントを呼び出すことができます。 XSAPI には、ゲームで使用すると思われる API のみが含まれています。API が不足している場合は、フォーラムからお知らせください。
  • REST エンドポイント経由で利用できる一部の機能には、対応する XSAPI ラッパーが存在しない場合があります。

ゲームおよびアプリで、以上のどちらかの方法しか使用できないということはありません。 XSAPI ラッパーを使用しつつ、必要な場合は REST エンドポイントを直接呼び出すことができます。 詳細については、「Xbox services REST API のリファレンス」を参照してください。

クライアント側 API セット

Xbox Live Services API (XSAPI) は、広範なユーザー シナリオをサポートするクライアント側 API を公開します。

重要: GDK 開発では、XSAPI C ベースの API のみを使用する必要があります。 XSAPI WinRT および C+11 API は、お客様の情報のみを目的としてここに含まれています。

  • XSAPI C ベース API (GDK) 2018年 6 月時点で新規
  • XSAPI WinRT API (XDK および Xbox Creators プログラムのみ)
  • XSAPI C++11 ベースの API (XDK および Xbox Creators プログラムのみ)

XSAPI C ベース API

  • PC および Xbox 本体の GDK タイトルをサポートします。
  • タイトルが XSAPI の呼び出し時にメモリの割り当てを制御できるようになります。
  • タイトルが XSAPI の呼び出し時にスレッド処理を完全に制御できるようになります。
  • ゲーム開発者向けに設計された新しい HTTP ライブラリ、libHttpClient を使用します。

詳細については「Xbox Live C API の概要」を参照してください。

API リファレンスについては、「XSAPI C リファレンス」を参照してください。

関連項目

XSAPI C API の概要

XSAPI リファレンス

REST API リファレンス

libHttpClient