XblEventsWriteInGameEvent
“dimensions” 및 “measurement” 데이터 필드를 포함하는 인게임 이벤트를 씁니다.구문
매개 변수
xboxLiveContext _In_형식: XblContextHandle XBOX Live 컨텍스트 핸들입니다. eventName _In_z_
형식: char* 이벤트 이름입니다. 영숫자 문자만 포함해야 합니다. dimensionsJson _In_opt_z_
형식: char* Dimensions 데이터 필드입니다. measurementsJson _In_opt_z_
형식: char* Measurement 데이터 필드입니다.
반환값
형식: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.설명
Dimensions에는 정의된 숫자 또는 문자열 값이 유한한 수의 이벤트 필드가 포함됩니다. Dimensions의 예: 맵 ID, 난이도 수준, 캐릭터 또는 무기 클래스, 게임 모드, 부울 설정 등. Measurements에는 스칼라 숫자 메트릭을 나타내는 이벤트 필드가 포함됩니다. Measurements의 예: 점수, 시간, 카운터, 위치 등. 예: 특정 난이도 수준에 대한 가장 높은 매치 점수를 추적하는 인게임 이벤트의 경우: 난이도 수준은 dimensions에 포함되어야 하며 점수는 measurements에 포함되어야 합니다. 이벤트의 이름과 이벤트 필드의 이름(dimensions 및 measurements 모두)은 타이틀의 서비스 구성에 선언된 이름과 일치해야 합니다. 이름은 대/소문자를 구분하지 않습니다. API가 서비스 구성의 이름과 일치하지 않는 이름의 이벤트를 쓰는 경우 서비스는 알림 없이 이벤트를 삭제합니다. GDK PC 버전을 사용할 때, XGameEvent 기능이 포함된 GRTS 런타임이 설치되어 있어야 하며, 그렇지 않으면 이 함수는 E_NOTIMPL을 반환합니다.Measurements는 숫자 값만 가질 수 있지만 Dimensions는 더 다양한 형식을 가질 수 있습니다. 원하는 경우 dimensionsJson 필드만 사용하여 이벤트를 쓸 수 있습니다.