Skip to main content

SetRumbleState

デバイス上の 4 つの振動モーターの目的の強度を設定します。

構文

パラメーター

params   _In_opt_
型: GameInputRumbleParams*
各振動モーターの目的の強度を格納する構造体です。振動モーターの強度は 0.0 から 1.0 の範囲です。

戻り値

型: void

解説

SetRumbleState メソッドは、デバイス上の 4 つの振動モーターの目的の強度を設定します。他の種類のフィードバックと同様に、アプリケーションはいつでもこれを呼び出せますが、アプリケーションがフォーカスされている間のみデバイスに適用されます。 できるだけシンプルに保つため、アプリケーションはデバイスがどの振動モーターをサポートしているかを確認する必要はなく、4 つすべてのモーターの強度を指定してもかまいません。デバイスに 4 つのモーターのいずれかがない場合、GameInput の実装は、ユーザーが依然として何らかのフィードバックを感じられるように、他のモーターに強度を上乗せして適応を試みます。たとえば、トリガー バイブレーション値は、高周波バイブレーション モーターに少量のバイブレーション強度を追加することで、2 モーターのゲームパッド上でエミュレートされます。 切断されたデバイス、または振動モーターのないデバイスで SetRumbleState メソッドを呼び出しても効果はありません。モーター強度の値は [0.0, 1.0] の範囲です。この範囲外の値が指定された場合は、最も近い有効な値にクランプされます。

要件

ヘッダー: GameInput.h GameInput の概要
GameInputRumbleParams
IGameInputDevice

バージョン履歴

最終更新日 2026年8月13日