Skip to main content
플레이어 사용자 지정 속성 기능은 공개 미리 보기 상태입니다. 핵심 기능은 이미 갖추어져 있지만, 피드백과 사용 패턴을 바탕으로 사용자 환경을 계속 다듬어 나가고 있습니다.
사용자 지정 속성은 플레이어에 대한 추가 정보를 저장하는 키-값 데이터 쌍입니다. 이러한 데이터 쌍의 형식은 문자열, 숫자, 부울 또는 날짜/시간이 될 수 있습니다. 사용자 지정 속성과 그 값은 표시 이름, 통계, 태그와 같은 다른 플레이어 정보와 함께 저장됩니다.
사용자 지정 속성은 title_player_account 엔터티에서만 지원됩니다.

사용자 지정 속성 구성

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

제한 사항

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

이점

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