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

# 플레이어 사용자 지정 속성

> PlayFab 플레이어 사용자 지정 속성 개요: title_player_account 엔터티에 문자열, 숫자, 부울 또는 날짜/시간 데이터를 저장하는 키-값 쌍과 그 제한 사항.

<Note>
  플레이어 사용자 지정 속성 기능은 공개 미리 보기 상태입니다. 핵심 기능은 이미 갖추어져 있지만, 피드백과 사용 패턴을 바탕으로 사용자 환경을 계속 다듬어 나가고 있습니다.
</Note>

사용자 지정 속성은 플레이어에 대한 추가 정보를 저장하는 키-값 데이터 쌍입니다. 이러한 데이터 쌍의 형식은 문자열, 숫자, 부울 또는 날짜/시간이 될 수 있습니다.

사용자 지정 속성과 그 값은 표시 이름, 통계, 태그와 같은 다른 플레이어 정보와 함께 저장됩니다.

<Note>
  사용자 지정 속성은 title\_player\_account 엔터티에서만 지원됩니다.
</Note>

## 사용자 지정 속성 구성

사용자 지정 속성은 다양한 방법으로 설정할 수 있습니다:

* 플레이어의 속성을 업데이트하는 **UpdatePlayerCustomProperties** 작업을 사용합니다.
* **DeletePlayerCustomProperties** 작업을 사용하여 사용자 지정 속성을 제거할 수도 있습니다.
* 또한 게임 관리자 UI를 통해 개별 플레이어의 속성을 수정할 수도 있습니다.

## 제한 사항

사용자 지정 속성에 대한 몇 가지 제한 사항은 다음과 같습니다:

* 속성 이름은 문자열 형식이어야 하며 최대 길이는 36자입니다.
* 속성 이름은 대/소문자를 구분하므로, 예를 들어 prop과 PROP은 서로 다른 이름입니다.
* 문자열 값의 최대 길이는 36자입니다.
* 지원되는 숫자 값은 배정밀도 부동 소수점(IEEE 754 표준)입니다.
* 날짜/시간 문자열 값은 ISO 8601 형식을 사용해야 하며 모든 비교는 UTC를 기준으로 수행됩니다.
* 플레이어당 최대 5개의 고유 사용자 지정 속성만 가질 수 있습니다(각 플레이어가 정확히 동일한 5개의 속성 이름을 가질 필요는 없습니다).

## 이점

사용자 지정 속성은 강력하며, 코드 없이 개발할 수 있게 해 주어 동일한 플레이어와 관련된 여러 기존 PlayStream 이벤트를 연관 지음으로써 이벤트 전반에 걸친 상태를 추적할 수 있게 해 줍니다.
