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

# MultiplayerSessionRequest (JSON)

> MultiplayerSessionRequest (JSON)

# MultiplayerSessionRequest (JSON)

針對 **MultiplayerSession** 物件之作業所傳遞的要求 JSON 物件。

<a id="ID4EQ" />

MultiplayerSessionRequest JSON 物件具有下列規格。

| 成員 | 類型 | 描述 |
| - | - | - |
| constants | object | 與工作階段範本合併以產生工作階段常數的唯讀設定。 |
| properties | object | 要合併至工作階段屬性的變更。 |
| members.me | object | 運作方式與其最上層對應項目非常類似的常數和屬性。任何 PUT 方法都要求使用者必須是工作階段的成員，並在必要時新增該使用者。如果 "me" 指定為 null，則提出要求的成員會從工作階段中移除。 |
| members | object | 代表要新增至工作階段之使用者的其他物件，以從零開始的索引作為索引鍵。要求中的成員數目一律從 0 開始，即使工作階段已包含成員也一樣。成員會依照其在要求中出現的順序新增至工作階段。成員屬性只能由其所屬的使用者設定。 |
| servers | object | 指出工作階段相關聯伺服器參與者集合之更新和新增項目的值。如果伺服器指定為 null，該伺服器項目會從工作階段中移除。 |

<a id="ID4EZ" />

## 要求結構

```json theme={null}
{
  "constants": { /* Property Bag */ },
  "properties": { /* Property Bag */ },
  "members": {
    // Requires a service principal. Existing members can be deleted by index.
    // Not available on large sessions.
    "5": null,

    // Reservation requests must start with zero. New users will get added in order to the end of the session's member list.
    // Large sessions don't support reservations.
    "reserve_0": {
      "constants": { /* Property Bag */ }
    },
    "reserve_1": {
      "constants": { /* Property Bag */ }
    },

    // Requires a user principal with a xuid claim. Can be 'null' to remove myself from the session.
    "me": {
      "constants": { /* Property Bag */ },
      "properties": { /* Property Bag */ },
    }
  },

  // Requires a server principal.
  "servers": {
    // Can be any name. The value can be 'null' to remove the server from the session.
    "name": {
      "constants": {  /* Property Bag */ },
      "properties": {  /* Property Bag */ }
    }
  }
}
```

<a id="ID4EAB" />

## 另請參閱

<a id="ID4ECB" />

##### 上層

[JavaScript Object Notation (JSON) 物件參考](/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json)

<a id="ID4EMB" />

##### 參考

[MultiplayerSession (JSON)](/zh-TW/reference/live/rest/json/json-multiplayersession)

[PUT (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameput)


## Related topics

- [Multiplayer FAQ and troubleshooting](/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [Perguntas frequentes e solução de problemas de multiplayer](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [FAQ et résolution des problèmes multijoueurs](/fr-CA/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)
- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Preguntas frecuentes y solución de problemas de multijugador](/es/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-2015-faq.md)