Skip to main content
本文介绍如何创建大厅。

大厅是如何创建的?

有多种方式可以创建大厅。
  • 由你的玩家创建:大厅可以由想要组队一起玩的玩家创建。这些是客户端所拥有的大厅。
  • 由你的游戏服务器创建:你的游戏服务器可以创建大厅并等待玩家加入。这些是服务器所拥有的大厅。
  • 通过匹配创建:一组玩家经过匹配后,创建一个大厅作为游戏开始之前的容纳场所。这些是客户端所拥有的大厅。
从技术角度看,所有大厅根据所有权分为两大类—服务器所拥有和客户端所拥有。若要了解更多,请参阅所有者要求与特权 PlayFab 大厅的一般用法是暂时将一组玩家聚集在一起。有关 Lobby 的常用应用,请参阅 PlayFab Lobby 概览

支持的实体类型

在创建大厅之前,你的游戏必须以 PlayFab 实体身份登录。
  • 代表玩家创建客户端所拥有的大厅时,请以 title_player_account 实体身份登录。有关更多信息,请参阅登录基础与最佳实践
  • 代表游戏服务器创建服务器所拥有的大厅时,请以 game_server 实体身份登录。有关更多信息,请参阅 AuthenticateGameServerWithCustomId

大厅的配置方式

大厅的几项重要设置是在创建时配置的:maxMemberCountaccessPolicyownerownerMigrationPolicy
  • maxMemberCount 定义大厅可容纳的玩家数量
  • accessPolicy 定义谁可以发现大厅的连接字符串
  • owner 定义大厅所有者,该所有者拥有更新大厅数据的特殊权限。此值隐式为创建大厅的客户端或服务器实体。
  • ownerMigrationPolicy 定义在当前所有者离开大厅或与大厅保持连接出现问题时,如何转移大厅所有权的策略。
此外,在创建期间,大厅创建者还可以定义自定义大厅属性和搜索属性,以便向大厅会话附加自定义数据。这些自定义属性也可以在大厅生命周期内由大厅所有者修改。 有关更多信息,请参阅大厅属性

使用 Lobby 和 Matchmaking SDK 创建客户端所拥有大厅的示例

此示例使用一名已作为 title_player_account 实体登录到 PlayFab 的本地玩家。 在此代码片段中,大厅属性以 lobbyConfiguration 传入,创建大厅的玩家通过 creatorMemberConfiguration 传入其初始成员属性。本地玩家成为大厅所有者,因此这是一个客户端所拥有的大厅。大厅成功创建后,可以使用 PFLobbyHandle 通过 PFLobbySendInvite 邀请其他玩家。
创建大厅的调用完成时,PFMultiplayerStartProcessingLobbyStateChanges 将提供一个 PFLobbyCreateAndJoinLobbyCompletedStateChange

使用 Lobby 和 Matchmaking SDK 创建服务器所拥有大厅的示例

此示例类似于客户端所拥有大厅的示例,不同之处在于它以 game_server 实体身份创建大厅,并调用 PFMultiplayerCreateAndClaimServerLobby 而不是 PFMultiplayerCreateAndJoinLobby
创建大厅的调用完成时,PFMultiplayerStartProcessingLobbyStateChanges 将提供一个 PFLobbyCreateAndClaimServerLobbyCompletedStateChange 有关客户端所拥有大厅与服务器所拥有大厅之间差异的更多信息,请参阅游戏服务器与大厅
若要在 PlayFab Multiplayer 中启用游戏服务器 API,你必须在包含 PFLobby.h 之前定义 PFMULTIPLAYER_INCLUDE_SERVER_APIS。有关更多信息,请参阅游戏服务器与大厅

另请参阅

最后修改于 2026年8月13日