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

# XGameStreaming (API 콘텐츠)

> XGameStreaming

# XGameStreaming

## 초기화

게임 스트리밍 기능을 초기화하는 데 필요한 API입니다.

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingInitialize](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) | Game Streaming API를 초기화합니다. |
| [XGameStreamingUninitialize](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminguninitialize.md) | Game Streaming API를 초기화 해제합니다. |

## 클라이언트 속성

스트리밍 장치 또는 해당 게임 스트림의 속성을 가져오는 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingClientPropertiesChangedCallback](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingclientpropertieschangedcallback.md) | 스트리밍 장치의 속성이 변경되었을 때의 알림입니다. |
| [XGameStreamingGetClientIPAddress](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress.md) | **사용되지 않음.** 스트리밍 클라이언트의 IP 주소를 가져옵니다. 대신 XSTS 토큰 클레임을 사용하세요. |
| [XGameStreamingGetDisplayDetails](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) | 스트리밍 클라이언트의 디스플레이 세부 정보를 가져옵니다. |
| [XGameStreamingGetSessionId](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetsessionid.md) | 스트리밍 클라이언트의 세션 ID를 가져옵니다. |
| [XGameStreamingGetStreamPhysicalDimensions](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetstreamphysicaldimensions.md) | 스트리밍 클라이언트에서 현재 렌더링되고 있는 비디오 스트림의 물리적 크기를 가져옵니다. |
| [XGameStreamingGetTouchBundleVersion](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion.md) | 지정한 장치에서 현재 사용 중인 터치 적응 번들의 버전을 가져옵니다. |
| [XGameStreamingGetTouchBundleVersionNameSize](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversionnamesize.md) | 지정한 장치의 터치 적응 번들에 지정된 버전 이름의 크기를 가져옵니다. |
| [XGameStreamingIsTouchInputEnabled](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled.md) | 클라이언트가 게임에 터치 입력을 전송할지 여부를 확인합니다. |
| [XGameStreamingRegisterClientPropertiesChanged](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged.md) | 스트리밍 클라이언트 장치의 속성이 변경될 때 호출될 콜백을 등록합니다. |
| [XGameStreamingUnregisterClientPropertiesChanged](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingunregisterclientpropertieschanged.md) | 이전에 등록된 XGameStreamingClientPropertiesChangedCallback의 등록을 해제합니다. |

### 열거형

| 열거형 | 설명 |
| :- | :- |
| [XGameStreamingClientProperty](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md) | 클라이언트 스트리밍 장치에 대해 쿼리할 수 있는 속성입니다. |
| [XGameStreamingVideoFlags](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreamingvideoflags.md) | 클라이언트 스트리밍 장치가 지원할 수 있는 비디오 기능입니다. |

### 구조체

| 구조체 | 설명 |
| :- | :- |
| [XGameStreamingDisplayDetails](https://docs.xbox.com/ko/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails.md) | 스트리밍 클라이언트 장치의 디스플레이에 대한 세부 정보입니다. |

## 연결 상태

스트리밍 클라이언트 장치의 연결 상태를 관리하는 데 필요한 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingConnectionStateChangedCallback](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingconnectionstatechangedcallback.md) | 연결된 스트리밍 클라이언트의 상태가 변경될 때마다 호출되는 콜백 함수입니다. |
| [XGameStreamingGetClientCount](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md) | 현재 연결된 스트리밍 장치의 수입니다. |
| [XGameStreamingGetClients](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md) | 현재 연결된 각 클라이언트의 식별자를 가져옵니다. |
| [XGameStreamingGetConnectionState](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md) | 지정한 장치의 현재 연결 상태를 가져옵니다. |
| [XGameStreamingIsStreaming](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md) | 게임이 현재 스트리밍되고 있는지 여부를 확인합니다. |
| [XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md) | 스트리밍 클라이언트 장치의 연결 상태가 변경될 때 호출될 콜백을 등록합니다. |
| [XGameStreamingUnregisterConnectionStateChanged](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingunregisterconnectionstatechanged.md) | 이전에 등록된 XGameStreamingConnectionStateChangedCallback의 등록을 해제합니다. |

### 열거형

| 열거형 | 설명 |
| :- | :- |
| [XGameStreamingConnectionState](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate.md) | 스트리밍 클라이언트 장치의 연결 상태입니다. |

## 지연 시간

스트리밍 지연 시간에 맞게 게임 플레이를 조정하는 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingGetStreamAddedLatency](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency.md) | 최근 평균 스트리밍 관련 지연 시간을 가져옵니다. |
| [XGameStreamingGetLastFrameDisplayed](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed.md) | **사용되지 않음.** 스트리밍 클라이언트의 화면에 가장 최근에 표시된 프레임의 프레임 파이프라인 토큰을 가져옵니다. |
| [XGameStreamingGetAssociatedFrame](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md) | **사용되지 않음.** 특정 입력 판독값에서 프레임 파이프라인 토큰을 가져옵니다. |

