XblEventsWriteInGameEvent
“dimensions” (ディメンション) データ フィールドと “measurement” (測定) データ フィールドを含むゲーム内イベントを書き込みます。構文
パラメーター
xboxLiveContext _In_型: XblContextHandle XBOX Live コンテキスト ハンドル。 eventName _In_z_
型: char* イベント名。英数字のみを含む必要があります。 dimensionsJson _In_opt_z_
型: char* ディメンション データ フィールド。 measurementsJson _In_opt_z_
型: char* 測定データ フィールド。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
ディメンションには、有限個の定義済み数値または文字列の値を持つイベント フィールドが含まれます。ディメンションの例: マップ ID、難易度、キャラクターや武器のクラス、ゲーム モード、ブール値の設定など。測定には、スカラー数値メトリックを表すイベント フィールドが含まれます。測定の例: スコア、時間、カウンター、位置など。例: 特定の難易度における試合の最高スコアを追跡するゲーム内イベントの場合、難易度は dimensions に含め、スコアは measurements に含める必要があります。イベント名、およびイベント フィールドの名前 (dimensions と measurements の両方) は、タイトルのサービス構成で宣言された名前と一致する必要があります。名前は大文字と小文字を区別しません。API がサービス構成にない名前のイベントを書き込もうとすると、サービスは通知なしにそのイベントを破棄します。GDK PC バージョンを使用している場合、XGameEvent 機能を持つ GRTS ランタイムがインストールされていないと、これは E_NOTIMPL になります。Measurements には数値のみを設定できますが、Dimensions にはより多様な種類の値を設定できます。必要に応じて、イベントの書き込みに dimensionsJson フィールドのみを排他的に使用することもできます。