XblMultiplayerActivityInfo

关于玩家在玩某个游戏时的活动信息。

语法

typedef struct XblMultiplayerActivityInfo {  
    uint64_t xuid;  
    const char* connectionString;  
    XblMultiplayerActivityJoinRestriction joinRestriction;  
    size_t maxPlayers;  
    size_t currentPlayers;  
    const char* groupId;  
    XblMultiplayerActivityPlatform platform;  
} XblMultiplayerActivityInfo  

成员

xuid
类型: uint64_t

活动信息所属的 Xbox 用户 ID。

connectionString
类型: const char*

传递给连接客户端以加入游戏的连接字符串; 通常包含诸如服务器 IP 地址等信息。 当查询活动时,该字段仅在活动是公开的或玩家在跟踪调用者时才会填入。

joinRestriction
类型: XblMultiplayerActivityJoinRestriction

指定可加玩家当前活动的人员。

maxPlayers
类型: size_t

可加入玩家当前活动的玩家人数上限。 值为 0 表示没有玩家可以加入。

currentPlayers
类型: size_t

在多人游戏活动中已经和该玩家一起玩的玩家数量。 值为 0 表示当前没有其他玩家正在玩。

groupId
类型:const char*

一个独特的标识符,将所有用户作为同一活动的一部分进行分组。 游戏在创建活动时设置该标识符。

platform
类型: XblMultiplayerActivityPlatform

举行活动的平台。 当设置活动时,会自动推断出平台; 会忽略该字段。

备注

若要了解如何使用此枚举,请参阅 “多玩家活动示例代码”“活动” 部分中的“设置活动”和“获取活动”。

参数属于

XblMultiplayerActivityGetActivityResult
XblMultiplayerActivitySetActivityAsync

要求

标头: multiplayer_activity_c.h

另请参阅

multiplayer_activity_c