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

# XR-064 可加入的遊戲工作階段與線上遊戲

> XR-064 可加入的遊戲工作階段與線上遊戲

版本 3.0，7/27/2026

提供可加入之多人或合作體驗的遊戲，必須使用 Multiplayer Activity (MPA) 功能，透過 XBOX 殼層介面公告可加入性。公告可加入的活動可讓玩家透過 XBOX 殼層 (例如朋友清單、玩家卡和 Game Bar) 加入，以及傳送和接收邀請，包括有跨網路玩家參與的情境。

## 其他資訊

可加入的多人體驗是指玩家能夠刻意一起遊玩的體驗。範例包括但不限於直接加入其他玩家、傳送和接收邀請、私人大廳，以及受密碼保護的體驗。如果使用者已不在支援加入的體驗中，該使用者就不得顯示為可加入，因此當玩家不再可加入時，遊戲必須清除所公告的活動。

當使用者加入遊戲工作階段，但該體驗因任何原因已無法供該使用者加入時，遊戲必須執行下列其中一項：

* 要求使用者等待下一次加入的機會。
* 向使用者顯示清楚的訊息，說明加入失敗的原因。

對於使用 Multiplayer Activity 功能公告可加入性的遊戲，請在整個可加入活動期間，持續更新玩家人數、限制和 groupId。XBOX 殼層不會強制執行工作階段容量，因此遊戲必須負責管理玩家人數，並在工作階段已滿時拒絕加入或將加入要求排入佇列。僅支援透過配對加入的遊戲 (例如排名賽) 不需要透過 XBOX 殼層公告可加入性，且遊戲可以要求加入前須符合必要條件 (例如必要的可下載內容)，前提是必須清楚告知玩家。

如需使用 GDK 公告可加入活動及傳送邀請的相關資訊，請參閱 [Multiplayer Activity 概觀](/zh-TW/services/xbox-services/multiplayer/mpa/live-mpa-overview)。

## 邀請

對於可加入的工作階段，從 XBOX 殼層傳送的平台邀請必須一律可用。建議提供遊戲內邀請，但這不是硬性需求；遊戲不需要先提供遊戲內邀請機制，玩家才能透過殼層邀請其他人。

當遊戲確實提供遊戲內邀請機制時，該機制必須透過 XBOX 平台傳送邀請，讓收件者透過 XBOX 殼層通知收到邀請。遊戲可以限制誰能傳送邀請 (例如只有主持人或隊長)，並可以只顯示玩家 XBOX 朋友的子集。僅能在系列作品、社團或戰隊內加入的遊戲，可據此限定邀請範圍。

## 實作指引與最佳做法

使用 Multiplayer Activity (MPA) 功能公告可加入的活動，以及傳送和接受邀請，並持續以玩家人數、可加入狀態和限制更新活動。請勿為了相同目的將 MPA 與舊版 Multiplayer Session Directory (MPSD) 混用，因為同時維護兩者可能會產生重複的記錄和加入衝突。每當工作階段變成無法加入時，請清除活動，並使用 XBOX 平台邀請 API，讓平台邀請與遊戲內邀請的行為保持一致。

## 認證測試案例

### 064-01 從遊戲外部加入遊戲工作階段

**設定**

* 兩個 XBOX 設定檔
* 裝置 1 設定檔 A - 與設定檔 B 互為朋友
* 裝置 2 設定檔 B - 與設定檔 A 互為朋友

在零售版主機上，遊戲會在下列情況下暫停：

* 當電源模式設為「立即開機」時關閉主機，使主機進入連線待命狀態。
* 當遊戲失去焦點達十分鐘時。例如，啟動「設定」等應用程式並讓其保持焦點十分鐘。

就此測試案例而言，在 XBOX 主機上，請於步驟 5 啟動「設定」應用程式並讓其保持焦點十分鐘，以暫停遊戲。在 PC 和掌上型裝置上，請於步驟 5 讓系統進入睡眠或休眠。

**測試步驟**

1. 使用設定檔 A 建立可加入的遊戲工作階段。
2. 使用未執行該遊戲的設定檔 B，透過 XBOX 殼層介面存取朋友清單，並確認設定檔 A 列為可加入。
   * 部分遊戲可能僅支援私人多人工作階段，因此不會對設定檔 B 顯示為可加入，在此情況下請跳至步驟 6。
3. 設定檔 B 加入設定檔 A 的遊戲。
4. 確認兩個設定檔一起進入遊戲體驗。
5. 在主機上遊戲處於暫停狀態時，以及在 PC 或掌上型裝置上系統處於睡眠或休眠狀態時，以設定檔 B 重複步驟 1-4。
6. 重複步驟 1-5，但這次不是由設定檔 B 透過朋友清單加入，而是由設定檔 A 透過系統殼層傳送遊戲邀請給設定檔 B，並確定設定檔 B 能夠接收、接受並加入設定檔 A。

