多人遊戲工作階段範本 - XBOX Game Development Documentation

本主題說明多人遊戲工作階段範本，並提供可供您為多人遊戲工作階段複製與修改的範本範例。多人遊戲工作階段範本是建立多人遊戲工作階段的藍圖。所有工作階段都必須根據預先定義的範本建立。範本定義的常數，對於從該範本建立的任何工作階段都相同。從範本建立工作階段時，您可以在工作階段中新增及修改其他資料。不過，您無法修改範本中定義的常數。如需詳細資訊，請參閱多人遊戲工作階段進階主題中的「工作階段概觀」一節。您可以從多人遊戲工作階段目錄 (MPSD) 取得適用於服務設定識別碼 (SCID) 的工作階段範本清單，以及特定工作階段範本的內容。

關於工作階段範本

用來建立或修改工作階段的工作階段範本，使用與 HTTP PUT 要求相同的格式。差異在於範本只定義常數，不定義成員、伺服器與屬性。可以定義任何工作階段常數，包括 custom 區段以及所有系統常數。

工作階段範本版本

本主題中定義的工作階段範本，是使用範本合約版本 107 建構的。使用這些範本建立新範本時，請確定將合約版本指定為 107。如果您使用 XBOX Services API (XSAPI) 並在偵錯工具中觀察產生的要求，可能會注意到要求使用的是範本合約版本 105。 MPSD 會在執行階段有效地將這些要求「升級」至版本 107。

您可以在要求中使用與工作階段範本不同的合約版本。

必要時，您可以將工作階段範本從版本 104 或 105 變更為版本 107。返回本主題頂端。

工作階段範本預設值

從工作階段範本建立的每個工作階段，一開始都是範本的複本。範本中未指定的值，可以在建立工作階段時指定。在某些情況下，若未設定其他值，則會提供預設值。合約版本 107 的預設逾時組合如下列範例所示。

    {
      "constants": {
        "system": {
          "reservedRemovalTimeout": 30000,
          "inactiveRemovalTimeout": 0,
          "readyRemovalTimeout": 180000,
          "sessionEmptyTimeout": 0
        }
      }
    }

您可以指定 null，強制讓某個值保持未設定。這會覆寫任何預設設定，並防止在建立工作階段時設定該值。例如，若要移除 sessionEmptyTimeout，讓即使是空的工作階段也會無限期持續，請將下列內容新增至工作階段範本。

    {
      "constants": {
        "system": {
          "sessionEmptyTimeout": null
        }
      }
    }

透過範本設定的常數，無法藉由寫入 MPSD 來變更。若要變更這些值，您必須建立並提交包含所需變更的新範本。

返回本主題頂端。

工作階段範本範例

本節提供適用於各種用途與網路拓撲的工作階段範本範例。您可以對適當的範本進行任何必要的變更，然後將其貼到您的服務設定中。

標準大廳工作階段

使用此範本為您的遊戲建立大廳工作階段。

將 maxMembersCount 值變更為您想在大廳工作階段中支援的最大玩家人數。
如果您的遊戲不支援來自不同平台 (例如 XBOX 主機與 Windows PC) 的玩家一起遊玩，您可以移除 crossPlay 元素。
您也可以變更其他值。如果您不確定需要什麼，下列值是很好的起點。

{
   "constants": {
        "system": {
            "version": 1,
            "maxMembersCount": 8,
            "visibility": "open",
            "capabilities": {
                "connectivity": true,
                "connectionRequiredForActiveMembers": true,
                "crossPlay": true,
                "userAuthorizationStyle": true
            },
        },
        "custom": {}
    }
}

不含配對的標準遊戲工作階段

如果您的遊戲不包含匿名配對，且不需要超過 100 位成員，請使用此範本為您的遊戲建立遊戲工作階段。此範本只在標準大廳工作階段範本中指定的值之外，新增兩個新值。

constants.system.inviteProtocol : "game"
constants.system.capabilities.gameplay : true

{
   "constants": {
        "system": {
            "version": 1,
            "maxMembersCount": 8,
            "visibility": "open",
            "inviteProtocol": "game",
            "capabilities": {
                "connectivity": true,
                "connectionRequiredForActiveMembers": true,
                "gameplay" : true,
                "crossPlay": true,
                "userAuthorizationStyle": true
            }
        },
        "custom": {}
    }
}

將配對新增至遊戲工作階段範本，由多人遊戲服務處理服務品質 (QoS) 檢查

若要在遊戲中啟用配對，請在遊戲工作階段範本中指定 memberInitialization 的值。建立 SmartMatch hopper 時，請使用下列範本作為 hopper 的目標工作階段範本。

{
   "constants": {
        "system": {
            "memberInitialization": {
               "joinTimeout": 20000,
               "measurementTimeout": 15000,
               "membersNeededToStart": 2
            }
        }
    }
}

將配對新增至遊戲工作階段，由遊戲管理的資料中心處理 QoS 檢查

{
   "constants": {
        "system": {
            "peerToHostRequirements": {  
                "latencyMaximum": 250,
                "bandwidthDownMinimum": 256,
                "bandwidthUpMinimum": 256,
                "hostSelectionMetric": "latency"
            },
            "memberInitialization": {
               "joinTimeout": 15000,
               "measurementTimeout": 15000,
               "membersNeededToStart": 2
            }
        },
        "custom": {}
    }
}

