XblEventsWriteInGameEvent
寫入包含「維度」和「測量」資料欄位的遊戲內事件。語法
參數
xboxLiveContext _In_類型：XblContextHandle XBOX Live 內容控制代碼。 eventName _In_z_
類型：char* 事件名稱。只能包含英數字元。 dimensionsJson _In_opt_z_
類型：char* 維度資料欄位。 measurementsJson _In_opt_z_
類型：char* 測量資料欄位。
傳回值
類型：HRESULT 此 API 作業的 HRESULT 傳回碼。備註
維度包含具有有限數量已定義數值或字串值的事件欄位。維度範例：地圖識別碼、難度等級、角色或武器類別、遊戲模式、布林值設定等。測量包含代表純量數值計量的事件欄位。測量範例：分數、時間、計數器、位置等。範例：對於追蹤特定難度等級最高比賽分數的遊戲內事件：難度等級應包含在維度中，而分數應包含在測量中。事件的名稱和事件欄位的名稱 (維度和測量皆然) 必須符合遊戲服務設定中所宣告的名稱。名稱不區分大小寫。如果 API 寫入的事件名稱與服務設定中的名稱不符，服務會捨棄該事件，且不會發出通知。使用 GDK PC 版本時，必須安裝具有 XGameEvent 功能的 GRTS 執行階段，否則會傳回 E_NOTIMPL。測量只能有數值，而維度可以有更多種類型。如有需要，可以專門使用 dimensionsJson 欄位來寫入事件。