將遊戲事件寫入 XBOX 服務使用者統計資料服務
遊戲中最令人興奮的時刻,就是發生重大事件的時候:擊敗對手、被擊敗、移動到某個位置、射擊武器、摘一朵花。透過 XBOX 服務,遊戲可以分享玩家遊戲中重要事件的相關資訊。詳細資料可以傳送至 XBOX 服務,由其記錄使用者的統計資料。這些統計資料可以擷取並用於使用者統計資料、排行榜與配對。 事件以及隨事件傳送的任何資料到達服務後,XBOX 服務就會處理您在遊戲服務設定中定義的規則,以建立或更新使用者統計資料、排行榜等。在 Partner Center 上設定
首先,在 Partner Center 的 Player Stats | Stat rules 頁面上定義您的事件。在 Partner Center 中定義事件與統計資料後,您就可以執行下列步驟來傳送事件。寫入事件
對於 Microsoft Game Development Kit (GDK) 遊戲,傳送事件的 API 與 XBOX One 軟體開發套件遊戲不同,而且不需要使用資訊清單檔案。 XblEventsWriteInGameEvent 函式的宣告如下:xboxLiveContext 是 XBOX 服務內容控制代碼。
eventName 是在 Partner Center 上定義的事件名稱。
dimensions 是屬性包,對應於值為有限集合的事件屬性。例如:關卡、武器或角色。
measurements 是屬性包,對應於值為不確定集合的事件屬性。例如:行駛英里數、擊殺敵人數或遊戲分鐘數。
維度與測量值將在下文進一步討論。
測量值與維度
針對 XBOX 服務事件呼叫 XblEventsWriteInGameEvent 時,將事件屬性作為維度或測量值傳遞並沒有差異。只有在您於 Application Insights 上分析事件以取得遙測時,這些差異才有關係;這對遊戲體驗沒有任何影響。如需詳細資訊,請參閱適用於自訂事件和計量的 Application Insights API。 維度可用來篩選或樞紐分析您的事件。例如:顯示完成第 6 關的使用者,或顯示所使用武器為 “Minigun” 的所有 “Enemies Killed” 事件。 測量值可以用圖形方式顯示,或適合用於排行榜。例如:追蹤時間、連勝回合數等。 但就搭配 XBOX 服務使用而言,將事件屬性作為測量值或維度傳遞並無差別,在解除鎖定成就及其他 XBOX 服務相關功能方面,兩者的處理方式完全相同。偵錯 XBOX 服務事件
如果遊戲的事件無法成功到達 XBOX 服務,主打統計資料與排行榜就不會更新。如果您懷疑 XBOX 服務未成功接收事件,請嘗試下列步驟:- 確認您的沙箱正確無誤。
- 在裝置上設定 Fiddler。在 Fiddler 中,您應該會看到如下的事件:

v10.vortex-win.data.microsoft.com 的呼叫。您需要依圖示解碼要求本文,接著查看 JSON 時,就會看到類似下列的內容:

