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

# XblMultiplayerSessionConstants

> XblMultiplayerSessionConstants

# XblMultiplayerSessionConstants

表示多人游戏会话的常量。

## 语法

```cpp theme={null}
typedef struct XblMultiplayerSessionConstants {  
    uint32_t MaxMembersInSession;  
    XblMultiplayerSessionVisibility Visibility;  
    uint64_t* InitiatorXuids;  
    size_t InitiatorXuidsCount;  
    const char* CustomJson;  
    const char* SessionCloudComputePackageConstantsJson;  
    uint64_t MemberReservedTimeout;  
    uint64_t MemberInactiveTimeout;  
    uint64_t MemberReadyTimeout;  
    uint64_t SessionEmptyTimeout;  
    uint64_t ArbitrationTimeout;  
    uint64_t ForfeitTimeout;  
    bool EnableMetricsLatency;  
    bool EnableMetricsBandwidthDown;  
    bool EnableMetricsBandwidthUp;  
    bool EnableMetricsCustom;  
    XblMultiplayerMemberInitialization* MemberInitialization;  
    XblMultiplayerPeerToPeerRequirements PeerToPeerRequirements;  
    XblMultiplayerPeerToHostRequirements PeerToHostRequirements;  
    const char* MeasurementServerAddressesJson;  
    bool ClientMatchmakingCapable;  
    XblMultiplayerSessionCapabilities SessionCapabilities;  
} XblMultiplayerSessionConstants  
```

### 成员

*MaxMembersInSession*\
类型：uint32\_t

会话中的最大成员数。

*Visibility*\
类型：[XblMultiplayerSessionVisibility](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility)

会话的可见性。

*InitiatorXuids*\
类型：uint64\_t\*

指示谁发起了会话的 XBOX 用户 ID 集合。（可选）

*InitiatorXuidsCount*\
类型：size\_t

`InitiatorXuids` 数组中的条目数。

*CustomJson*\
类型：const char\*

会话的任何自定义常量，以 JSON 字符串指定。会话创建后不能更改这些常量。（可选）

*SessionCloudComputePackageConstantsJson*\
类型：const char\*

会话的 Cloud Compute 包常量，以 JSON 字符串指定。会话创建后不能更改这些常量。（可选）

*MemberReservedTimeout*\
类型：uint64\_t

持有预留位置的成员加入会话的最长时间（以毫秒为单位）。如果成员没有在此时间内加入，则会移除该预留位置。

*MemberInactiveTimeout*\
类型：uint64\_t

非活动成员变为活动状态的最长时间（以毫秒为单位）。如果非活动成员没有在此时间内变为活动状态，则该成员会被从会话中移除。

*MemberReadyTimeout*\
类型：uint64\_t

标记为准备就绪的成员变为活动状态的最长时间（以毫秒为单位）。当外壳启动标题以开始多人游戏时，成员被标记为准备就绪。如果被标记为准备就绪的成员未在此时间内变为活动状态，则该成员将变为非活动状态。

*SessionEmptyTimeout*\
类型：uint64\_t

会话可保持为空的最长时间（以毫秒为单位）。如果没有成员在此时间内加入会话，则删除会话。

*ArbitrationTimeout*\
类型：uint64\_t

从开始时间起的时间增量（以毫秒为单位），表示结果最终确定的时间。如果没有人（客户端或服务器）在此时间内报告结果，我们会宣布比赛结果不完整。已弃用。此成员将在未来版本中删除。

*ForfeitTimeout*\
类型：uint64\_t

从开始时间起的时间增量（以毫秒为单位），表示如果会话没有活动用户，比赛将被取消的时间。已弃用。此成员将在未来版本中删除。

*EnableMetricsLatency*\
类型：bool

如果为 true，则表示标题希望测量延迟以帮助确定连接性。需要 `capabilities.connectivity` 为 true。

*EnableMetricsBandwidthDown*\
类型：bool

如果为 true，则表示标题希望测量下行（主机到对等）带宽以帮助确定连接性。需要 `capabilities.connectivity` 为 true。

*EnableMetricsBandwidthUp*\
类型：bool

如果为 true，则表示标题希望测量上行（对等到主机）带宽以帮助确定连接性。需要 `capabilities.connectivity` 为 true。

*EnableMetricsCustom*\
类型：bool

如果为 true，则表示标题希望自定义测量以帮助确定连接性。需要 `capabilities.connectivity` 为 true。

*MemberInitialization*\
类型：[XblMultiplayerMemberInitialization\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayermemberinitialization)

如果已设置，则会话预期客户端系统或标题在会话创建后执行初始化。超时和初始化阶段由会话自动跟踪，包括在设置了任何指标时的初始服务质量 (QoS) 测量。

*PeerToPeerRequirements*\
类型：[XblMultiplayerPeerToPeerRequirements](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayerpeertopeerrequirements)

会话成员之间连接的 QoS 要求。

*PeerToHostRequirements*\
类型：[XblMultiplayerPeerToHostRequirements](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayerpeertohostrequirements)

主机候选者和会话成员之间连接的 QoS 要求。

*MeasurementServerAddressesJson*\
类型：const char\*

应评估的一组潜在服务器连接字符串。

*ClientMatchmakingCapable*\
类型：bool

指示是否可以写入匹配状态字段。

*SessionCapabilities*\
类型：[XblMultiplayerSessionCapabilities](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioncapabilities)

会话的功能。

## 备注

会话常量仅在创建会话时由创建方或会话模板设置。

## 要求

**头文件：** multiplayer\_c.h

## 另请参阅

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionCapabilities](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessioncapabilities.md)
- [XblMultiplayerManagerGameSessionConstants](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionconstants.md)
- [XblMultiplayerManagerLobbySessionConstants](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionconstants.md)
- [XblMultiplayerSessionVisibility](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility.md)
- [XblMultiplayerMemberInitialization](/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayermemberinitialization.md)