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