> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Lobby 사용자 지정 속성

> PlayFab Lobby 사용자 지정 속성을 사용하여 로비 수준 및 멤버 수준의 상태를 저장하고, 표시 여부를 제어하며, 로비 검색을 위한 검색 가능한 속성을 노출합니다.

# 로비 속성

이 문서에서는 로비에 저장되는 사용자 지정 속성에 대해 설명합니다. 이 기능을 사용하여 로비가 나타내는 게임 세션에 대한 메타데이터를 저장합니다.

## 미리 정의된 속성

각 로비에는 대부분의 게임 시나리오에 일반적으로 필요한 미리 정의된 속성 집합이 있습니다.

| 속성 | 정의 |
| - | - |
| lobbyId | 로비의 고유 식별자입니다. 플레이어가 참여할 수 있는 여러 로비를 구별하는 데 사용할 수 있습니다. |
| connectionString | 로비에 참여하는 데 사용되는 식별자입니다. Lobby 서비스에서 제공합니다. 다른 플레이어에게 초대장이 전송될 때 **connectionString** 이 초대장으로 전송됩니다. |
| maxMemberCount | 로비에 허용되는 최대 플레이어 수입니다. 이 속성은 소유자만 변경할 수 있습니다. |
| owner | 로비를 소유하는 엔터티입니다. 일부 로비는 특정 상황에서 일시적으로 소유자가 없을 수 있습니다. 자세한 내용은 [Ownership changes](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/ownership-changes.md)를 참조하세요. |
| ownerMigrationPolicy | 새 소유자가 선택되는 방식을 결정하는 정책입니다. 자세한 내용은 [Ownership changes](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/ownership-changes.md)를 참조하세요. |
| accessPolicy | 누가 로비의 연결 문자열을 검색할 수 있는지 나타내는 정책입니다. 이 속성은 소유자만 변경할 수 있습니다. |
| membershipLock | 새 멤버가 로비에 참여할 수 있는지 여부를 나타내는 값입니다. **Locked** 상태에서는 새 멤버가 참여할 수 없습니다. **Unlocked** 상태에서는 새 멤버가 참여할 수 있습니다. 이 속성은 소유자만 변경할 수 있습니다. |
| RestrictInvitesToLobbyOwner | 로비 소유자만 로비 참여 초대를 보낼 수 있는지 여부를 제어하는 설정입니다. true인 경우 로비 소유자만 초대를 보낼 수 있습니다. false 또는 지정되지 않은 경우 모든 멤버가 초대를 보낼 수 있습니다. 지정되지 않은 경우 기본값은 false입니다. 클라이언트 소유 로비로 제한됩니다. |

## 사용자 지정 속성

타이틀이 정의할 수 있는 사용자 지정 속성에는 세 가지 유형이 있습니다.

1. 사용자 지정 로비 속성
   * 이 속성은 전체 로비에 적용됩니다.
   * 로비의 멤버만 이 속성을 볼 수 있습니다.
   * 로비의 소유자만 이 속성을 변경할 수 있습니다.
2. 사용자 지정 멤버 속성
   * 로비의 각 멤버마다 고유한 멤버 속성 맵이 있습니다.
   * 로비의 멤버만 이 속성을 볼 수 있습니다.
   * 로비의 모든 멤버는 다른 모든 멤버의 속성을 볼 수 있습니다.
   * 각 멤버는 자신의 멤버 속성을 수정할 수 있지만 다른 멤버의 속성은 수정할 수 없습니다.
   * 멤버가 로비를 떠나면 해당 멤버의 속성은 로비에서 삭제됩니다.
3. 사용자 지정 검색 속성.
   * 이는 타이틀의 모든 플레이어가 특정 기준과 일치하는 로비를 검색하는 데 사용할 수 있는 특수 속성입니다.
   * 이 속성은 전체 로비에 적용됩니다.
   * 로비의 소유자만 이 속성을 변경할 수 있습니다.
   * 이러한 속성에 사용할 수 있는 키에는 제한이 있습니다.
   * 자세한 내용은 [Create searchable lobbies](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/define-search-keywords.md)를 참조하세요.

모든 속성은 키-값 쌍의 맵입니다.

## 함께 보기

* [Create a lobby](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/create-a-lobby.md)
* [Owner requirements and privileges](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)
* [Lobby and matchmaking](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
* [Find lobbies](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/find-lobbies.md)
* [Create searchable lobbies](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/define-search-keywords.md)


## Related topics

- [플레이어 사용자 지정 속성 빠른 시작](https://docs.xbox.com/ko/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [플레이어 사용자 지정 속성](https://docs.xbox.com/ko/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [플레이어 사용자 지정 속성 나열](https://docs.xbox.com/ko/services/playfab/api-references/rest/server/player-data-management/list-player-custom-properties.md)
- [플레이어 사용자 지정 속성 삭제](https://docs.xbox.com/ko/services/playfab/api-references/rest/admin/player-data-management/delete-player-custom-properties.md)
- [플레이어 사용자 지정 속성 가져오기](https://docs.xbox.com/ko/services/playfab/api-references/rest/admin/player-data-management/get-player-custom-property.md)