Skip to main content
이 튜토리얼에서는 새로운 Statistic 서비스를 사용하여 기본 통계를 만드는 방법을 보여줍니다. 플레이어가 장거리 슛을 맞출 때마다 추적하려는 슈터 게임의 예로 시작해 보겠습니다.

통계 만들기

첫 번째 단계는 장거리 슛을 추적하는 주요 요소를 포함하는 통계 정의를 만드는 것입니다. 슈터 게임의 경우 장거리 슛의 거리에 대한 열 하나만 필요합니다. 다음 예제는 C# SDK를 사용하여 통계 정의를 만드는 방법을 보여줍니다.
이제 이 예제의 몇 가지 주요 요소를 설명하겠습니다.
  • AuthenticationContext: 이 매개 변수는 서비스에 대한 모든 요청 뒤에서 모든 인증을 처리합니다. 자세한 설명은 다음 페이지를 확인할 수 있습니다. 빠른 시작 통계.
  • Name: 이 매개 변수는 통계 정의를 식별하는 데 도움이 됩니다. 정보를 검색하기 위해 다른 요청을 만드는 데 사용되므로 여기에 관련성 있는 이름을 유지하는 것이 중요합니다.
  • EntityType: 이 매개 변수는 통계를 만들 엔터티 유형을 지정합니다. 자세한 내용은 여기에서 확인할 수 있습니다. Entity Programming Model.
  • VersionConfiguration: 이 매개 변수를 사용하면 일정 기간 후에 자체 재설정되는 통계에 대한 버전 관리 전략을 설정할 수 있습니다. 이 개념은 다음에서 자세히 다룹니다. 시즌별 통계.
  • Columns: 여기서는 통계의 열 수를 정의하며 정의당 최대 5개까지 가능합니다. 이 예제에서는 장거리 슛을 위한 하나의 열만 설정합니다. 또한 AggregationMethod를 Max로 정의하는데, 이는 새 값이 이전 값보다 더 클 때만 통계가 업데이트된다는 의미입니다.
    • AggregationMethod는 네 가지 가능한 값이 있습니다.
      • Max: 새 값이 이전 값보다 더 커야 합니다.
      • Min: 새 값이 이전 값보다 더 작아야 합니다.
      • Last: 항상 최신 값으로 업데이트됩니다.
      • Sum: 이전 값과 새 값이 더해집니다.
모든 정보가 명확해졌으니 이제 예제를 실행하고 첫 번째 통계를 만들 준비가 되었습니다.

통계 정의 가져오기

이 통계에 데이터를 추가하기 전에 올바르게 만들어졌는지 확인하고 싶습니다. 이 작업을 위해 통계 정의를 검색하는 방법에 대한 예제를 제공합니다.
통계 정의를 검색하려면 만든 통계의 이름을 지정합니다. 통계 정의가 여러 개 있는 경우 다음 예제를 사용하여 단일 요청으로 모든 통계 정의를 얻을 수 있습니다.

통계 정의 업데이트

통계 정의를 업데이트하려면 다음과 같이 수행할 수 있습니다.
업데이트의 일부로 Columns, EntityType 및 ResetInterval은 수정할 수 없습니다.

통계에 데이터 추가

슈터 예제를 계속 진행하면서 이제 통계 정의를 만들고, 검색하고, 필요한 경우 삭제하는 방법을 알게 되었습니다. 다음 단계는 통계에 데이터를 추가하기 시작하는 것입니다. 이러한 통계는 엔터티 기반 통계로, 항목이 엔터티임을 의미합니다. 특정 예제에서는 title_player_account 엔터티 유형을 사용하고 있으므로 통계가 플레이어의 정보를 추적합니다. 그러나 사용할 수 있는 다른 엔터티 유형도 있음을 기억하세요. 여기에서 확인할 수 있습니다. 사용 가능한 기본 제공 엔터티 유형. 이제 통계에 데이터를 추가하는 방법에 대해 알아보겠습니다.
이제 이 예제의 몇 가지 주요 요소를 설명하겠습니다.
  • Entity: 이 매개 변수는 통계를 업데이트할 엔터티에 해당합니다.
  • Statistics: 이 매개 변수는 엔터티의 실제 통계 집합에 해당합니다.
  • StatisticUpdate: 이 매개 변수는 추가할 통계 값에 해당합니다.
    • Scores: 이 매개 변수는 한 엔터티에 추가할 수 있는 점수 목록에 해당합니다. 기억하세요, 통계는 두 개 이상의 열을 가질 수 있습니다. 이러한 개념은 여기에서 자세히 확인할 수 있습니다. 통계로 더 많은 작업 수행
    • Name: 이 매개 변수는 통계 정의를 만들 때 설정한 통계 이름에 해당합니다.
이러한 개념이 명확해졌으니 이제 통계에 데이터를 추가할 준비가 되었습니다.

통계에서 데이터 검색

간단히 요약해 보겠습니다. 이 시점에서 통계를 만들고, 모든 구성 세부 정보를 확인하고, 데이터를 추가하기 시작했습니다. 이제 일부 플레이어가 이미 게임을 시작했고, 모두 인상적인 장거리 슛을 기록한다고 가정해 보겠습니다. 그 중 한 명에 대해 쿼리하려고 합니다. 다음 예제에서는 이 작업을 수행하는 방법을 보여줍니다.
여기서는 엔터티와 연관된 모든 통계를 쿼리한 다음 해당 값과 함께 이름을 인쇄합니다.

통계 값 삭제

통계가 예상대로 작동하고 있으며 게임에 많은 플레이어가 있습니다. 그러나 게임에서 몇 가지 비정상적인 동작이 눈에 띄기 시작합니다. 그래서 새롭게 시작하기로 결정하고 통계 데이터를 삭제합니다. 다음 예제에서는 통계에서 데이터를 삭제하는 방법을 볼 수 있습니다.
이제 이 예제의 몇 가지 주요 요소를 설명하겠습니다.
  • Entity: 이 매개 변수는 삭제할 엔터티입니다.
  • List<StatisticDelete>: 이 매개 변수는 삭제할 통계의 이름 목록입니다.

결론

이 튜토리얼에서는 다음 작업을 수행하는 방법을 배웠습니다.
  • 통계 만들기
  • 통계 구성 확인
  • 통계 구성 업데이트
  • 통계 구성 삭제
  • 통계 채우기
  • 통계의 항목 삭제.

참고 항목

마지막 수정일 2026년 8월 25일