**預期結果**<br />使用者 B 必須能夠加入使用者 A 的遊戲，並一起進入遊戲體驗。對於僅支援私人多人工作階段、因此不會對設定檔 B 顯示為可加入的遊戲，可以接受以邀請作為加入設定檔 A 的唯一機制。對於僅支援透過配對加入工作階段的多人遊戲工作階段 (例如排名賽)，可以接受不支援透過 XBOX 殼層介面加入。對於支援跨平台多人遊戲的遊戲，使用者必須能夠在 XBOX One 主機與 PC 之間加入。

**通過範例**

1. 兩個設定檔一起進入遊戲體驗。
2. 使用者 B 能夠加入使用者 A 的遊戲，並一起進入遊戲體驗。
3. 由於遊戲僅支援私人多人工作階段，使用者 A 不會在 XBOX 殼層介面的朋友清單中顯示為可加入，但使用者 A 能夠透過系統殼層傳送遊戲邀請給使用者 B。
4. 使用者 A 在參與僅支援透過配對加入的工作階段 (例如排名賽) 時，不會顯示為可加入，也無法透過 XBOX 殼層介面傳送遊戲邀請。

**失敗範例**

1. 使用者 B 無法成功加入使用者 A 的遊戲，且未進入遊戲體驗。
2. 由於遊戲僅支援私人多人工作階段，使用者 A 不會在 XBOX 殼層介面的朋友清單中顯示為可加入，且使用者 A 無法透過系統殼層傳送遊戲邀請給使用者 B。

### 064-02 從相同遊戲中加入遊戲工作階段

**設定**

* 2 個 XBOX 設定檔
* 裝置 1 設定檔 A - 與設定檔 B 互為朋友
* 裝置 2 設定檔 B - 與設定檔 A 互為朋友

**測試步驟**

1. 使用設定檔 A 啟動遊戲，並在遊戲內建立可加入的遊戲工作階段。
2. 使用設定檔 B 啟動相同的遊戲，並進入遊戲內的某個體驗。
3. 使用設定檔 B，透過 XBOX 殼層介面存取朋友清單，並選取加入設定檔 A 的遊戲。
   * 部分遊戲可能僅支援私人多人工作階段，因此不會對設定檔 B 顯示為可加入，在此情況下請跳至步驟 5。
4. 確認兩個設定檔一起進入遊戲體驗。
5. 重複步驟 1-4，但這次不是由設定檔 B 透過 XBOX 殼層介面的朋友清單加入，而是由設定檔 A 透過系統殼層傳送遊戲邀請給設定檔 B，並確定設定檔 B 能夠接收、接受並加入設定檔 A。

**預期結果**<br />使用者 B 必須能夠加入使用者 A 的遊戲，並一起進入遊戲體驗。對於僅支援私人多人工作階段、因此不會對設定檔 B 顯示為可加入的遊戲，可以接受以邀請作為加入設定檔 A 的唯一機制。對於僅支援透過配對加入工作階段的多人遊戲工作階段 (例如排名賽)，可以接受不支援透過 XBOX 殼層介面加入。對於支援跨平台多人遊戲的遊戲，使用者必須能夠在 XBOX One 主機與 PC 之間加入。

**通過範例**

1. 兩個設定檔一起進入遊戲體驗。
2. 使用者 B 能夠加入使用者 A 的遊戲，並一起進入遊戲體驗。
3. 由於遊戲僅支援私人多人工作階段，使用者 A 不會在 XBOX 殼層介面的朋友清單中顯示為可加入，但使用者 A 能夠透過系統殼層傳送遊戲邀請給使用者 B。
4. 使用者 A 在參與僅支援透過配對加入的工作階段 (例如排名賽) 時，不會顯示為可加入，也無法透過 XBOX 殼層介面傳送遊戲邀請。

**失敗範例**

1. 使用者 B 無法成功加入使用者 A 的遊戲，且未進入遊戲體驗。
2. 由於遊戲僅支援私人多人工作階段，使用者 A 不會在 XBOX 殼層介面的朋友清單中顯示為可加入，且使用者 A 無法透過系統殼層傳送遊戲邀請給使用者 B。

### 064-03 遊戲內邀請

*此測試案例僅適用於提供遊戲內邀請機制的遊戲。*

**設定**

* 兩個 XBOX 設定檔，各自登入不同的裝置
* 裝置 1 設定檔 A - 與設定檔 B 互為朋友
* 裝置 2 設定檔 B - 與設定檔 A 互為朋友

