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

# 傳送邀請讓另一位玩家加入多人遊戲

> 傳送多人遊戲活動邀請，讓另一位 XBOX 玩家可以加入遊戲，包括用戶端和伺服器流程、跨平台遊玩旗標和連線字串。

本主題說明如何傳送要求讓另一位玩家加入多人遊戲體驗。遊戲可以使用多人遊戲活動 (MPA) 來進行此邀請。

邀請可以直接由遊戲傳送，或由外部伺服器傳送。遊戲會使用下表中的資訊傳送邀請。

| 欄位 | 用途 | 注意事項 |
| - | - | - |
| `xuids` | 要邀請之一或多位玩家的 `XboxUserIds`。 | |
| `allowCrossPlatformJoin` | 指出其他平台上的玩家是否會收到邀請。 | 如需詳細資訊，請參閱下列「支援跨平台遊玩邀請」一節。 |
| `connectionString` | 遊戲定義的字串，對 MPA 而言是不透明的。包含遊戲可用來連線至另一位玩家的資訊。 | 必須少於 256 個字元。 |

## 支援跨平台遊玩邀請

在 Microsoft Game Development Kit (GDK) 中建立活動或傳送邀請時，遊戲可以指定
`allowCrossPlatformJoin` 旗標。如果為 `false`，Microsoft Game Development Kit (GDK) 會自動以
目前的平台填入平台欄位。邀請只會由該平台上的玩家接收。如果為 `true`，
Microsoft Game Development Kit (GDK) 會將平台欄位保留為 `null`，表示邀請是跨平台的。

## 從伺服器傳送邀請

外部伺服器也可以代表玩家傳送邀請。其內容與
先前的用戶端欄位相同，另外增加一個欄位，如下表所示。

| 僅限伺服器的欄位 | 用途 | 注意事項 |
| - | - | - |
| `sender` | 指出伺服器代表哪位玩家傳送邀請。 | 必須是有效的玩家。 |


## Related topics

- [邀請玩家加入遊戲工作階段](/zh-TW/services/xbox-services/multiplayer/invites/live-invites-nav.md)
- [多人遊戲活動的範例程式碼](/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [概念](/zh-TW/services/xbox-services/multiplayer/mpa/concepts/index.md)
- [多人遊戲活動 (MPA) 概念](/zh-TW/services/xbox-services/multiplayer/mpa/concepts/live-mpa-concepts-nav.md)
- [多人遊戲活動 (MPA) 功能概觀](/zh-TW/services/xbox-services/multiplayer/mpa/live-mpa-overview.md)
