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

Define as intensidades desejadas dos quatro motores de vibração do dispositivo.

## Sintaxe

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

### Parâmetros

*params*   \_In\_opt\_\
Tipo: [GameInputRumbleParams\*](/pt-BR/reference/input/gameinput/structs/gameinputrumbleparams)

Estrutura que contém as intensidades desejadas para cada motor de vibração. A intensidade do motor de vibração varia de 0.0 a 1.0.

### Valor retornado

Tipo: void

## Comentários

O método `SetRumbleState` define as intensidades desejadas dos quatro motores de vibração do dispositivo. Assim como outros tipos de feedback, ele pode ser chamado por um aplicativo a qualquer momento, mas só será aplicado ao dispositivo enquanto o aplicativo estiver em foco.

Para manter tudo o mais simples possível, os aplicativos não precisam verificar a quais motores de vibração um dispositivo dá suporte e podem especificar uma intensidade para os quatro motores. Se o dispositivo não tiver algum dos quatro motores, a implementação do GameInput tentará se adaptar adicionando intensidade extra ao(s) outro(s) motor(es), para que alguma quantidade de feedback ainda seja sentida pelo usuário. Por exemplo, os valores de vibração dos gatilhos são emulados em gamepads de 2 motores adicionando uma pequena quantidade de intensidade de vibração extra ao motor de vibração de alta frequência.

Em dispositivos que foram desconectados, ou em dispositivos sem motores de vibração, chamar o método `SetRumbleState` não tem efeito. Os valores de intensidade do motor estão no intervalo \[0.0, 1.0]. Quaisquer valores fornecidos fora desse intervalo são limitados ao valor válido mais próximo.

## Requisitos

**Cabeçalho:** GameInput.h

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[GameInputRumbleParams](/pt-BR/reference/input/gameinput/structs/gameinputrumbleparams)\
[IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v0** | Introduzido. |


## Related topics

- [SetRumbleState](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_setrumblestate.md)
- [GameInputRumbleParams](/reference/input/gameinput/structs/gameinputrumbleparams.md)
- [Porting from XInput to GameInput](/build/core-features/common/input/porting/input-porting-xinput.md)
- [IGameInput::GetCurrentTimestamp](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getcurrenttimestamp.md)