跳轉到主要內容
本主題說明多人遊戲管理員 API 中最重要的方法。 如需詳細的 API 資訊,請參閱參考文件。 如需如何在應用程式中使用這些 API 的範例,請參閱 NetRumble 範例 (NDA 主題)。

命名空間

多人遊戲管理員包含在下列命名空間中。 您應該了解下列主要類別。

Multiplayer Manager 類別

多人遊戲管理員是一個單一執行個體類別,包含單一大廳工作階段物件和單一遊戲工作階段物件。 為了讓多人遊戲管理員正常運作,您至少必須在此類別上呼叫 XblMultiplayerManagerInitialize 和 XblMultiplayerManagerDoWork 方法。 下表說明部分 (而非全部) 較常用的方法和屬性。如需完整的成員描述清單,請參閱參考文件。

Multiplayer Event 類別

當您呼叫 XblMultiplayerManagerDoWork 時,多人遊戲管理員會傳回事件清單,代表自您上次呼叫 XblMultiplayerManagerDoWork 以來工作階段的變更。這些事件包括成員已加入工作階段、成員已離開工作階段、成員屬性已變更,或主機用戶端已變更等變更。 如需所有可能事件類型的清單,請參閱 XblMultiplayerEventType 列舉。 每個傳回的 XblMultiplayerEvent 都包含一個 EventArgsHandle。您必須使用它來取得事件類型的適當 args。例如,如果 XblMultiplayerEventType 是 MemberJoined,您會呼叫 XblMultiplayerEventArgsMembersCount 和 XblMultiplayerEventArgsMembers。 在呼叫 XblMultiplayerManagerDoWork 之後,您的遊戲應視需要處理每個事件。

Multiplayer Member 類別

此類別代表大廳或遊戲工作階段中的玩家。它包含成員的相關屬性,例如玩家的 XBOX 使用者識別碼、玩家的網路連線位址,以及每位玩家的自訂屬性。

Multiplayer Lobby Session 類別

此類別會建立持續性工作階段,用於管理此裝置上的本機使用者,以及想要一起玩的受邀好友。大廳工作階段必須至少包含一位成員,多人遊戲管理員才能執行任何多人遊戲動作。您一開始可以呼叫 XblMultiplayerManagerLobbySessionAddLocalUser 方法來建立新的大廳工作階段。 下表說明此類別部分 (而非全部) 較常用的方法和屬性。如需完整的類別成員描述清單,請參閱參考文件。

Multiplayer Game Session 類別

遊戲工作階段代表參與實際遊戲執行個體的 XBOX 服務成員群組。這可能包括透過配對服務配對的玩家。 若要開始包含大廳工作階段成員的新遊戲工作階段,請呼叫 XblMultiplayerManagerJoinGameFromLobby。如果您想要使用 XBOX 服務配對,請呼叫 XblMultiplayerManagerFindMatch。如果您使用的是協力廠商配對服務,請呼叫 XblMultiplayerManagerJoinGame。 下表說明多人遊戲管理員部分 (而非全部) 較常用的方法和屬性。如需完整的類別成員描述清單,請參閱此類別的 API 參考資料。
最後修改於 2026年10月8日