向另一位玩家发送请求,以加入多人游戏体验。

本主题描述如何向另一位玩家发送请求,以加入多人游戏体验。 游戏可使用此邀请的多人游戏活动 (MPA)。

可由游戏或外部服务器直接发送邀请。 游戏使用下表中的信息发送邀请。

字段 用途 注意
xuids 要邀请的一个或多个玩家中的 XboxUserIds
allowCrossPlatformJoin 指示其他平台上的玩家是否收到邀请。 有关详细信息,请参阅以下支持 crossplay 邀请部分。
connectionString 对 MPA 不透明的游戏定义字符串。 包含游戏可用于连接到其他玩家的信息。 必须少于 256 个字符。

支持 crossplay 邀请

在 Microsoft 游戏开发工具包 (GDK) 中创建活动或发送邀请时,游戏可指定 allowCrossPlatformJoin 标志。 如果为 false,Microsoft 游戏开发工具包 (GDK) 将自动用当前平台填充平台字段。 只能由该平台上的玩家接收邀请。 如果为 true,Microsoft 游戏开发工具包 (GDK) 将使平台字段为 null,表明此邀请是跨平台的。

从服务器发送邀请

外部服务器也可代表玩家发送邀请。 其内容与前面的客户端字段相同,只添加了一个字段,如下表所示。

Server-only 字段 用途 注意
sender 指示服务器正在向其发送邀请的玩家。 必须是有效玩家。