用戶端/伺服器遊戲工作階段的基本工作階段範本

對於讓用戶端連線至第三方裝載之伺服器 (而非使用點對點通訊) 的遊戲，請使用下列範本。

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "inviteProtocol": "game",
          "capabilities": {
            "connectionRequiredForActiveMembers": true,
            "gameplay": true,
          },
        },
        "custom": {}
      }
    }

對等式網路的大廳或 SmartMatch 票證工作階段範本

使用下列範本建立大廳工作階段或 SmartMatch 票證工作階段，以將一群玩家送入配對。此範本供使用點對點或對等對主機網路拓撲的用戶端使用。它不會設定遊戲工作階段。

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 10,
          "visibility": "open",
          "capabilities": {
            "connectionRequiredForActiveMembers": true,
          },
          "memberInitialization": {
            "membersNeededToStart": 1
          },
        },
        "custom": {}
      }
    }

返回本主題頂端。

QoS 範本

如果您的遊戲使用配對並評估 QoS，您必須將一些常數新增至工作階段範本，告知 MPSD 與用戶端協調，以管理正在加入工作階段的使用者。此協調會在通知使用者遊戲已準備開始之前，驗證連線狀態的品質。對於用戶端/伺服器遊戲，此協調會在一群玩家進入配對之前驗證連線品質。

具有 QoS 的對等對主機遊戲工作階段範本

使用下列範本建立具有 QoS 的對等對主機遊戲工作階段。

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "inviteProtocol": "game",
          "capabilities": {
            "connectivity": true,
            "connectionRequiredForActiveMembers": true,
            "gameplay" : true
          },
          "memberInitialization": {
            "membersNeededToStart": 2
          },
          "peerToHostRequirements": {
            "latencyMaximum": 350,
            "bandwidthDownMinimum": 1000,
            "bandwidthUpMinimum": 1000,
            "hostSelectionMetric": "latency"
          }
        },
        "custom": { }
      }
    }

具有 QoS 的點對點遊戲工作階段範本

使用下列範本建立具有 QoS 的點對點遊戲工作階段。

    {
    "constants": {
      "system": {
        "version": 1,
        "maxMembersCount": 12,
        "visibility": "open",
        "inviteProtocol": "game",
        "capabilities": {
          "connectivity": true,
          "connectionRequiredForActiveMembers": true,
          "gameplay" : true
        },
        "memberInitialization": {
          "membersNeededToStart": 2
        },
        "peerToPeerRequirements": {
          "latencyMaximum": 250,
          "bandwidthMinimum": 10000
        }
      },
      "custom": { }
     }
    }

具有 QoS 的用戶端/伺服器大廳或配對工作階段範本

使用下列範本，以 QoS 建立大廳工作階段或配對工作階段。此範本不應用來設定遊戲工作階段。

    {
      "constants": {
        "system": {
          "version": 1,
          "maxMembersCount": 12,
          "visibility": "open",
          "memberInitialization": {
            "membersNeededToStart": 1
          }
        },
        "custom": {}
      }
    }

XBOX One 與 Windows 10 之間跨平台遊玩的工作階段範本

使用下列範本，在 XBOX One (或更新版本) 與 Windows 10 之間啟用跨平台多人遊戲。

選擇性的 crossPlay 功能支援跨平台的邀請與中途加入等互動。
userAuthorizationStyle 功能可啟用對 Windows 10 的存取。

    {
      "constants": {
        "system": {
          "capabilities": {
            "crossPlay": true,
            "userAuthorizationStyle": true
          },
        },
        "custom": {}
      }
    }

​關於工作階段範本

​工作階段範本版本

​工作階段範本預設值

​工作階段範本範例

​標準大廳工作階段

​不含配對的標準遊戲工作階段

​將配對新增至遊戲工作階段範本，由多人遊戲服務處理服務品質 (QoS) 檢查

​將配對新增至遊戲工作階段，由遊戲管理的資料中心處理 QoS 檢查

​用戶端/伺服器遊戲工作階段的基本工作階段範本

​對等式網路的大廳或 SmartMatch 票證工作階段範本

​QoS 範本

​具有 QoS 的對等對主機遊戲工作階段範本

​具有 QoS 的點對點遊戲工作階段範本

​具有 QoS 的用戶端/伺服器大廳或配對工作階段範本

​XBOX One 與 Windows 10 之間跨平台遊玩的工作階段範本

關於工作階段範本

工作階段範本版本

工作階段範本預設值

工作階段範本範例

標準大廳工作階段

不含配對的標準遊戲工作階段

將配對新增至遊戲工作階段範本，由多人遊戲服務處理服務品質 (QoS) 檢查

將配對新增至遊戲工作階段，由遊戲管理的資料中心處理 QoS 檢查

用戶端/伺服器遊戲工作階段的基本工作階段範本

對等式網路的大廳或 SmartMatch 票證工作階段範本

QoS 範本

具有 QoS 的對等對主機遊戲工作階段範本

具有 QoS 的點對點遊戲工作階段範本

具有 QoS 的用戶端/伺服器大廳或配對工作階段範本

XBOX One 與 Windows 10 之間跨平台遊玩的工作階段範本