PFLobbyCreateConfiguration
创建大厅时使用的初始配置数据。
语法
struct PFLobbyCreateConfiguration {
uint32_t maxMemberCount;
PFLobbyOwnerMigrationPolicy ownerMigrationPolicy;
PFLobbyAccessPolicy accessPolicy;
uint32_t searchPropertyCount;
const char* const* searchPropertyKeys;
const char* const* searchPropertyValues;
uint32_t lobbyPropertyCount;
const char* const* lobbyPropertyKeys;
const char* const* lobbyPropertyValues;
}
成员
maxMemberCount
uint32_t
新大厅中允许的最大成员数。
此值必须至少为 PFLobbyMaxMemberCountLowerLimit
且不超过 PFLobbyMaxMemberCountUpperLimit
。
如果客户端通过调用 PFMultiplayerJoinLobby() 或 PFLobbyAddMember 违反此限制,则操作将以异步方式失败。
ownerMigrationPolicy
PFLobbyOwnerMigrationPolicy
新大厅的所有者迁移策略。
传递给 PFMultiplayerCreateAndJoinLobby() 时,此值不能为 PFLobbyOwnerMigrationPolicy::Server
。 传递给 PFMultiplayerCreateAndClaimServerLobby() 时,此值必须为 PFLobbyOwnerMigrationPolicy::Server
。
accessPolicy
PFLobbyAccessPolicy
新大厅的访问策略。
searchPropertyCount
uint32_t
新大厅的初始搜索属性数。
searchPropertyKeys
const char* const*
数组大小searchPropertyCount
新大厅的初始搜索属性的键。
搜索属性对大厅的非成员可见为元数据,可用于筛选和排序大厅搜索结果。
搜索属性的格式必须为 string_keyN 或 number_keyN,其中 "N" 是介于 1 和 PFLobbyMaxSearchPropertyCount
之间的数字。 例如 string_key1、number_key14 等。
searchPropertyValues
const char* const*
数组大小searchPropertyCount
新大厅的初始搜索属性的值。
搜索属性对大厅的非成员可见为元数据,可用于筛选和排序大厅搜索结果。
lobbyPropertyCount
uint32_t
新大厅的初始大厅属性数。
lobbyPropertyKeys
const char* const*
数组大小lobbyPropertyCount
新大厅的初始大厅属性的键。
大厅属性仅对大厅的成员可见。
lobbyPropertyValues
const char* const*
数组大小lobbyPropertyCount
新大厅的初始大厅属性的值。
大厅属性仅对大厅的成员可见。
要求
标头: PFLobby.h