XGameEventWrite
"dimensions" 및 "measurement" 데이터 필드를 선택적으로 포함하는 게임 내 이벤트를 기록합니다.
구문
HRESULT XGameEventWrite(
XUserHandle user,
const char *serviceConfigId,
const char *playSessionId,
const char* eventName,
const char* dimensionsJson,
const char* measurementsJson
)
매개 변수
user _In_
형식: XUserHandle
대신하여 이벤트를 보낼 사용자 핸들입니다.
*serviceConfigId _In_z_
형식: char
이 타이틀에 대한 Xbox Live 서비스 구성 ID(SCID)입니다.
*playSessionId _In_z_
형식: char
플레이 세션 ID입니다. 단일 플레이 세션에서 전송된 이벤트 집합을 추적하도록 각 게임 세션 시작 시 게임에서 생성되는 고유한 GUID입니다.
eventName _In_z_
형식: char*
이벤트 이름입니다.
dimensionsJson _In_opt_z_
형식: char*
JSON 형식의 차원 데이터 필드입니다.
measurementsJson _In_opt_z_
형식: char*
JSON 형식의 측정 데이터 필드입니다.
반환 값
형식: HRESULT
성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
차원에는 정의된 유한 개수의 숫자 또는 문자열 값이 있는 이벤트 필드가 포함됩니다. 차원 예: 맵 ID, 난이도 수준, 캐릭터 또는 무기 클래스, 게임 모드, 부울 설정 등. 측정에는 스칼라 숫자 메트릭을 나타내는 이벤트 필드가 포함됩니다. 측정 예: 점수, 시간, 카운터, 위치 등. 예: 특정 난이도 수준의 최고 일치 점수를 추적하는 게임 내 이벤트의 경우: 난이도 수준이 차원에 포함되어야 하며, 점수는 측정에 포함되어야 합니다. 이벤트 이름과 이벤트 필드의 이름(차원 및 측정 모두)은 모두 타이틀의 서비스 구성에 선언된 이름과 일치해야 합니다. 이름은 대/소문자를 구분하지 않습니다. API가 서비스 구성의 이름과 일치하지 않는 이름으로 이벤트를 기록할 경우 서비스가 알림 없이 이벤트를 삭제합니다.
요건
헤더: XGameEvent.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