Xbox サービス API の概要
Xbox サービスから情報を取得するには、2 つの方法があります。
- Xbox Live Services API (XSAPI) と呼ばれるクライアント側 API を使用します。 これは、Xbox Live API とも呼ばれます。
- 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 リファレンス」を参照してください。