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

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));
}

​

疑難排解

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