> ## 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](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionvisibility)

工作階段的可見性。

*InitiatorXuids*\
類型：uint64\_t\*

XBOX 使用者識別碼的集合，指出誰起始了工作階段。(選用)

*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\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayermemberinitialization)

如果已設定，工作階段會預期用戶端系統或遊戲在建立工作階段後執行初始化。工作階段會自動追蹤逾時與初始化階段，如果已設定任何計量，也包括初始服務品質 (QoS) 測量。

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

工作階段成員之間連線的 QoS 需求。

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

主機候選項目與工作階段成員之間連線的 QoS 需求。

*MeasurementServerAddressesJson*\
類型：const char\*

應評估的一組潛在伺服器連接字串。

*ClientMatchmakingCapable*\
類型：bool

指出是否可以寫入配對狀態欄位。

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

工作階段的功能。

## 備註

工作階段常數只會在建立工作階段時，由建立者或工作階段範本設定。

## 需求

**標頭：** multiplayer\_c.h

## 另請參閱

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


## Related topics

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