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

Définit les intensités souhaitées des quatre moteurs de vibration de l'appareil.

## Syntaxe

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

### Paramètres

*params*   \_In\_opt\_\
Type : [GameInputRumbleParams\*](/fr-CA/reference/input/gameinput/structs/gameinputrumbleparams)

Structure contenant les intensités souhaitées pour chaque moteur de vibration. L'intensité d'un moteur de vibration varie de 0,0 à 1,0.

### Valeur de retour

Type : void

## Remarques

La méthode `SetRumbleState` définit les intensités souhaitées des quatre moteurs de vibration de l'appareil. Comme pour les autres types de rétroaction, une application peut l'appeler à tout moment, mais elle ne sera appliquée à l'appareil que lorsque l'application a le focus.

Pour garder les choses aussi simples que possible, les applications ne sont pas tenues de vérifier quels moteurs de vibration un appareil prend en charge et peuvent spécifier une intensité pour les quatre moteurs. Si l'appareil ne dispose pas de l'un des quatre moteurs, l'implémentation de GameInput tentera de s'adapter en ajoutant de l'intensité supplémentaire aux autres moteurs, de sorte que l'utilisateur ressente tout de même une certaine rétroaction. Par exemple, les valeurs de vibration des gâchettes sont émulées sur les manettes à deux moteurs en ajoutant une petite quantité d'intensité de vibration supplémentaire au moteur de vibration haute fréquence.

Sur les appareils déconnectés, ou sur les appareils sans moteur de vibration, l'appel de la méthode `SetRumbleState` n'a aucun effet. Les valeurs d'intensité des moteurs se situent dans la plage \[0.0, 1.0]. Toute valeur fournie hors de cette plage est ramenée à la valeur valide la plus proche.

## Configuration requise

**En-tête :** GameInput.h

[Vue d'ensemble de GameInput](/fr-CA/build/core-features/common/input/overviews/input-overview)\
[GameInputRumbleParams](/fr-CA/reference/input/gameinput/structs/gameinputrumbleparams)\
[IGameInputDevice](/fr-CA/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Historique des versions

| Version | Modifications |
| - | - |
| **v0** | Introduit. |


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