多人遊戲工作階段目錄概觀

• MPSD 工作階段
• MPSD 變更通知處理與中斷連線偵測
• MPSD 工作階段控制代碼
• 工作階段更新的同步處理
• 呼叫 MPSD
• Multiplayer Session Explorer

​

MPSD 工作階段

• 由遊戲建立與管理。
• 具有唯一的 URI。如需詳細資訊，請參閱 Session Directory URI。
• 可讓使用者 (稱為工作階段成員) 之間建立連線。
• 儲存支援遊戲進行的資料，例如每個成員的屬性、遊戲設定、啟動程序資訊以及遊戲伺服器資訊。

​

MPSD 變更通知處理與中斷連線偵測

• 根據遊戲起始的事件訂閱，在工作階段發生變更時傳送簡短通知 (肩拍通知)。
• 偵測使用者中斷連線。
• 根據中斷連線偵測，將使用者設為非作用中，然後將其從工作階段中移除。

​

建立使用者連線

1. 遊戲呼叫 XblMultiplayerSetSubscriptionsEnabled。此方法會告知 XSAPI 用戶端打算將 RTA 連線用於多人遊戲用途。
2. 當遊戲在目前使用者設為作用中狀態的情況下，第一次呼叫 XblMultiplayerWriteSessionAsync 或 XblMultiplayerWriteSessionByHandleAsync 時，就會建立連線並連接至 MPSD。

​

訂閱工作階段變更

​

處理肩拍通知

​

處理連線狀態變更通知

• XblMultiplayerSessionSubscriptionLostHandler 處理常式 - 當遊戲透過 RTA 服務與 MPSD 的連線中斷時引發。發生此事件時，遊戲應該關閉多人遊戲。
• XblRealTimeActivityConnectionStateChangeHandler 處理常式 - 當遊戲與 RTA 服務之連線的健康狀態發生暫時性變更時引發。遊戲收到此事件時不需要採取任何動作，但此事件可能有助於診斷用途。

​

中斷用戶端連線

​

中斷連線偵測

​

處理 RTA 重新連線

void* context{ nullptr };
XblFunctionContext connectionIdChangedFunctionContext = XblMultiplayerAddConnectionIdChangedHandler(
    xblContextHandle,
    [](void* context) {
        XblMultiplayerSessionHandle sessionHandle; // Retrieve the MPSD session to update
        XblMultiplayerSessionCurrentUserSetStatus(sessionHandle, XblMultiplayerSessionMemberStatus::Active);

        auto asyncBlock = std::make_unique<XAsyncBlock>();
        asyncBlock->queue = queue;
        asyncBlock->context = nullptr;
        asyncBlock->callback = [](XAsyncBlock* asyncBlock)
        {
            std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };

            XblMultiplayerSessionHandle sessionHandle;
            HRESULT hr = XblMultiplayerWriteSessionResult(asyncBlock, &sessionHandle);
            if (SUCCEEDED(hr))
            {
                // If the write call succeeds, the connection ID has been updated and no further action is needed.
            }
            else
            {
                // If the write call fails, it's likely that the user has been removed from the session.
            }
        };

        auto hr = XblMultiplayerWriteSessionAsync(xblContextHandle, sessionHandle, XblMultiplayerSessionWriteMode::UpdateExisting, asyncBlock.get());
        if (SUCCEEDED(hr))
        {
            asyncBlock.release();
        }
    }, 
    context);

​

MPSD 工作階段控制代碼

​

控制代碼類型

​

邀請控制代碼

​

建立邀請控制代碼

​

建立活動控制代碼

​

使用控制代碼

1. 從遊戲啟用參數取得控制代碼識別碼。
2. 建立本機 MPSD 工作階段物件，然後以作用中身分加入。
3. 寫入工作階段，並傳入適當的控制代碼。

​

工作階段更新的同步處理

