语法
成员
friendsFilter const PFLobbySearchFriendsFilter*may be nullptr 一个筛选器,当提供时,将把大厅搜索操作约束为仅搜索由该玩家各个好友列表的成员所拥有的大厅。 如果省略,搜索操作将搜索所有可用的大厅。
仅当使用 title_player_account 实体调用 PFMultiplayerFindLobbies 时,才能指定此值。
filterString const char*is null-terminated 用于筛选在搜索结果中返回哪些大厅的查询字符串。 此字符串采用类似 OData 的筛选语法。
仅支持以下运算符:“and”(逻辑与)、“eq”(等于)、“ne”(不等于)、“ge”(大于或等于)、“gt”(大于)、“le”(小于或等于)和 “lt”(小于)。
每个 OData 逻辑表达式的左侧应为搜索属性键(例如 string_key1、number_key3 等)或预定义的搜索键之一(
PFLobbyMemberCountSearchKey、PFLobbyAmMemberSearchKey 或 PFLobbyMembershipLockSearchKey)每个 OData 逻辑表达式的左侧应为搜索属性键。
此字符串不能超过 500 个字符。
示例:“lobby/membershipLock eq ‘Unlocked’ and string_key1 eq ‘CaptureTheFlag’ and number_key10 gt 50 and lobby/memberCount lt 5”
sortString const char*is null-terminated 用于对搜索结果中返回的大厅进行排序的查询字符串。 此字符串采用类似 OData 的 order-by 语法:以逗号分隔的搜索属性键列表,以及一个可选的升序或降序说明符。
若要指定升序,请在关联的搜索属性键后使用 “asc” 运算符。若要指定降序,请在关联的搜索属性键后使用 “desc” 运算符。
此外,还支持一个特殊的排序标识符 distance,用于按与某个数字值的最近距离进行排序。例如,“distance{number_key10=5} asc” 将对结果进行排序,使其 “number_key10” 搜索属性更接近值 “5” 的大厅在搜索结果中更早返回。
此字符串不能超过 100 个字符。
示例:“string_key1 asc,lobby/memberCount desc”
clientSearchResultCount const uint32_t*may be nullptr 一个可选值,当由 title_player_account 实体指定时,将限制完成响应中提供的结果数量。 仅当使用 title_player_account 实体调用 PFMultiplayerFindLobbies 时,才能指定此值。
此值不能高于
PFLobbyClientRequestedSearchResultCountUpperLimit。未指定时,搜索结果数量的限制由服务定义,但不会超过
PFLobbyClientRequestedSearchResultCountUpperLimit。
