- 생산자 이벤트
- 이름
- 연산자
- 매개 변수
이벤트
각 통계 규칙은 타이틀에 의해 로깅되는 특정 이벤트 이름에 의해 트리거됩니다. 하나의 이벤트로 여러 통계 규칙이 트리거될 수 있다는 점에 유의하세요.이름 지정 요구 사항
- 규칙 이름에는 “루트” 이름이 있습니다. 뒤에 하나 이상의 “필드”가 선택적으로 붙습니다.
- 루트는 영숫자 문자열입니다. 최대 32자까지 가능합니다.
- 통계 인스턴스 이름의 총 길이는 128자를 초과할 수 없습니다.
- 이름은 반드시 문자로 시작해야 하며 문자, 숫자, 하이픈(-) 문자만 포함해야 합니다. 공백, 쉼표, 마침표, 밑줄 또는 기타 특수 문자는 허용되지 않습니다. 예시 이름은 “EnemiesDefeated”, “BestScoreUnder2Minutes”, “Total-Collectibles-Jewels” 등입니다.
- 필드는 점(.) 문자로 구분됩니다.
- 필드 이름은 생산자 이벤트의 일부인 필드 이름과 정확히 일치해야 합니다.
하나 이상의 필드가 통계 규칙 이름의 일부로 포함되면 이 규칙은 통계 템플릿이 됩니다. 런타임에 생산자 이벤트의 필드 실제 값이 통계 인스턴스 이름에 삽입됩니다.
- 유효한 템플릿 이름의 예로는 “EnemiesDefeated.WeaponID”, “BestScoreUnder2Minutes.TrackId.DifficultyID”, “Total-Collectibles-Jewels.Found”가 있습니다.
- 유효한 인스턴스 이름의 예로는 “EnemiesDefeated.WeaponID.17”, “BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane”, “Total-Collectibles-Jewels.Found.1”이 있습니다.
데이터 형식 권장 사항
- 통계 템플릿 이름의 일부인 이벤트 필드에는 정수 데이터 형식을 사용하는 것이 좋습니다.
-
이벤트 필드 데이터 형식이 부울인 경우 삽입되는 값은
true에 대해 “1”,false에 대해 “0”입니다. - 이벤트 필드 데이터 형식이 유니코드 문자열인 경우 해당 필드의 잠재적 값에 (앞서 설명한 대로) 유효한 문자만 포함되도록 해야 합니다.
연산자
통계 인스턴스의 값은 생산자 이벤트가 처리될 때 런타임에 계산됩니다. 통계 규칙은 지정된 매개 변수로 연산을 실행합니다. 지원되는 연산 옵션은 다음과 같습니다.SUMMAXMINREPLACE
매개 변수
매개 변수는 다음 표와 같이 상수 값이거나 생산 이벤트의 필드 이름일 수 있습니다.
결과 통계 인스턴스의 데이터 형식은 매개 변수의 데이터 형식에 의해 결정됩니다.
정수, 부동 소수점, 부울 데이터 형식은 모든 연산자에서 지원됩니다.
유니코드 문자열 데이터 형식은
REPLACE 연산자에서만 지원됩니다.
통계 및 매개 변수 데이터 형식은 다음 표에 나와 있습니다.
| 통계 데이터 형식 | 매개 변수 데이터 형식 | 참고 |
| --- | --- |
| 정수 | Int32, Int64, UInt32, UInt64, Boolean | 지원되는 가장 큰 정수 값은 56비트입니다. 부울은 TRUE에서 1로, FALSE에서 0으로 변환됩니다. |
| 부동 소수점 | Float, Double | 64비트 부동 소수점. |
| 문자열 | UnicodeString, GUID | 최대 문자열 길이는 50자입니다. |