• 由仲裁者更新工作階段的共用部分。如果您的實作只涉及單一仲裁者，大部分的寫入作業都可以避免使用同步處理更新。在下列情況下，遊戲可以避免同步處理。
  • 仲裁者對工作階段共用部分所做的任何更新，除非這些更新與傳達仲裁者的身分識別有關
  • 遊戲對工作階段內成員區域所做的任何更新

  [!NOTE] 雖然前述的更新類型不需要同步處理，但對 XblMultiplayerSessionProperties::HostDeviceToken 屬性的任何更新仍必須進行同步處理。 此屬性用於傳達仲裁者的身分識別，例如作為仲裁者移轉的一部分。

• 所有用戶端都會更新工作階段的共用部分。在此情況下，對工作階段共用部分的所有更新都必須同步處理。不過，遊戲仍然可以在不同步處理的情況下寫入自己的成員區域。

​

使用多人遊戲 API 更新工作階段同步處理

• XblMultiplayerWriteSessionAsync
• XblMultiplayerWriteSessionByHandleAsync

​

使用多人遊戲 REST API 更新工作階段同步處理

​

呼叫 MPSD

• 建議您使用多人遊戲 API，其中包含作為 RESTful 功能包裝函式的類別。如需詳細資訊，請參閱 XblMultiplayer 首碼函式。若要進行 SmartMatch 配對，請使用以 XblMatchmaking 首碼函式表示的配對 API。
• 直接使用標準 HTTP 呼叫 XBOX 服務 RESTful 參考中所包含的多人遊戲與配對 REST API。適用的 URI 說明於 Session Directory URI (適用於多人遊戲) 與 Matchmaking URI (適用於配對) 章節中。相關的 JSON 物件說明於 JavaScript Object Notation (JSON) 物件參考章節中。

​

使用多人遊戲 API 呼叫 MPSD

​

使用多人遊戲 REST API 與 MPSD 互動

​

查詢工作階段與工作階段範本 (REST)

​

查詢基本工作階段資訊

​

查詢工作階段範本

• /serviceconfigs//sessiontemplates
• /serviceconfigs//sessiontemplates/

​

查詢工作階段狀態

• /serviceconfigs//sessions
• /serviceconfigs//sessiontemplates//sessions

​

Multiplayer Session Explorer

​

存取 Multiplayer Session Explorer

​

開啟主頁面

1. 開啟工具的主頁面。它會顯示安全性內容 (登入的使用者與沙箱) 以及沙箱中的 SCID 清單。
2. 按下 功能表 按鈕，將此頁面釘選到首頁，這樣就不必重新輸入 URI。

​

顯示可用的工作階段與範本

1. 在工具中選取 SCID，以顯示該 SCID 中包含登入使用者為成員的工作階段清單。
2. 在同一頁面上，您可以選取 SCID，並顯示該 SCID 服務設定中的工作階段範本與當地語系化字串。這些項目是透過 Partner Center 擷取的。

​

顯示工作階段的完整內容

• GET 呼叫可能在 X-Xbl-Contract-Version 標頭中使用較舊的合約版本。Multiplayer Session Explorer 一律使用最新的合約版本顯示工作階段。
• 當透過 GET 正常要求工作階段時，可能會觸發轉換與副作用，例如逾時到期。Multiplayer Session Explorer 會顯示工作階段儲存時的快照，而不會執行任何邏輯、轉換或副作用。
• MPSD 工作階段上不會出現 nextTimer JSON 物件欄位，因為它是與副作用同時計算的。

​

另請參閱

• 「多人遊戲工作階段進階主題」主題中的工作階段概觀一節
• 多人遊戲工作階段狀態碼
• 「多人遊戲工作」主題中的更新 MPSD 工作階段一節
• 「多人遊戲工作」主題中的從遊戲啟用加入 MPSD 工作階段一節
• 「多人遊戲工作」主題中的訂閱 MPSD 工作階段變更通知一節
• 配對概觀