> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblEventsWriteInGameEvent

> XblEventsWriteInGameEvent

# XblEventsWriteInGameEvent

寫入包含「維度」和「測量」資料欄位的遊戲內事件。

## 語法

```cpp theme={null}
HRESULT XblEventsWriteInGameEvent(  
         XblContextHandle xboxLiveContext,  
         const char* eventName,  
         const char* dimensionsJson,  
         const char* measurementsJson  
)  
```

### 參數

*xboxLiveContext*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/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。

<Note>測量只能有數值，而維度可以有更多種類型。如有需要，可以專門使用 *dimensionsJson* 欄位來寫入事件。</Note>

## 需求

**標頭：** events\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[events\_c](/zh-TW/reference/live/xsapi-c/events_c/events_c_members)


## Related topics

- [傳送事件](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/how-to/live-sending-an-event.md)
- [寫入事件以驅動事件型統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-sending-eb-stat.md)
- [寫入事件以驅動事件型成就](/zh-TW/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [事件型統計資料初探](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [排行榜](/zh-TW/build/steam-porting-guide/features/steam-leaderboards.md)