> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 活動

> 使用多人遊戲活動向其他 XBOX 玩家宣傳可加入的多人遊戲體驗，包括活動欄位、加入限制和玩家數目。

本主題說明如何向其他玩家宣傳可加入的多人遊戲體驗。他們接著就可以加入這些體驗。

## 使用活動

當玩家開始或加入多人遊戲體驗時，遊戲應建立活動，在多人遊戲活動 (MPA) 中宣傳
此狀態。與以工作階段為基礎的模型不同，活動是以玩家為單位的。每位玩家都應建立
自己的活動，即使他們是一起遊玩也一樣。

只要玩家處於多人遊戲體驗中，遊戲就應立即建立此活動。在體驗期間，如果玩家
數目增加或減少，遊戲應修改活動。如果玩家結束或離開多人遊戲體驗，遊戲應刪除
活動。如果遊戲當機或因其他原因而無法移除活動，MPA 會在偵測到玩家已停止遊玩
該遊戲時嘗試移除活動。如果活動在 24 小時內沒有更新，就會自動移除。

## 活動內容

活動包含下表所示的資訊。

| 欄位 | 用途 | 注意事項 |
| - | - | - |
| `xuid` | 建立活動之使用者的 `XboxUserId`。 | 只在查詢活動時使用。玩家只能為自己設定活動。 |
| `connectionString` | 遊戲定義的字串，對 MPA 而言是不透明的。包含遊戲可用來連線至另一位玩家的資訊。 | 必須少於 512 個字元。 |
| `joinRestriction` | 代表誰可以看到此活動中的連線字串。如需詳細資料，請參閱本主題稍後的「隱私權」一節。 | 必須是 `Public`、`Followed`、`InviteOnly`。 |
| `maxPlayers` | 此活動中允許的玩家數目上限。 | 選擇性。如果指定，必須大於 1 且小於或等於 100。 |
| `currentPlayers` | 此活動中目前的玩家數目。 | 選擇性。如果指定，必須大於 0 且小於或等於 100。 |
| `groupId` | 遊戲定義的識別碼。具有相同 `groupId` 的玩家在 MPA 中會被視為一起遊玩。 | 必須少於 128 個字元，且只能用於群組身分識別。 |
| `platform` | 設定為特定平台時，會將透過邀請和加入進行的跨平台遊玩限制為僅限該平台。未設定時，會啟用與所有已定義平台的跨平台遊玩。 | 如需詳細資訊，請參閱本主題稍後的「支援跨平台遊玩活動」一節。 |

## 隱私權

遊戲可能只想允許其社交關係圖上的部分玩家加入
該玩家。`joinRestriction` 欄位決定其他玩家在檢視此活動時是否會收到
連線字串。值及其意義如下表所示。

| 值 | 意義 |
| - | - |
| `Public` | 所有玩家都可以加入此活動。 |
| `Followed` | 如果活動建立者追蹤另一位玩家，該玩家就可以加入。 |
| `InviteOnly` | 除非玩家是在回應邀請，否則任何玩家都無法加入此活動。 |

## 支援跨平台遊玩活動

在 Microsoft Game Development Kit (GDK) 中建立活動時，遊戲可以指定 `allowCrossplay` 旗標。
如果為 `false`，Microsoft Game Development Kit (GDK) 會自動以目前的平台填入邀請的平台欄位。
如果為 `true`，Microsoft Game Development Kit (GDK) 會將平台欄位保留為 `null`，表示
邀請是跨平台的。透過跨平台遊玩允許的平台清單是由遊戲
設定所定義的。在此案例中，主機世代被視為跨平台遊玩。

## 擷取活動

擷取其他玩家的活動時，連線字串有時會被
隱藏。這表示該玩家不被允許加入此活動。例如，連線字串可能會因為活動的
`joinRestriction` 而被隱藏，或是活動已滿。


## Related topics

- [PAGE 指南 112 - 活動後](https://docs.xbox.com/zh-TW/build/game-principles/accessibility/page/page-112-post-event.md)
- [即時活動 (RTA) 服務 (內容)](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/rta/live-rta-nav.md)
- [多人遊戲活動 (MPA)](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpa/live-mpa-nav.md)
- [回報廣告活動](https://docs.xbox.com/zh-TW/services/playfab/api-references/rest/client/advertising/report-ad-activity.md)
- [多人遊戲活動 URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/multiplayeractivity/atoc-reference-multiplayer-activity.md)