如需了解如何在 XBOX 主機上暫停遊戲，以及如何讓 PC 或掌上型裝置進入睡眠和休眠，請參閱[主機 XR 與測試案例](/zh-TW/publishing/certification/console-cert-tested-requirements#testing-suspend-sleep-and-hibernate)頁面。

**測試步驟**

1. 讓使用者 A 和 B 登入各自的裝置。
2. 兩位使用者都啟動遊戲。
3. 使用者 A 建立遊戲工作階段，並找到遊戲內傳送邀請的選項。
4. 使用者 A 傳送遊戲邀請給使用者 B。
5. 設定檔 B 在下列每個區域接受邀請，以加入設定檔 A 的遊戲工作階段。
   * 從初始開機程序到初始互動狀態之間的任何位置
   * 主功能表 (如有提供)
   * 單人遊戲過程中 (如有提供)
   * 多人遊戲過程中 (如有提供)
   * 遊戲在主機上處於暫停狀態，或在 PC 或掌上型裝置上處於睡眠或休眠狀態時，位於主功能表 (如有提供)
   * 遊戲在主機上處於暫停狀態，或在 PC 或掌上型裝置上處於睡眠或休眠狀態時，位於單人遊戲過程中 (如有提供)
   * 遊戲在主功能表處於受限狀態時 (如有提供)
   * 遊戲在任何遊戲過程中處於受限狀態時 (如有提供)
6. 確認每次邀請後，兩個設定檔都一起進入遊戲體驗。

**預期結果**<br />當遊戲提供遊戲內邀請機制時，該機制必須透過 XBOX 平台傳送邀請，讓設定檔 B 透過 XBOX 殼層通知收到邀請，並能夠加入設定檔 A 所主持的工作階段。遊戲可以限制誰能傳送工作階段邀請 (例如在團隊遊戲中只有隊長)。由於遊戲無法阻止邀請或加入動作的執行，因此不需要要求確認破壞性動作。對於支援跨平台多人遊戲的遊戲，使用者必須能夠在 XBOX One 主機與 PC 之間透過邀請加入工作階段。

**通過範例**

1. 遊戲內邀請選項透過 XBOX 平台傳送邀請，且設定檔 B 透過 XBOX 殼層接收並接受邀請。
2. 玩家在遊戲中接受遊戲邀請時，不會收到破壞性動作確認訊息。
3. 邀請完成，但由於裝置上沒有必要的 DLC，因此無法開始/啟動工作階段。已清楚告知玩家此情況。
4. 只有遊戲工作階段的主持人可以傳送邀請，前提是可清楚得知誰是主持人。

**失敗範例**

1. 遊戲內邀請機制未透過 XBOX 平台傳送邀請，因此設定檔 B 未透過 XBOX 殼層收到邀請。
2. 接受遊戲邀請後，作用中的玩家未被帶入其受邀加入的遊戲工作階段。
3. 裝置上沒有必要的 DLC 時邀請未完成，且未告知玩家此情況。

### 064-04 無法加入的遊戲

**設定**

* 3 個 XBOX 設定檔，各自登入不同的裝置
* 裝置 1 設定檔 A - 與設定檔 B 和 C 互為朋友
* 裝置 2 設定檔 B - 與設定檔 A 互為朋友
* 裝置 3 設定檔 C - 與設定檔 A 互為朋友

**測試步驟**

1. 使用設定檔 A 啟動遊戲，並建立可加入的遊戲工作階段。
2. 使用設定檔 A 邀請設定檔 B 和 C 加入遊戲。
3. 使用設定檔 A 進入遊戲工作階段，使 A 加入後只剩下一個空位。
4. 使用設定檔 B 接受邀請。
5. 確認設定檔 A 和 B 正在一起遊玩。
6. 使用設定檔 C 接受邀請，並嘗試加入遊戲工作階段。

**預期結果**<br />系統要求設定檔 C 等待下一次加入的機會，或向設定檔 C 告知無法加入遊戲工作階段的原因。

**通過範例**

1. 系統要求設定檔 C 等待下一次加入的機會。
2. 系統向設定檔 C 告知無法加入遊戲工作階段的原因。

**失敗範例**

1. 系統未要求設定檔 C 等待下一次加入的機會，且未向設定檔 C 告知無法加入的原因。


## Related topics

- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [最常失敗的測試案例](/zh-TW/publishing/certification/xr-top-failing.md)
- [Beta 版與 XBOX Game Preview 遊戲產品的需求](/zh-TW/publishing/certification/cert-beta-game-preview.md)
- [XR064 可加入的遊戲工作階段與線上遊戲](/zh-TW/publishing/certification/fma/xr-064.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)