> ## 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.

# SetRumbleState

> SetRumbleState

# SetRumbleState

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

## 구문

```cpp theme={null}
void SetRumbleState(
    const GameInputRumbleParams* params
);
```

### 매개변수

*params*   \_In\_opt\_\
형식: [GameInputRumbleParams\*](/reference/input/gameinput/structs/gameinputrumbleparams)

각 진동 모터에 대한 원하는 강도를 포함하는 구조체입니다. 진동 모터 강도의 범위는 0.0에서 1.0까지입니다.

### 반환값

형식: void

## 설명

`SetRumbleState` 메서드는 장치의 네 개의 진동 모터에 대한 원하는 강도를 설정합니다. 다른 유형의 피드백과 마찬가지로, 이는 애플리케이션에 의해 언제든지 호출할 수 있지만, 애플리케이션이 포커스를 갖고 있는 동안에만 장치에 적용됩니다.

가능한 한 간단하게 유지하기 위해, 애플리케이션은 장치가 어떤 진동 모터를 지원하는지 확인할 필요가 없으며, 네 개의 모터 모두에 대한 강도를 지정할 수 있습니다. 장치에 네 개의 모터 중 일부가 없는 경우, GameInput 구현은 다른 모터에 추가 강도를 추가하여 적응하려고 시도하므로 사용자에게 일정량의 피드백이 여전히 느껴집니다. 예를 들어, 2모터 게임패드에서는 고주파 진동 모터에 소량의 추가 진동 강도를 더해 트리거 진동 값을 에뮬레이션합니다.

연결이 끊긴 장치나 진동 모터가 없는 장치에서 `SetRumbleState` 메서드를 호출해도 아무 효과가 없습니다. 모터 강도 값의 범위는 \[0.0, 1.0]입니다. 이 범위를 벗어나는 값은 가장 가까운 유효 값으로 클램프됩니다.

## 요구 사항

**헤더:** GameInput.h

[GameInput 개요](/build/core-features/common/input/overviews/input-overview)\
[GameInputRumbleParams](/reference/input/gameinput/structs/gameinputrumbleparams)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 버전 기록

| 버전     | 변경 사항 |
| ------ | ----- |
| **v0** | 도입됨.  |


## Related topics

- [IGameInput::GetCurrentTimestamp](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrenttimestamp.md)
- [XInput에서 GameInput으로 포팅](/ko/build/core-features/common/input/porting/input-porting-xinput.md)
- [GameInputRumbleMotors](/ko/reference/input/gameinput/enums/gameinputrumblemotors.md)
- [SetPipelineState](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setpipelinestate_public.md)
- [XInputSetState](/ko/reference/input/xinputongameinput/functions/xinputsetstate.md)