구문
멤버
friendsFilter const PFLobbySearchFriendsFilter*nullptr일 수 있음 제공된 경우 로비 검색 작업을 해당 플레이어의 여러 친구 목록 멤버가 소유한 로비로만 제한하는 필터입니다. 생략되면 검색 작업은 사용 가능한 모든 로비를 검색합니다.
이 값은 PFMultiplayerFindLobbies를 title_player_account 엔터티로 호출할 때만 지정할 수 있습니다.
filterString const char*null로 종료됨 검색 결과에서 반환되는 로비를 필터링하는 데 사용되는 쿼리 문자열입니다. 이 문자열은 OData와 유사한 필터링 구문으로 형식이 지정됩니다.
다음 연산자만 지원됩니다. “and”(논리 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*null로 종료됨 검색 결과에서 반환된 로비를 정렬하는 데 사용되는 쿼리 문자열입니다. 이 문자열은 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*nullptr일 수 있음 title_player_account 엔터티에 의해 지정된 경우 완료 응답에서 제공되는 결과 수를 제한하는 선택적 값입니다. 이 값은 PFMultiplayerFindLobbies를 title_player_account 엔터티로 호출할 때만 지정할 수 있습니다.
이 값은
PFLobbyClientRequestedSearchResultCountUpperLimit보다 클 수 없습니다. 지정하지 않으면 검색 결과 수의 제한은 서비스에서 정의되지만
PFLobbyClientRequestedSearchResultCountUpperLimit보다 크지 않습니다.