Skip to main content

SetRumbleState

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

Sintaxe

Parâmetros

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

Histórico de versões

Last modified on October 6, 2026