PFLobbySearchConfiguration
PFMultiplayerFindLobbies 작업을 수행하는 방법을 지정하는 데 사용되는 구성 구조입니다.
구문
struct PFLobbySearchConfiguration {
const PFLobbySearchFriendsFilter* friendsFilter;
const char* filterString;
const char* sortString;
const uint32_t* clientSearchResultCount;
}
멤버
friendsFilter const PFLobbySearchFriendsFilter*
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' 및 string_key1 eq 'CaptureTheFlag' 및 number_key10 gt 50 및 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*
nullptr일 수 있음
title_player_account 엔터티로 지정된 경우 완료 응답에 제공되는 결과 수를 제한하는 선택적 값입니다.
이 값은 title_player_account 엔터티를 사용하여 PFMultiplayerFindLobbies를 호출하는 경우에만 지정할 수 있습니다.
이 값은 PFLobbyClientRequestedSearchResultCountUpperLimit보다 높을 수 없습니다.
지정하지 않으면 검색 결과 수에 대한 제한이 서비스 정의에 따르지만, PFLobbyClientRequestedSearchResultCountUpperLimit보다 크지는 않습니다.
요구 사항
헤더: PLobby.h