Skip to main content
로비의 공유 부분에 대한 업데이트 요청입니다.

구문

멤버

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를 제공합니다.
restrictInvitesToLobbyOwner   const bool*
nullptr일 수 있음
로비 소유자만 로비 참여 초대를 보낼 수 있는지에 대한 정책에 대한 선택적 업데이트입니다. true인 경우 로비 소유자만 초대를 보낼 수 있습니다. false인 경우 모든 멤버가 초대를 보낼 수 있습니다. 클라이언트 소유 로비에서만 true일 수 있습니다.

설명

로비의 공유 부분에 있는 대부분의 데이터는 소유자만 업데이트할 수 있습니다. 각 필드의 설명서를 확인하여 확인합니다.

요구 사항

헤더: PFLobby.h

참고 항목

PFLobby 멤버
마지막 수정일 2026년 8월 13일