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

# 寫入事件以驅動事件型統計資料

> 引發 XBOX 服務 事件的 XblEventsWriteInGameEvent 範例程式碼，讓已設定的統計資料規則在服務上更新事件型使用者統計資料。

本主題提供示範如何寫入事件的範例程式碼。
在服務上，此範例程式碼會依據您在 Partner Center 中定義的統計資料規則，更新事件型統計資料。

下列範例使用平面 C API。`LogToScreen` 代表您應用程式的記錄函式。

```cpp theme={null}
HRESULT hr = XblEventsWriteInGameEvent(
    xboxLiveContext,
    "PuzzleSolved",
    R"({"DifficultyLevelId":100, "GameplayModeId":"Adventure"})",
    R"({"LocationX":1,"LocationY":1})"
);
if (FAILED(hr))
{
    // Log the failure. Don't retry the call in a loop.
    LogToScreen("XblEventsWriteInGameEvent failed: 0x%08X", static_cast<unsigned int>(hr));
}
```

如需詳細資訊，請參閱
[XblEventsWriteInGameEvent](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent.md)。

## 疑難排解

* **呼叫傳回 `E_INVALIDARG`。** *xboxLiveContext* 或事件名稱為 null。
* **呼叫傳回 `E_XBL_NOT_INITIALIZED`。** 請在寫入事件之前呼叫 [XblInitialize](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md)。
* **呼叫傳回 `E_NOTIMPL`。** Gaming Runtime 的 XGameEvent 功能無法使用。在 Windows PC 上，已安裝的 Gaming Runtime Services 必須包含 XGameEvent 功能。
* **呼叫成功，但統計資料沒有變更。** 事件名稱和事件欄位的名稱必須與您遊戲之服務設定中的名稱相符。名稱不區分大小寫。如果事件名稱與服務設定中的事件不相符，服務會捨棄該事件，而不會通知您的遊戲。
* **欄位值放錯位置。** 請將具有有限數值或字串值集合的欄位 (例如難度等級或遊戲模式) 放在維度中。請將純量數值計量 (例如分數、時間或位置) 放在測量中。
* **更新需要時間。** 事件會在裝置上本機寫入 (即使裝置離線也一樣)，並在裝置連線時上傳。如果裝置已連線，事件型統計資料通常會在寫入事件後 5 到 20 秒內更新。


## Related topics

- [事件型統計資料與排行榜範例程式碼 (內容)](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-statslb-eb-howto-nav.md)
- [寫入事件以驅動事件型成就](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/achievements/event-based/how-to/live-writing-event-based-achievement.md)
- [事件型統計資料初探](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-first-glance.md)
- [事件型統計資料與排行榜事件](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/events/index.md)
- [事件型統計資料與遊戲管理型統計資料](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm.md)