Skip to main content

SetRumbleState

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

Syntaxe

Paramètres

params   _In_opt_
Type : 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
GameInputRumbleParams
IGameInputDevice

Historique des versions

Last modified on October 6, 2026