XblEventsWriteInGameEvent

"サイズ" と "測定値" データ フィールドを含むゲーム内イベントを書き込みます。

構文

HRESULT XblEventsWriteInGameEvent(  
         XblContextHandle xboxLiveContext,  
         const char* eventName,  
         const char* dimensionsJson,  
         const char* measurementsJson  
)  

パラメーター

xboxLiveContext _In_
型: XblContextHandle

Xbox Live コンテキスト ハンドル。

eventName _In_z_
型: char*

イベント名。 英数字のみを使用する必要があります。

dimensionsJson _In_opt_z_
型: char*

ディメンションのデータ フィールド

measurementsJson _In_opt_z_
型: char*

測定値のデータ フィールド

戻り値

型: HRESULT

この API 操作の HRESULT 結果コード。

解説

サイズには、限られた数の定義済みの数値または文字列値を持つイベント フィールドが含まれます。 サイズの例としては、マップ ID、難易度レベル、キャラクターや武器のクラス、ゲーム モード、ブール値設定などがあります。測定値には、スカラーの数値メトリックを表すイベント フィールドが含まれます。 測定値の例としては、スコア、時刻、カウンター、位置などがあります。例: 特定の難易度レベルについて最も高い一致スコアを追跡するゲーム内イベントの場合: 難易度レベルが "サイズ" に含まれている必要があり、スコアが "測定値" に含まれている必要があります。 イベントの名前とイベント フィールド (サイズと測定値の両方) の名前は、タイトルのサービス コンフィグで宣言されている名前と一致する必要があります。 名前の大文字と小文字は区別されません。 API が、サービス コンフィグの名前と一致しない名前を持つイベントを書き込んだ場合、サービスは通知なしでイベントを破棄します。 GDK の PC バージョンを使用する場合、XGameEvent 機能を備えた GRTS ランタイムをインストールする必要があります。PC バージョンを使用しない場合は E_NOTIMPL になります。

要件

ヘッダー: events_c.h

ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

events_c