XblMultiplayerSessionMember
表示多人游戏会话中成员的只读引用。语法
成员
MemberId类型:uint32_t 此成员的 ID。在此成员所属会话的上下文中唯一。 TeamId
类型:const char* 此成员在锦标赛中的团队 ID。已弃用。此项将在未来版本中删除。 InitialTeam
类型:const char* 来自 SmartMatch 的初始团队分配。 ArbitrationStatus
类型:XblTournamentArbitrationStatus 锦标赛中成员的仲裁状态。已弃用。此项将在未来版本中删除。 Xuid
类型:uint64_t 成员的 XBOX 用户 ID。仅在成员已接受时可知。 CustomConstantsJson
类型:const char* 指定成员自定义常量的 JSON 字符串。 SecureDeviceBaseAddress64
类型:const char* 成员的 base64 编码安全设备地址。(可选) Roles
类型:const XblMultiplayerSessionMemberRole* 此成员的角色数组。(可选) RolesCount
类型:size_t Roles 数组中的条目数。 CustomPropertiesJson
类型:const char* 指定成员自定义属性的 JSON 字符串。 Gamertag
类型:char[XBL_GAMERTAG_CHAR_SIZE] 成员的玩家代号。(可选)仅在成员已接受时可知。 Status
类型:XblMultiplayerSessionMemberStatus 此成员的状态。 IsTurnAvailable
类型:bool 仅当此成员准备好轮到自己时为 true。 IsCurrentUser
类型:bool 指示此 MultiplayerSessionMember 是否为当前用户。 InitializeRequested
类型:bool 指示为该用户运行 QoS 初始化。默认为 false。如果会话没有 “memberInitialization” 部分,则忽略。 MatchmakingResultServerMeasurementsJson
类型:const char* 当匹配将用户添加到会话时,它可以提供有关如何以及为何将他们匹配到会话中的一些上下文。这是用户从匹配会话中的 serverMeasurements 的副本。 ServerMeasurementsJson
类型:const char* 按游戏服务器连接字符串进行 QoS 测量。与所有字段一样,“serverMeasurements” 必须作为一个整体进行更新,因此应在测量完成后设置一次。如果为空,则表示没有任何测量在 “serverMeasurementTimeout” 内完成。 MembersInGroupIds
类型:const uint32_t* 所在组中 memberId 的集合。如果设置了 “initializationGroup” 列表,则该成员自己的索引在未存在时将始终添加。在托管初始化期间,如果列表中的任何成员失败,此成员也将失败。 MembersInGroupCount
类型:size_t MembersInGroupIds 数组中的条目数。 QosMeasurementsJson
类型:const char* 按安全设备地址进行 QoS 测量。与所有字段一样,“measurements” 必须作为一个整体进行更新。应在测量完成后设置一次,而不是增量更新。如果设置了 “measurements” 对象,则不能包含成员自己地址的条目。 DeviceToken
类型:XblDeviceToken 在成员上传安全设备地址时设置。它是一个不区分大小写的字符串,可用于相等性比较。 Nat
类型:XblNetworkAddressTranslationSetting 这是成员上传安全设备地址时设备的 NAT 设置。 ActiveTitleId
类型:uint32_t 如果成员处于活动状态,则这是他们所处活动状态的标题 ID。 InitializationEpisode
类型:uint32_t 此值仅在标题手动管理其自己的 QoS 时读取有用。如果设置了 “memberInitialization” 部分,并且成员是使用 “initialize”:true 添加的,则此项设置为该成员将参与的初始化 episode,否则为 0。用户批量加入会话。初始化 episode 号指示需要针对其执行 QoS 的一组用户。初始化 episode 1 是特殊值,用于在创建时添加到新会话的成员。 JoinTime
类型:time_t 用户加入会话的时间。如果 “reserved” 为 true,则这是进行预留的时间。 InitializationFailureCause
类型:XblMultiplayerMeasurementFailure 初始化失败的原因;如果没有失败,则为 XblMultiplayerMeasurementFailure::None。在此成员未通过时,从 “joining” 或 “measuring” 阶段过渡出去时设置。 Groups
类型:const char** 当前用户的组名称数组,指示该用户在多人游戏会话期间所属的组。 GroupsCount
类型:size_t Groups 数组中的项数。 Encounters
类型:const char** 获取当前用户的组名称列表,指示该用户在多人游戏会话期间遇到的组。 EncountersCount
类型:size_t Groups 数组中的项数。 TournamentTeamSessionReference
类型:XblMultiplayerSessionReference 锦标赛团队会话引用。已弃用。此项将在未来版本中删除。 Internal
类型:void* 仅供内部使用。
