> ## 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. # XGameStreaming > XGameStreaming # XGameStreaming ## 초기화 게임 스트리밍 기능을 초기화하는 데 필요한 API입니다. | 함수 | 설명 | | :-------------------------------------------------------------------------------------------------- | :----------------------------- | | [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) | Game Streaming API를 초기화합니다. | | [XGameStreamingUninitialize](/reference/system/xgamestreaming/functions/xgamestreaminguninitialize) | Game Streaming API를 초기화 해제합니다. | ## 클라이언트 속성 스트리밍 장치 또는 해당 게임 스트림의 속성을 가져오는 API입니다. ### 함수 | 함수 | 설명 | | :-------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- | | [XGameStreamingClientPropertiesChangedCallback](/reference/system/xgamestreaming/functions/xgamestreamingclientpropertieschangedcallback) | 스트리밍 장치의 속성이 변경되었을 때의 알림입니다. | | [XGameStreamingGetClientIPAddress](/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress) | **사용되지 않음.** 스트리밍 클라이언트의 IP 주소를 가져옵니다. 대신 XSTS 토큰 클레임을 사용하세요. | | [XGameStreamingGetDisplayDetails](/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) | 스트리밍 클라이언트의 디스플레이 세부 정보를 가져옵니다. | | [XGameStreamingGetSessionId](/reference/system/xgamestreaming/functions/xgamestreaminggetsessionid) | 스트리밍 클라이언트의 세션 ID를 가져옵니다. | | [XGameStreamingGetStreamPhysicalDimensions](/reference/system/xgamestreaming/functions/xgamestreaminggetstreamphysicaldimensions) | 스트리밍 클라이언트에서 현재 렌더링되고 있는 비디오 스트림의 물리적 크기를 가져옵니다. | | [XGameStreamingGetTouchBundleVersion](/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion) | 지정한 장치에서 현재 사용되고 있는 터치 적응 번들의 버전을 가져옵니다. | | [XGameStreamingGetTouchBundleVersionNameSize](/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversionnamesize) | 지정한 장치의 터치 적응 번들에 지정된 버전 이름의 크기를 가져옵니다. | | [XGameStreamingIsTouchInputEnabled](/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled) | 클라이언트가 게임에 터치 입력을 전송할지 여부를 확인합니다. | | [XGameStreamingRegisterClientPropertiesChanged](/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged) | 스트리밍 클라이언트 장치의 속성이 변경될 때 호출될 콜백을 등록합니다. | | [XGameStreamingUnregisterClientPropertiesChanged](/reference/system/xgamestreaming/functions/xgamestreamingunregisterclientpropertieschanged) | 이전에 등록된 XGameStreamingClientPropertiesChangedCallback의 등록을 해제합니다. | ### 열거형 | 열거형 | 설명 | | :-------------------------------------------------------------------------------------------------- | :--------------------------------- | | [XGameStreamingClientProperty](/reference/system/xgamestreaming/enums/xgamestreamingclientproperty) | 클라이언트 스트리밍 장치에 대해 쿼리할 수 있는 속성입니다. | | [XGameStreamingVideoFlags](/reference/system/xgamestreaming/enums/xgamestreamingvideoflags) | 클라이언트 스트리밍 장치가 지원할 수 있는 비디오 기능입니다. | ### 구조체 | 구조체 | 설명 | | :---------------------------------------------------------------------------------------------------- | :--------------------------------- | | [XGameStreamingDisplayDetails](/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails) | 스트리밍 클라이언트 장치의 디스플레이에 대한 세부 정보입니다. | ## 연결 상태 스트리밍 클라이언트 장치의 연결 상태를 관리하는 데 필요한 API입니다. ### 함수 | 함수 | 설명 | | :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------- | | [XGameStreamingConnectionStateChangedCallback](/reference/system/xgamestreaming/functions/xgamestreamingconnectionstatechangedcallback) | 연결된 스트리밍 클라이언트의 상태가 변경될 때마다 호출되는 콜백 함수입니다. | | [XGameStreamingGetClientCount](/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount) | 현재 연결된 스트리밍 장치의 수입니다. | | [XGameStreamingGetClients](/reference/system/xgamestreaming/functions/xgamestreaminggetclients) | 현재 연결된 각 클라이언트의 식별자를 가져옵니다. | | [XGameStreamingGetConnectionState](/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate) | 지정한 장치의 현재 연결 상태를 가져옵니다. | | [XGameStreamingIsStreaming](/reference/system/xgamestreaming/functions/xgamestreamingisstreaming) | 게임이 현재 스트리밍되고 있는지 여부를 확인합니다. | | [XGameStreamingRegisterConnectionStateChanged](/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged) | 스트리밍 클라이언트 장치의 연결 상태가 변경될 때 호출될 콜백을 등록합니다. | | [XGameStreamingUnregisterConnectionStateChanged](/reference/system/xgamestreaming/functions/xgamestreamingunregisterconnectionstatechanged) | 이전에 등록된 XGameStreamingConnectionStateChangedCallback의 등록을 해제합니다. | ### 열거형 | 열거형 | 설명 | | :---------------------------------------------------------------------------------------------------- | :----------------------- | | [XGameStreamingConnectionState](/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate) | 스트리밍 클라이언트 장치의 연결 상태입니다. | ## 지연 시간 스트리밍 지연 시간에 맞게 게임 플레이를 조정하는 API입니다. ### 함수 | 함수 | 설명 | | :-------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- | | [XGameStreamingGetStreamAddedLatency](/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency) | 최근 평균 스트리밍 관련 지연 시간을 가져옵니다. | | [XGameStreamingGetLastFrameDisplayed](/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed) | **사용되지 않음.** 스트리밍 클라이언트의 화면에 가장 최근에 표시된 프레임의 프레임 파이프라인 토큰을 가져옵니다. | | [XGameStreamingGetAssociatedFrame](/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) | **사용되지 않음.** 특정 입력 판독값에서 프레임 파이프라인 토큰을 가져옵니다. | ## 서버 위치 게임이 스트리밍되고 있는 위치에 액세스하는 API입니다. ### 함수 | 함수 | 설명 | | :---------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- | | [XGameStreamingGetServerLocationName](/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationname) | 스트리밍 서버의 데이터 센터 위치를 가져옵니다. | | [XGameStreamingGetServerLocationNameSize](/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize) | 스트리밍 서버의 데이터 센터 위치 이름의 크기를 가져옵니다. | ## 터치 적응 해당 스트리밍 클라이언트에 노출될 터치 컨트롤러 레이아웃을 관리하는 API입니다. ### 함수 | 함수 | 설명 | | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------- | | [XGameStreamingGetGamepadPhysicality](/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality) | 특정 게임패드 판독값에서 입력 물리성 매핑을 가져옵니다. | | [XGameStreamingHideTouchControls](/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols) | 연결된 모든 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. | | [XGameStreamingHideTouchControlsOnClient](/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient) | 지정한 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다. | | [XGameStreamingShowTouchControlLayout](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout) | 연결된 모든 스트리밍 클라이언트 장치에서 지정한 터치 레이아웃을 표시하도록 요청합니다. | | [XGameStreamingShowTouchControlLayoutOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient) | 연결된 지정한 스트리밍 클라이언트 장치에 지정한 터치 레이아웃을 표시하도록 요청합니다. | | [XGameStreamingShowTouchControlsWithStateUpdate](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate) | 연결된 모든 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. | | [XGameStreamingShowTouchControlsWithStateUpdateOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdateonclient) | 지정한 스트리밍 클라이언트 장치가 터치 컨트롤 상태를 업데이트한 후 지정한 터치 레이아웃을 표시하도록 요청합니다. | | [XGameStreamingUpdateTouchControlsState](/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstate) | 연결된 모든 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. | | [XGameStreamingUpdateTouchControlsStateOnClient](/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstateonclient) | 지정한 스트리밍 클라이언트 장치의 터치 컨트롤 상태를 업데이트합니다. | ### 열거형 | 열거형 | 설명 | | :------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------- | | [XGameStreamingGamepadPhysicality](/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality) | 표준 XBOX 무선 컨트롤러의 모든 버튼, 스틱 및 트리거에 대한 물리성 매핑입니다. 주어진 버튼/스틱/트리거에 대해 물리성은 알 수 없음, 물리적, 가상 또는 둘 다일 수 있습니다. | | [XGameStreamingTouchControlsStateOperationKind](/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstateoperationkind) | 터치 컨트롤 레이아웃 상태를 업데이트할 때 수행할 수 있는 작업입니다. | | [XGameStreamingTouchControlsStateValueKind](/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstatevaluekind) | 터치 레이아웃과 연결된 상태의 형식을 지정합니다. | ### 구조체 | 구조체 | 설명 | | :------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------- | | [XGameStreamingTouchControlsStateOperation](/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstateoperation) | 작업, 특정 변수의 경로, 적용될 값을 지정합니다. | | [XGameStreamingTouchControlsStateValue](/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstatevalue) | 터치 컨트롤 상태의 특정 요소에 대한 형식과 값을 제공합니다. | ## 해상도 스트림의 해상도를 관리하는 API입니다. ### 함수 | 함수 | 설명 | | :---------------------------------------------------------------------------------------------------- | :------------------- | | [XGameStreamingSetResolution](/reference/system/xgamestreaming/functions/xgamestreamingsetresolution) | 비디오 스트림의 해상도를 설정합니다. | ## 오류 코드 XGameStreaming API에서 다음 오류 코드가 반환될 수 있습니다. 전체 목록은 [오류 코드](/reference/errorcodes)를 참조하세요. | 코드 | 값 | 설명 | | -------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 런타임이 초기화되지 않았습니다. 다른 API를 호출하기 전에 [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize)를 호출하세요. | | E\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | 지정한 클라이언트가 연결되어 있지 않습니다. | | E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | 요청한 데이터를 사용할 수 없습니다. 데이터는 나중에 사용할 수 있게 될 수 있습니다. | | E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | 현재 컴퓨터가 데이터 센터에서 실행되고 있지 않습니다. | | E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | 현재 판독값이 스트리밍 컨트롤러에서 온 것이 아닙니다. | ## 개념 문서 * [클라우드 인식 API 호출](/build/core-features/common/game-streaming/game-streaming-am-i-streaming) * [터치 시작하기](/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch) * [게임 스트리밍 지연 보정 심층 분석](/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive) * [게임 스트리밍 지연 보정 개요](/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview) * [게임 스트리밍 지연 시간 측정](/build/core-features/common/game-streaming/game-streaming-latency-measurement) ## 함께 보기 [시스템 API 참조](/reference/system/gc-reference-system-toc) ## Related topics - [XGameStreamingIsStreaming](/ko/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md) - [XGameStreamingInitialize](/ko/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) - [XGameStreamingUninitialize](/ko/reference/system/xgamestreaming/functions/xgamestreaminguninitialize.md) - [XGameStreamingGetClients](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md) - [XGameStreamingClientProperty](/ko/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md)