次の方法で共有

イベントの概要

  • [アーティクル]

注意: この記事は、タイトルで管理されるユーザー統計ではなく、イベントに基づくユーザー統計を使用している場合にのみ適用されます。

注意 Application Insights は非推奨になりました。 イベントを監視するには、fiddler を使ってください。

Xbox サービスユーザー統計サービスへのゲーム イベントの書き込み

ゲームで最高にエキサイティングな瞬間は、何か重要なこと (敵を倒す、倒される、場所を移動する、武器を撃つ、花を摘むなど) が起きたときです。 Xbox サービスを利用することで、タイトルはプレイヤーのゲーム中の重要なイベントに関する情報を共有することができます。 詳細情報は、ユーザーに関する統計を記録するXbox サービスに送信することができます。 これらの統計情報を取得して、ユーザー統計、ランキング、マッチメイキングで使用できます。

イベントとイベントの一部として送信されたデータがサービスに到達すると、Xbox サービスは、サービス構成でタイトル用に定義したルールを処理して、ユーザー統計、リーダーボードなどを作成または更新します。

パートナー センターでの構成

最初に、パートナー センターの [Player Stats] (プレイヤー統計) | [Stat rules] (統計ルール) ページでイベントを定義します。 パートナー センターでイベントと統計を定義したら、以下の手順を実行してイベントを送信できます。

イベントの作成

Microsoft Game Development Kit (GDK) タイトルの場合は、イベントを送信する API は Xbox One ソフトウェア開発キット タイトルのものと異なり、マニフェスト ファイルを使用する必要はありません。

XblEventsWriteInGameEvent 関数は、次のように宣言されます。

STDAPI XblEventsWriteInGameEvent(
    _In_ XblContextHandle xboxLiveContext,
    _In_z_ const char* eventName,
    _In_opt_z_ const char* dimensionsJson,
    _In_opt_z_ const char* measurementsJson
) XBL_NOEXCEPT;

xboxLiveContext は Xbox サービス コンテキスト ハンドルです。

eventName は、パートナー センターで定義されているイベント名です。

dimensions は、確定した値セットを持つイベント プロパティに対応するプロパティ バッグです。 例: レベル、武器、キャラクター。

measurements は、不確定の値セットを持つイベント プロパティに対応するプロパティ バッグです。 例: 運転した距離、倒した敵の数、プレイした時間。

ディメンションと測定については後で詳しく説明します。

測定とディメンション

Xbox サービスのイベントを目的として XblEventsWriteInGameEvent を呼び出す場合、イベントのプロパティをディメンションや測定値として渡しても違いはありません。 ディメンションと測定の違いは、テレメトリのために Application Insights でイベントを分析する場合にのみ関係があります。ゲームプレイのエクスペリエンスには影響ありません。 詳細については、「カスタムのイベントとメトリックのための Application Insights API」を参照してください。

ディメンションは、イベントでのフィルターまたはピボットに使用できます。 例: レベル 6 を完了したユーザーを表示するか、武器「Minigun」が使用された「敵キル」 イベントをすべて表示します。

測定は、グラフィカルに表示できたり、ランキングで使用するのに適している場合があります。 たとえば、軌道時間や、連続勝利ラウンド数などです。

ただし、Xbox サービスで使用する場合は、イベント プロパティを測定で渡してもディメンションで渡しても違いはありません。どちらも、実績のロック解除および Xbox サービス関連の他の機能のために、同じように処理されます。

Xbox サービス イベントのデバッグ

タイトルからのイベントが Xbox サービスに正常に届かない場合、ヒーロー スタッツやランキングは更新されません。 Xbox サービスがイベントが正常に受信していない疑いがある場合は、以下の手順をお試しください。

  • サンドボックスが正しいことを確認します。

  • デバイスで Fiddler をセットアップします。 Fiddler では、次のようなイベントが表示されるはずです。

Fiddler でアンデコードされたイベント

v10.vortex-win.data.microsoft.com の呼び出しを探します。 示されているように要求本文をデコードする必要があります。その後、JSON を見ると、次のような内容が含まれます。

Fiddler でデコードされたイベント

イベント名が想定したものであることを確認できます。 タイトル ID が名前の前に追加されています。 リターン コードが 200 であることも確認する必要があります。

関連項目

イベントに基づく統計とタイトルで管理される統計。