다음을 통해 공유

플레이어 사용자 지정 속성

  • 아티클

참고 항목

플레이어 사용자 지정 속성 기능은 프라이빗 미리 보기로 제공됩니다. Microsoft는 계속해서 피드백을 수집하고 고객 사용을 최적화함에 따라 지속적인 변경이 있을 것으로 예상합니다.

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

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

참고 항목

사용자 지정 속성은 title_player_account 엔터티에서만 지원됩니다.

사용자 지정 속성 구성

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

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

제한

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

  • 속성 이름은 문자열 형식이어야 하며 최대 길이는 24자여야 합니다.
  • 속성 이름은 대/소문자를 구분하므로 예를 들어 prop 및 PROP은 서로 다른 이름입니다.
  • 문자열 값의 최대 길이는 32자입니다.
  • 지원되는 숫자 값은 이중 부동 소수점(IEEE 754 표준)입니다.
  • 날짜/시간 문자열 값은 ISO 8601 형식을 사용해야 하며 모든 비교는 UTC와 관련하여 수행됩니다.
  • 플레이어당 고유한 사용자 지정 속성은 10개만 있을 수 있습니다(각 플레이어의 속성 이름이 정확히 동일한 10개일 필요는 없음).

장점

사용자 지정 속성은 강력하며, 여러 기존 PlayStream 이벤트를 상호 연결하는 코드 없는 개발을 수행할 수 있으므로 동일한 플레이어와 관련된 이벤트 간에 상태를 추적할 수 있습니다.