다음을 통해 공유


SetRumbleState

장치에서 4개의 진동 모터에 대해 원하는 강도를 설정합니다.

구문

void SetRumbleState(  
         const GameInputRumbleParams* params  
)  

매개 변수

params _In_opt_
형식: GameInputRumbleParams*

각 진동 모터에 필요한 강도가 제공되는 구조체입니다. 진동 모터 강도 범위는 0.0~1.0입니다.

반환 값

형식: void

설명

SetRumbleState 메서드에서 4개의 진동 모터에 원하는 강도를 설정합니다. 다른 유형의 피드백과 같이, 언제든지 응용 프로그램이 이를 호출할 수 있지만, 응용 프로그램이 포커스를 받은 상태에서만 장치에 적용됩니다.

최대한 간단하게 하기 위해, 응용 프로그램은 장치가 지원하는 진동 모터를 확인할 필요가 없으며, 4개 모터 모두에 대한 강도를 지정할 수 있습니다. 장치에 4개 모터 중 하나라도 부족한 경우, GameInput 구현은 다른 모터에 강도를 추가하여 적응을 시도하므로, 사용자는 여전히 비슷한 정도의 피드백을 느낄 수 있습니다. 예를 들어 트리거 진동 값은 고주파 진동 모터에 소량의 진동 강도를 추가하여 2모터 게임 패드에서 에뮬레이트됩니다.

연결 해제된 장치 또는 진동 모터가 없는 장치에서는 SetRumbleState 메서드를 호출해도 효과가 없습니다. 모터 강도 값 범위는 [0.0, 1.0]입니다. 이 범위 외에 제공된 모든 값은 가장 가까운 유효 값으로 고정됩니다.

요구 사항

헤더: GameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

GameInput 개요
GameInputRumbleParams
IGameInputDevice