命名空间
Multiplayer Manager 包含在以下命名空间中。
你应该了解以下主要类。
Multiplayer Manager 类
Multiplayer Manager 是一个单例类,它包含一个大厅会话对象和一个游戏会话对象。 至少,你必须在此类上调用 XblMultiplayerManagerInitialize 和 XblMultiplayerManagerDoWork 方法,Multiplayer Manager 才能正常工作。 下表描述了一些(但不是全部)较常用的方法和属性。有关成员的完整、描述性列表,请参阅参考文档。Multiplayer Event 类
当你调用 XblMultiplayerManagerDoWork 时,Multiplayer Manager 返回一个事件列表,表示自你上次调用
XblMultiplayerManagerDoWork 以来会话的变更。这些事件包括诸如成员已加入会话、成员已离开会话、成员属性已更改或主机客户端已更改等变更。
有关所有可能的事件类型的列表,请参阅 XblMultiplayerEventType 枚举。
每个返回的 XblMultiplayerEvent 都包含一个 EventArgsHandle。你必须使用它来获取事件类型对应的 args。例如,如果 XblMultiplayerEventType 为 MemberJoined,则应调用 XblMultiplayerEventArgsMembersCount 和 XblMultiplayerEventArgsMembers。
在调用 XblMultiplayerManagerDoWork 后,你的游戏应根据需要处理每个事件。
Multiplayer Member 类
此类表示大厅或游戏会话中的玩家。它包含有关成员的属性,例如玩家的 XBOX 用户 ID、玩家的网络连接地址以及每个玩家的自定义属性。
Multiplayer Lobby Session 类
此类创建一个持久会话,用于管理此设备本地的用户以及想要一起游戏的受邀好友。大厅会话必须至少包含一个成员,Multiplayer Manager 才能执行任何多人游戏操作。你最初可以通过调用 XblMultiplayerManagerLobbySessionAddLocalUser 方法来创建新的大厅会话。
下表描述了此类中一些(但不是全部)较常用的方法和属性。有关类成员的完整、描述性列表,请参阅参考文档。
Multiplayer Game Session 类
游戏会话表示参与实际游戏实例的 XBOX 服务成员组。这可以包括通过匹配服务匹配到的玩家。
要启动包含来自大厅会话成员的新游戏会话,请调用 XblMultiplayerManagerJoinGameFromLobby。如果你想使用 XBOX 服务匹配,请调用 XblMultiplayerManagerFindMatch。如果你使用第三方匹配服务,请调用 XblMultiplayerManagerJoinGame。
下表描述了 Multiplayer Manager 中一些(但不是全部)较常用的方法和属性。有关类成员的完整、描述性列表,请参阅该类的 API 参考。