> ## 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.

# 在 Partner Center 中設定 XBOX 事件

> 使用 Data Platform 2013 在 Partner Center 中新增及變更 XBOX 事件，以傳送可更新統計資料、排行榜和成就的遊戲資料。

本主題說明使用 Data Platform 2013，在遊戲的 Partner Center 服務設定中新增及變更 XBOX Events 的程序。如果遊戲使用 Data Platform 2013，事件就是遊戲傳送至 XBOX 服務的關鍵資料，用來更新統計資料和排行榜，以及解除鎖定成就。

如需 XBOX 服務設定的簡介，請參閱[服務設定](/zh-TW/services/xbox-services/fundamentals/portal-config/live-service-config-ids-mp)。如需 Data Platform 2013 的簡介，請參閱 XDK 主題 **How the XBOX Live data platform 2013 works**。

<a id="ID4EKB" />

## 什麼是事件？

事件是遊戲過程中發生且可被\_擷取\_的任何事物。玩家取得武器是一個事件，使用該武器擊敗敵人也是一個事件。

事件由事件名稱、事件描述，以及包含事件相關資料的多個欄位組成。當遊戲寫入事件時，事件會儲存在本機裝置上，直到能夠傳送至 XBOX 服務為止。XBOX 服務會接收事件，並根據您在服務設定中定義的規則，使用它來建置及更新統計資料、排行榜、成就，以及 Data Platform 2013 的其他功能。如需詳細資料，請參閱 XDK 主題 **Game events**。

<a id="ID4EYM" />

## 設定事件

<Steps>
  <Step title="使用您的帳戶登入 [Partner Center](https://developer.microsoft.com...">
    使用您的帳戶登入 [Partner Center](https://developer.microsoft.com/dashboard/windows/overview)。
  </Step>

  <Step title="選取您的遊戲，然後移至 **Services** > **XBOX Live**。">
    選取您的遊戲，然後移至 **Services** > **XBOX Live**。
  </Step>

  <Step title="選取 **Stat rules** 的連結。">
    選取 **Stat rules** 的連結。
  </Step>

  <Step title="在 **Events and stat rules** 頁面上，設定事件以及根據事件的統計資料規則...">
    在 **Events and stat rules** 頁面上，設定事件以及根據事件的統計資料規則。
  </Step>
</Steps>

<a id="ID4EUB" />

## 建立事件

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

您的新事件現在會列在 **Events and stat rules** 頁面上。

<a id="ID4EYE" />

## 變更事件

<Warning>
  * 遊戲通過最終認證之後，除了新增事件欄位之外，就無法再變更該遊戲中現有的事件。
  * 您可以刪除自訂事件欄位，但無法刪除建立事件時自動提供的預設事件欄位。
</Warning>

1. 在 **Events and stat rules** 頁面的 **Events** 下，選取您要變更之事件的名稱。
2. 在 **Update event** 對話方塊中進行變更。
3. 選取 **Save**。

<a id="ID4EBG" />

## 複製事件

您可以複製現有事件並修改其資訊，以建立新事件。

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

<a id="ID4EBL" />

## 刪除事件

<Warning>
  * 遊戲通過最終認證之後，就無法再刪除該遊戲中現有的事件。
  * 刪除事件會一併刪除其可能具有的任何鏈結相依性。刪除事件之前，請確定您也要刪除其所有相依性。
  * 您可以在遊戲開發期間刪除事件，但在遊戲通過最終認證之後 (也就是在您推出產品之後) 就無法刪除。
</Warning>

1. 在 **Events and stat rules** 頁面的 **Events** 下，針對您要刪除的事件選取 **Delete**。
2. 在 **Confirmation** 對話方塊中，選取 **Delete** 或 **Cancel**。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/microsoft-4404708b/zh-TW/publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png" alt="刪除相依性事件" />

<a id="ID4ERH" />

## 下載事件資訊清單檔案

完成定義及變更遊戲的事件之後，您必須將它們發佈至 XBOX Live，並下載事件資訊清單檔案，這是開發遊戲所需的檔案。

如需下載事件資訊清單檔案的相關資訊，請參閱[下載事件資訊清單檔案](/zh-TW/publishing/game-publishing/how-to/data-platform-2013/how-to-download-events-manifest)。


## Related topics

- [在 Partner Center 中設定 XBOX Data Platform 2013](/zh-TW/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-data-platform-2013.md)
- [在 Partner Center 中設定成就](/zh-TW/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-achievements-2013.md)
- [在 Partner Center 中設定 XBOX 統計資料和統計資料規則](/zh-TW/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stats.md)
- [在 Partner Center 中設定 Rich Presence 字串](/zh-TW/services/xbox-services/community/presence/config/live-presence-config2.md)
- [在 Partner Center 中設定 XBOX 產品](/zh-TW/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-product-onboarding-and-configuration.md)
