Skip to main content

​
XGameEventWrite

선택적으로 “dimensions” 및 “measurement” 데이터 필드를 포함하는 게임 내 이벤트를 씁니다.

​
구문

​
매개 변수

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 형식의 dimensions 데이터 필드입니다. measurementsJson   _In_opt_z_
형식: char* JSON 형식의 measurement 데이터 필드입니다.

​
반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.

​
설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
Dimensions에는 유한한 수의 정의된 숫자 또는 문자열 값을 가진 이벤트 필드가 포함됩니다. dimensions의 예: 맵 ID, 난이도 수준, 캐릭터 또는 무기 클래스, 게임 모드, 부울 설정 등. Measurements에는 스칼라 숫자 메트릭을 나타내는 이벤트 필드가 포함됩니다. measurements의 예: 점수, 시간, 카운터, 위치 등. 예: 난이도 수준의 최고 매치 점수를 추적하는 게임 내 이벤트의 경우, 난이도 수준은 dimensions에 포함되어야 하고 점수는 measurements에 포함되어야 합니다. 이벤트의 이름과 dimensions 및 measurements의 이벤트 필드 이름은 타이틀의 서비스 구성에 선언된 이름과 일치해야 합니다. 이름은 대/소문자를 구분하지 않습니다. API가 서비스 구성의 이름과 일치하지 않는 이름으로 이벤트를 쓰는 경우, 서비스는 알림 없이 이벤트를 삭제합니다.
Measurements는 숫자 값만 가질 수 있는 반면, Dimensions는 더 다양한 유형을 가질 수 있습니다. 선호하는 경우 이벤트 쓰기를 위해 dimensionsJson 필드만 사용할 수 있습니다.

​
요구 사항

헤더: XGameEvent.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

​
개념 문서

​
함께 보기

XGameEvent
마지막 수정일 2026년 8월 24일

관련 항목

XGameEventXblEventsWriteInGameEventPFEventsWriteEventsRequestPFEventsWriteEventsResponsePFEventsWriteEventsAsync