跳轉到主要內容
本主題說明使用 Data Platform 2013,在遊戲的 Partner Center 服務設定中新增及變更 XBOX Events 的程序。如果遊戲使用 Data Platform 2013,事件就是遊戲傳送至 XBOX 服務的關鍵資料,用來更新統計資料和排行榜,以及解除鎖定成就。 如需 XBOX 服務設定的簡介,請參閱服務設定。如需 Data Platform 2013 的簡介,請參閱 XDK 主題 How the XBOX Live data platform 2013 works。

什麼是事件?

事件是遊戲過程中發生且可被_擷取_的任何事物。玩家取得武器是一個事件,使用該武器擊敗敵人也是一個事件。 事件由事件名稱、事件描述,以及包含事件相關資料的多個欄位組成。當遊戲寫入事件時,事件會儲存在本機裝置上,直到能夠傳送至 XBOX 服務為止。XBOX 服務會接收事件,並根據您在服務設定中定義的規則,使用它來建置及更新統計資料、排行榜、成就,以及 Data Platform 2013 的其他功能。如需詳細資料,請參閱 XDK 主題 Game events。

設定事件

1

使用您的帳戶登入 [Partner Center](https://developer.microsoft.com...

使用您的帳戶登入 Partner Center。
2

選取您的遊戲,然後移至 Services > XBOX Live。

選取您的遊戲,然後移至 Services > XBOX Live。
3

選取 Stat rules 的連結。

選取 Stat rules 的連結。
4

在 Events and stat rules 頁面上,設定事件以及根據事件的統計資料規則...

在 Events and stat rules 頁面上,設定事件以及根據事件的統計資料規則。

建立事件

  1. 在 Events and stat rules 頁面上,選取 New event。
  2. 在對話方塊中,指定下列欄位的值。
    • Base event
      從下拉式清單中,選取您要用來建置新事件的基底事件。所選的基底事件會控制預先填入新事件的預設欄位。您可以新增任何其他欄位,但無法移除預設欄位。
    • Event name
      • 提供能描述事件特性、且您能輕鬆記住和辨識的名稱。
      • 事件名稱不必與為新事件選取的基底事件名稱相符。
      • 事件名稱不會向玩家顯示,僅供程式碼和遊戲工作室內部使用。
      • 事件名稱在提供者命名空間內必須是唯一的:單一提供者不能有兩個衝突的事件名稱。
    • Description
      提供事件的簡短描述。此文字為選用,且不會向玩家顯示。
    • Event fields
      • 此清單中的欄位代表與新事件相關所擷取的資料。
      • 若要新增事件欄位,請選取 Add Event Field,然後指定 Field 名稱和 DataType。
      • 不同類型的欄位有字元數限制。
        • 成就名稱:44
        • 鎖定描述:100
        • 解除鎖定描述:100
        • 成就規則名稱:44
        • 應用程式內獎勵名稱:57
        • 應用程式內獎勵描述:90
        • 美術作品獎勵名稱:57
        • 美術作品獎勵描述:90
        • Rich Presence:44
        • 主打統計資料名稱:44
  3. 選取 Save 以建立事件並關閉對話方塊。新增事件對話方塊
您的新事件現在會列在 Events and stat rules 頁面上。

變更事件

  • 遊戲通過最終認證之後,除了新增事件欄位之外,就無法再變更該遊戲中現有的事件。
  • 您可以刪除自訂事件欄位,但無法刪除建立事件時自動提供的預設事件欄位。
  1. 在 Events and stat rules 頁面的 Events 下,選取您要變更之事件的名稱。
  2. 在 Update event 對話方塊中進行變更。
  3. 選取 Save。

複製事件

您可以複製現有事件並修改其資訊,以建立新事件。
  1. 在 Events and stat rules 頁面的 Events 下,針對您要複製的事件選取 Copy。
  2. 為新事件提供 Event name。
  3. 更新描述,然後視需要新增或移除事件欄位。
  4. 選取 Save 以建立事件並關閉對話方塊。

刪除事件

  • 遊戲通過最終認證之後,就無法再刪除該遊戲中現有的事件。
  • 刪除事件會一併刪除其可能具有的任何鏈結相依性。刪除事件之前,請確定您也要刪除其所有相依性。
  • 您可以在遊戲開發期間刪除事件,但在遊戲通過最終認證之後 (也就是在您推出產品之後) 就無法刪除。
  1. 在 Events and stat rules 頁面的 Events 下,針對您要刪除的事件選取 Delete。
  2. 在 Confirmation 對話方塊中,選取 Delete 或 Cancel。
刪除相依性事件

下載事件資訊清單檔案

完成定義及變更遊戲的事件之後,您必須將它們發佈至 XBOX Live,並下載事件資訊清單檔案,這是開發遊戲所需的檔案。 如需下載事件資訊清單檔案的相關資訊,請參閱下載事件資訊清單檔案。
最後修改於 2026年10月6日