Skip to main content

XGameStreamingGetGamepadPhysicality

특정 게임패드 판독값에서 입력 물리성(physicality) 매핑을 가져옵니다.

구문

매개 변수

gamepadReading   _In_
형식: IGameInputReading*
쿼리 대상 게임패드 판독값입니다. gamepadPhysicality   _Out_
형식: XGameStreamingGamepadPhysicality*
입력 판독값의 물리성입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 잠재적 오류

설명

게임은 물리적으로 연결된 컨트롤러에서 입력이 왔는지, 아니면 가상 컨트롤러 입력으로 변환된 터치 레이아웃에서 왔는지에 따라 컨트롤러 입력을 구분해야 할 수 있습니다. 예제 시나리오 게임에서 점프 동작이 A 버튼에 연결되어 있습니다. 이 게임은 가상 컨트롤러의 A 버튼 누름으로 구성된 점프 아이콘이 포함된 터치 레이아웃을 제공합니다. 또한 이 게임은 플레이어가 물리적 컨트롤러를 다시 매핑하여 A가 더 이상 점프와 연결되지 않도록 할 수 있는 기능도 제공합니다. 게임은 요소와 상호 작용하기 위한 시각적 힌트를 표시할 수 있습니다(예: 점프하려면 A를 누르세요). 플레이어가 터치 레이아웃을 사용하는 경우, 시각적 힌트에는 해당 터치 레이아웃 버튼의 아이콘이 표시되어야 합니다.

예제

다음 코드 예제에서 게임은 기본적으로 컨트롤러의 A 버튼에 점프 동작을 연결해 두었습니다. 이 설정은 플레이어가 사용자 지정할 수 있지만, 화면의 터치 레이아웃은 고정되어 있으므로 터치 레이아웃의 A 버튼 누름은 항상 점프로 처리되어야 하며, 물리적 컨트롤러의 A는 플레이어가 컨트롤러 매핑을 사용자 지정한 대로 처리되어야 합니다.

요구 사항

헤더: xgamestreaming.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XGameStreaming
XGameStreamingGamepadPhysicality
XGameStreaming 터치 적응
마지막 수정일 2026년 8월 24일