> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameEventWrite

> XGameEventWrite

# XGameEventWrite

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

## 구문

```cpp theme={null}
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 형식의 dimensions 데이터 필드입니다.

*measurementsJson*   \_In\_opt\_z\_\
형식: char\*

JSON 형식의 measurement 데이터 필드입니다.

### 반환 값

형식: HRESULT

성공하면 S\_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

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

<Note>Measurements는 숫자 값만 가질 수 있는 반면, Dimensions는 더 다양한 유형을 가질 수 있습니다. 선호하는 경우 이벤트 쓰기를 위해 *dimensionsJson* 필드만 사용할 수 있습니다.</Note>

## 요구 사항

**헤더:** XGameEvent.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[XGameEvent](/reference/system/xgameevent/xgameevent_members)


## Related topics

- [XGameEvent](/ko/reference/system/xgameevent/xgameevent_members.md)
- [XblEventsWriteInGameEvent](/ko/reference/live/xsapi-c/events_c/functions/xbleventswriteingameevent.md)
- [PFEventsWriteEventsRequest](/ko/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsrequest.md)
- [PFEventsWriteEventsResponse](/ko/services/playfab/api-references/c/pfeventstypes/structs/pfeventswriteeventsresponse.md)
- [PFEventsWriteEventsAsync](/ko/services/playfab/api-references/c/pfevents/functions/pfeventswriteeventsasync.md)