## 서버 위치

게임이 스트리밍되고 있는 위치에 액세스하는 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingGetServerLocationName](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationname.md) | 스트리밍 서버의 데이터 센터 위치를 가져옵니다. |
| [XGameStreamingGetServerLocationNameSize](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize.md) | 스트리밍 서버의 데이터 센터 위치 이름의 크기를 가져옵니다. |

## 터치 적응

해당 스트리밍 클라이언트에 노출될 터치 컨트롤러 레이아웃을 관리하는 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingGetGamepadPhysicality](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality.md) | 특정 게임패드 판독값에서 입력 물리성 매핑을 가져옵니다. |
| [XGameStreamingHideTouchControls](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols.md) | 연결된 모든 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. |
| [XGameStreamingHideTouchControlsOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient.md) | 지정한 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. |
| [XGameStreamingShowTouchControlLayout](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md) | 연결된 모든 스트리밍 클라이언트 장치에서 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| [XGameStreamingShowTouchControlLayoutOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md) | 연결된 지정한 스트리밍 클라이언트 장치에 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| [XGameStreamingShowTouchControlsWithStateUpdate](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate.md) | 연결된 모든 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| [XGameStreamingShowTouchControlsWithStateUpdateOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdateonclient.md) | 지정한 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. |
| [XGameStreamingUpdateTouchControlsState](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstate.md) | 연결된 모든 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. |
| [XGameStreamingUpdateTouchControlsStateOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstateonclient.md) | 지정한 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. |

### 열거형

| 열거형 | 설명 |
| :- | :- |
| [XGameStreamingGamepadPhysicality](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality.md) | 표준 XBOX 무선 컨트롤러의 모든 버튼, 스틱 및 트리거에 대한 물리성 매핑입니다. 주어진 버튼/스틱/트리거에 대해 물리성은 알 수 없음, 물리적, 가상 또는 둘 다일 수 있습니다. |
| [XGameStreamingTouchControlsStateOperationKind](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstateoperationkind.md) | 터치 컨트롤 레이아웃 상태를 업데이트할 때 수행할 수 있는 작업입니다. |
| [XGameStreamingTouchControlsStateValueKind](https://docs.xbox.com/ko/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstatevaluekind.md) | 터치 레이아웃과 연결된 상태의 형식을 지정합니다. |

### 구조체

| 구조체 | 설명 |
| :- | :- |
| [XGameStreamingTouchControlsStateOperation](https://docs.xbox.com/ko/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstateoperation.md) | 작업, 특정 변수의 경로, 적용될 값을 지정합니다. |
| [XGameStreamingTouchControlsStateValue](https://docs.xbox.com/ko/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstatevalue.md) | 터치 컨트롤 상태의 특정 요소에 대한 형식과 값을 제공합니다. |

## 해상도

스트림의 해상도를 관리하는 API입니다.

### 함수

| 함수 | 설명 |
| :- | :- |
| [XGameStreamingSetResolution](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingsetresolution.md) | 비디오 스트림의 해상도를 설정합니다. |

## 오류 코드

XGameStreaming API에서 다음 오류 코드가 반환될 수 있습니다. 전체 목록은 [오류 코드](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하세요.

| 코드 | 값 | 설명 |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 런타임이 초기화되지 않았습니다. 다른 API를 호출하기 전에 [XGameStreamingInitialize](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md)를 호출하세요. |
| E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | 지정한 클라이언트가 연결되어 있지 않습니다. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | 요청한 데이터를 사용할 수 없습니다. 데이터는 나중에 사용할 수 있게 될 수 있습니다. |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | 현재 컴퓨터가 데이터 센터에서 실행되고 있지 않습니다. |
| E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | 현재 판독값이 스트리밍 컨트롤러에서 온 것이 아닙니다. |

## 개념 문서

* [클라우드 인식 API 호출](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-am-i-streaming.md)
* [터치 시작하기](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md)
* [게임 스트리밍 지연 보정 심층 분석](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive.md)
* [게임 스트리밍 지연 보정 개요](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview.md)
* [게임 스트리밍 지연 시간 측정](https://docs.xbox.com/ko/build/core-features/common/game-streaming/game-streaming-latency-measurement.md)

## 함께 보기

[시스템 API 참조](https://docs.xbox.com/ko/reference/system/gc-reference-system-toc.md)


## Related topics

- [XGame (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgame/xgame_members.md)
- [XGameUI (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgameui/xgameui_members.md)
- [XGameSave (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgamesave/xgamesave_members.md)
- [XGameActivation (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameEvent (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgameevent/xgameevent_members.md)