PFLobbyDataUpdate
로비의 공유 부분에 대한 업데이트 요청입니다.
구문
struct PFLobbyDataUpdate {
const PFEntityKey* newOwner;
const uint32_t* maxMemberCount;
const PFLobbyAccessPolicy* accessPolicy;
const PFLobbyMembershipLock* membershipLock;
uint32_t searchPropertyCount;
const char* const* searchPropertyKeys;
const char* const* searchPropertyValues;
uint32_t lobbyPropertyCount;
const char* const* lobbyPropertyKeys;
const char* const* lobbyPropertyValues;
}
멤버
newOwner const PFEntityKey*
nullptr일 수 있음
로비의 선택적 새 소유자입니다.
이 값을 업데이트하려면 다음 조건 중 하나에 해당해야 합니다.
- 이 필드를 업데이트하는 멤버가 로비의 현재 소유자입니다.
- 소유자 마이그레이션 정책이
PFLobbyOwnerMigrationPolicy::Manual이며 현재 소유자가 없습니다. - 소유자 마이그레이션 정책이
PFLobbyOwnerMigrationPolicy::None입니다.
이 로비가 클라이언트 소유(현재 소유자가 title_player_account 엔터티)인 경우 새 소유자도 title_player_account 엔터티여야 합니다. 이 로비가 서버 소유(현재 소유자가 game_server 엔터티)인 경우 새 소유자도 game_server 엔터티여야 합니다.
maxMemberCount const uint32_t*
nullptr일 수 있음
이 로비의 구성원 수에 대해 선택적으로 업데이트된 용량입니다.
이 새 값은 현재 로비에 있는 멤버 수보다 크고 PFLobbyMaxMemberCountUpperLimit보다 작아야 합니다.
이 값은 현재 로비 소유자만 업데이트할 수 있습니다.
accessPolicy const PFLobbyAccessPolicy*
nullptr일 수 있음
이 로비에 대해 선택적으로 업데이트된 액세스 정책입니다.
이 값은 현재 로비 소유자만 업데이트할 수 있습니다.
membershipLock const PFLobbyMembershipLock*
nullptr일 수 있음
이 로비의 멤버 자격 잠금에 대한 선택적 업데이트입니다.
이 값은 현재 로비 소유자만 업데이트할 수 있습니다.
searchPropertyCount uint32_t
업데이트할 검색 속성의 수입니다.
현재 로비 소유자만 검색 속성을 업데이트할 수 있습니다.
주어진 시간에 PFLobbyMaxSearchPropertyCount개의 동시 검색 속성만 있을 수 있습니다. 따라서 해당 속성의 절반이 삭제되는 경우 이 업데이트에서 최대 두 배의 고유 속성을 지정할 수 있습니다.
속성 제한을 위반하면 전체 업데이트 작업이 실패합니다.
searchPropertyKeys const char* const*
크기 배열 searchPropertyCount
업데이트할 검색 속성의 키입니다.
현재 로비 소유자만 로비 속성을 업데이트할 수 있습니다.
검색 속성은 로비 검색 결과를 필터링하고 정렬하는 데 사용할 수 있는 메타데이터로 로비의 비멤버에게 표시됩니다.
이 키 목록에 지정된 속성만 업데이트됩니다. 키가 아직 없으면 속성이 만들어집니다. 새 속성 값이 nullptr이면 속성이 삭제됩니다. 이 목록에서 생략된 기존 속성은 수정되지 않은 상태로 남아 있습니다.
검색 속성은 string_keyN 또는 number_keyN 형식이어야 합니다. 여기서 "N"은 1과 PFLobbyMaxSearchPropertyCount 사이의 숫자입니다. string_key1, number_key14 등과 같은 예가 있을 수 있습니다.
searchPropertyValues const char* const*
크기 배열 searchPropertyCount
업데이트할 검색 속성의 값입니다.
현재 로비 소유자만 검색 속성을 업데이트할 수 있습니다.
검색 속성은 로비 검색 결과를 필터링하고 정렬하는 데 사용할 수 있는 메타데이터로 로비의 비멤버에게 표시됩니다.
값을 삭제하려면 nullptr을 새 값으로 제공합니다.
lobbyPropertyCount uint32_t
업데이트할 로비 속성의 수입니다.
현재 로비 소유자만 로비 속성을 업데이트할 수 있습니다.
주어진 시간에 PFLobbyMaxLobbyPropertyCount개의 동시 로비 속성만 있을 수 있습니다. 따라서 해당 속성의 절반이 삭제되는 경우 이 업데이트에서 최대 두 배의 고유 속성을 지정할 수 있습니다.
속성 제한을 위반하면 전체 업데이트 작업이 실패합니다.
lobbyPropertyKeys const char* const*
크기 배열 lobbyPropertyCount
업데이트할 로비 속성의 키입니다.
현재 로비 소유자만 로비 속성을 업데이트할 수 있습니다.
로비 속성은 로비 구성원들만 볼 수 있습니다.
이 키 목록에 지정된 속성만 업데이트됩니다. 키가 아직 없으면 속성이 만들어집니다. 새 속성 값이 nullptr이면 속성이 삭제됩니다. 이 목록에서 생략된 기존 속성은 수정되지 않은 상태로 남아 있습니다.
lobbyPropertyValues const char* const*
크기 배열 lobbyPropertyCount
업데이트할 로비 속성의 값입니다.
현재 로비 소유자만 로비 속성을 업데이트할 수 있습니다.
로비 속성은 로비 구성원들만 볼 수 있습니다.
값을 삭제하려면 nullptr을 새 값으로 제공합니다.
설명
로비의 공유 부분에 해당하는 대부분의 데이터는 소유자만 업데이트할 수 있습니다. 각 필드의 설명서에서 확인을 표시합니다.
요구 사항
헤더: PLobby.h